外呼拨打结果回调
服务描述
本接口,可根据一键外呼指定的回调地址,批量回调外呼拨打结果记录。
注意:该接口可能会多次回调,请以最后一次回调的结果为准
举例:一键外呼中传递的回调地址为:http://xxxx.com/callback。平台会在拨打完成后通过此接口将拨打结果回传业务系统。 post http://xxxx.com/callback body={"callbackResult": AudioCallbackResponse}
AudioCallbackResponse
参数 | 类型 | 说明 |
---|---|---|
audioRecordCode | String(32) | 外呼名单编码,长度32位或外部名单code |
sessionId | String(25) | 会话id |
callStartTime | long | 开始时间 |
callEndTime | long | 结束时间 |
callDurationSec | int | 通话时长,单位秒 |
customerName | String(20) | 姓名 |
cellphone | String(11) | 电话 |
callStatus | int | 拨打状态(1:未拨打 2:等待接听 3:接听中 4:等待重呼 5:未接听 6:拨打失败 7:已接听 8:限制拨打 9:占线 10:用户挂断 11:来的提醒 12:无法接通 13:空号 14:停机 15:关机 16:呼损 17:号码故障 18:线路故障) |
callTimes | int | 拨打次数 |
manualStatus | int | 是否转人工 1转人工 0 否 |
taskName | String(50) | 任务名称 |
taskCode | String(32) | 任务编码 |
aiTagName | String(64) | 意向标签 |
extendInfos | String(1000) | 扩展信息,json串 |
audioLinkUrl | String | 录音下载地址(该字段在近期会取消,请使用录音下载接口进行录音下载) |
customerTag | String | 客户标签 |
返回结果示body输出示例:
{
"callbackResult":[{
"audioRecordCode": "a492e8f048d00bcc723d62719e245546",
"sessionId": "2019121114454304605400439",
"callStartTime": 1576046717000,
"callEndTime": 1576046787000,
"callDurationSec": 43,
"customerName": "魏**",
"cellphone": "********903",
"callStatus": 7,
"callTimes": 1,
"manualStatus": 0,
"taskName": "ddd",
"taskCode": "a492e8f048d00bcc343d62719e245546",
"aiTagName": "无需求",
"extendInfos": {
},
"audioLinkUrl":"",
"customerTag":""
}]
}
FAQ:
作用:接口使用方需在【一键外呼】接口中按要求提供回调地址【callbackUrl】,回调结果通过【callbackResult】返回给接口调用方,但不保证回调一定成功。
回调说明:回调返回响应码200成功,否则默认重试3次。3次失败,不再发起回调,如果接口使用方未拿到回调结果,可通过【拨打详情】接口,主动获取结果。
回调时机:拨打失败、拨打成功后均会发起回调。
说明:
- 回调接口链接务必支持POST请求,调用方可通过【callbackResult】获取结果信息。
- 创建外呼任务时,header参数
encrypted
传值需要加密,则该回调结果会加密返回