呼叫状态回调接口
1. 呼叫状态回调接口
1.1. 请求地址
POST /{appid}/callback
1.2. 请求包体
属性 | 类型 | 约束 | 说明 | 举例 |
appid | string | 必选 | 为客户分配的应用id |
|
taskid | string | 必选 | 调用外呼接口返回的taskid |
|
callid | string | 必选 | 呼叫id |
|
caller | string | 必选 | 主叫 |
|
called | string | 必选 | 被叫 |
|
reason | int | 必选 | 呼叫状态 |
|
starttime | string | 可选 | 接听时间 | 2018-05-10 16:26:30 |
endtime | string | 可选 | 挂机时间 | 2018-05-10 16:26:30 |
duration | string | 可选 | 通话时长(单位:秒) |
|
direction | string | 可选 | 呼叫类型 0:外呼 1:呼入 |
|
text | array | 可选 | 对话文本 | JSON数组格式 |
recordurl | string | 可选 | 录音下载地址 | 如果没有录音,则返回为空 |
text字段说明:
属性 | 类型 | 约束 | 说明 | 举例 |
idx | int | 必选 | 对话序列 | 1 |
role | string | 必选 | 讲话角色 | user:用户,robot:机器人 |
msg | string | 必选 | 讲话内容 | 你好 |
1.3. JSON请求示例
- POST {callbackurl} HTTP/1.1
- Host: 192.168.0.1:8883
- Accept:application/json;
- Content-Type:application/json;charset=utf-8;
- Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmOAwN6MjAxMzAyMDExNTABCE=
- {"caller":"13800138000","endtime":"2018-08-10 09:45:36","text":[{"idx":1,"role":"robot","msg":"您好,请问您是张三吗"},{"idx":2,"role":"user","msg":"嗯"}],"starttime":"2018-08-10 09:45:03","reason":0,"recordurl":"https://ip:port/xxx/2018-06-21/16-16/01053270142_13800138000_20180823161604.wav","appid":"20150314000000110000000000000010","duration":33,"callid":"3E8-5B2B55D8-16ED-0","called":"01053270142"}
1.4. 响应包体
属性 | 类型 | 约束 | 说明 | 举例 |
statuscode | string | 必选 | 请求状态码,取值:000000(成功) | 000000 |
1.5. JSON响应示例
- HTTP/1.1 200 OK
- Content-Length: 641
- {"statuscode":"000000"}