销生客外呼接口说明
安全接入外呼能力，统一获取通话结果

1. 接入流程

1. 开通API权限

   联系销生客为企业开通API权限，获取企业编号 comcode 和接口密钥 appkey。

2. 配置外呼资源

   确认企业已配置可用线路、主叫号码授权、坐席/企业有效期和账户余额。

3. 生成签名

   按接口要求拼接参与签名的参数，用 md5(appkey + queryString) 生成 sign。

4. 调用外呼接口

   调用 /apicall/wancall 发起呼叫，接口返回本次业务话单号 callid。

5. 接收或查询话单

   通过 notifyurl 接收结果，或使用话单查询接口按 callid / 被叫号码查询。

2. 基础信息

3. 签名规则

销生客外呼接口 wancall 的签名参数固定为：comcode、caller、callee、notifyurl、timestamp。参数按键名字典序升序拼接为 URL query 字符串，再在前面拼接 appkey 后做 MD5。

参与签名参数：
callee=被叫号码
caller=主叫号码
comcode=企业编号
notifyurl=回调地址
timestamp=13位毫秒时间戳

queryString = callee=...&caller=...&comcode=...¬ifyurl=...×tamp=...
sign = md5(appkey + queryString)

// PHP示例
$params = [
  'comcode' => '209xxxxxx',
  'caller' => '13800000000',
  'callee' => '13900000000',
  'notifyurl' => 'https://your-domain.com/callback/xiaocall',
  'timestamp' => (string) round(microtime(true) * 1000),
];
ksort($params);
$query = http_build_query($params, '', '&', PHP_QUERY_RFC3986);
$sign = md5($appkey . urldecode($query));

4. 发起外呼：POST /apicall/wancall

curl -X POST '{接口服务地址}/apicall/wancall' \
  -d 'comcode=209xxxxxx' \
  -d 'caller=13800000000' \
  -d 'callee=13900000000' \
  -d 'notifyurl=https://your-domain.com/callback/xiaocall' \
  -d 'timestamp=1720000000000' \
  -d 'sign=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -d 'display=' \
  -d 'param=order_10001'

// 成功示例
{
  "code": 0,
  "text": "呼叫发起成功",
  "callid": "202607201234567890ABCDEF"
}

// 失败示例
{
  "code": 4001,
  "text": "签名不正确,请检查参数"
}

5. 话单查询

5.1 按 callid 查询话单：POST /apicall/getcalllog

用于查询指定月份内某个 callid 的结算话单。该接口签名参数为：callid、comcode、date、tophone。

{
  "code": 0,
  "text": "ok",
  "log": {
    "callid": "...",
    "fromstarttime": "主叫开始时间",
    "fromendtime": "主叫结束时间",
    "tophonestarttime": "被叫开始时间",
    "tophoneendtime": "被叫结束时间",
    "mduration": "主叫通话时长",
    "bduration": "被叫通话时长",
    "timeint": "创建时间戳",
    "sound": "录音地址"
  }
}

6. 线路状态：POST /apicall/getlinestatus

获取企业线路列表及状态。签名参数为：comcode、timestamp。

{
  "code": 0,
  "linelist": {
    "count": 2,
    "list": [
      {"macode":"023xxxxxxx","mastatus":"1","activestatus":"1","lastupdatetime":"..."}
    ]
  }
}

7. 回调说明

wancall 请求中的 notifyurl 会随话单写入系统，用于后续通话状态或话单结果通知。不同线路返回字段可能存在差异，建议回调接收方按“宽松解析”处理。

8. 常见错误码

9. 联调清单