呼叫中心文档
首页
通讯文档
通讯对接
更新历史
公共接口
API外呼签入
API电话签出
API电话外呼
通讯话单
双呼对接
通讯机器人
公共接口
机器人外呼
机器人话单
AXB回拨
签名说明
呼叫请求
话单回调
录音下载
盒子
文本机器人文档
公共数据结构体
API对话
对话初始连接
对话文本消息
对话表单消息
对话底部菜单
-
+
首页
机器人话单
### 1.接口描述 <span style="font-family:楷体">接口请求域名: www.zkiccs.com 此接口(api/v1/open/bot_call_log)用来发起查询机器人单条话单</span> ### 2.输入参数 <span style="font-family:楷体">以下请求参数列表仅列出了接口请求参数和部分公共参数</span> | 参数名称 | 必选 | 类型 | 描述 | | --- | --- | --- | --- | | call_id | 是 | String |话单call_id| | start_time | 是 | String | 发起呼叫时间(时间戳) | ### 3. 输出参数 | 参数名称 | 类型 | 描述 | | --- | --- | --- | | code | number | 状态编码 | | msg | string | 描述 | | data | object | | > data-结构体 | 参数名称 | 类型 | 描述 | | --- | --- | --- | | uuid | String | 话单call_id | | trick_id | Int | 话术ID | | relay_number | String | 中继号码 | | mobile | String | 号码 | | province | String | 省 | | city | String | 市 | | vars | object | 变量 | | tag | object | 标签 | | call_type | Int | 呼叫类型<br/><font color="red">0-呼出、1-呼入</font> | | start_time | Int | 呼叫时间 | | ring_time | Int | 振铃时间 | | answer_time | Int | 应答时间 | | hangup_time | Int | 挂机时间 | | hangup_cause | String | 挂机原因 | | hangup_type | Int | 挂断方<br/>0-系统、1-客户 | | talk_duration | Int | 通话时长 | | ring_duration | Int | 振铃时长 | | transfer_time | Int | 转接时间 | | transfer_type | String | 转接类型<br/>agent坐席queue技能组 | | transfer_value | String | 转接值 | | ring_file | String | 振铃文件 | | record_file | String | 录音文件 | | valid | Int | 有效通话 | | round_num | Int | 对话轮次 | | otk_id | Int | 外呼任务ID | | otn_id | Int | 外呼号码ID | | ctg_id | Int | 联系人名单ID | | rules | object | 意向标签规则 | | message | object | 对话文本 | > tag-结构体 | 参数名称 | 类型 | 描述 | | --- | --- | --- | | custom | String[] | 自定义意向标签 | | intent | string | 系统意向标签 | > rules-结构体 | 参数名称 | 类型 | 描述 | | --- | --- | --- | | invite | Int | 是否邀约 | | yes_num | Int | 客户触发肯定次数 | | talk_num | Int | 客户讲话次数 | | knowledge | Int | 命中业务问题 | | reject_num | Int | 客户拒绝次数 | | reject_last | boole | 客户最后是否拒绝 | > message-结构体 | 参数名称 | 类型 | 描述 | | --- | --- | --- | | role | Int | 角色<br/>0-机器人、1-客户 | | route | String | 对话路径 | | message | List | 对话结构体 | | time | Int | 时间 | > 第二层message-结构体 | 参数名称 | 类型 | 描述 | | --- | --- | --- | | type | String | text(文本类型), nav(按键导航),collection(收集消息),transfer(转接消息),hangup(挂机消息),wait(等待消息),request(客户消息)| | data | Object | 文本消息体 | > data-结构体 | 参数名称 | 类型 | 描述 | | --- | --- | --- | | text | String | 文本消息(text,nav,collection,transfer,request) | | sound | List | 音频信息 | | intent | boole | 音频信息 | | wait_sec | Int | 系统设置等待时长秒 | | silence_ms | Int | 系统设置静音停顿时长毫秒 | > sound-结构体 | 参数名称 | 类型 | 描述 | | --- | --- | --- | | file | String | 语音地址 | | text | String | 文本信息 | | type | String | 语音类型、tts/file | ### 4.示例 >i 输入示例 ``` GET /api/v1/open/bot_call_log?access_token={access_token}&call_id={call_id}&start_time={start_time} HTTP/1.1 Host: www.zkiccs.com Content-Type: application/json ``` >i 输出示例 ``` { "code": 200, "msg": "成功", "data": { "uuid": "d3c96317-6d1f-4901-b790-50d1f6e05d5e", "trick_id": 69, "relay_number": "021xxxxx", "mobile": "18xxxxxx", "province": "北京", "city": "北京", "vars": { "name":"姓名" }, "tag":{ "custom":[ "国内业务", "国外业务" ], "intent":"B" }, "call_type": 0, "start_time": 1699926581, "ring_time": 1699926583, "answer_time": 1699926586, "hangup_time": 1699926609, "hangup_cause": "", "hangup_type": 0, "talk_duration": 23, "ring_duration": 2, "transfer_time": null, "transfer_type": null, "transfer_value": null, "ring_file": "https://xxxxx/ring_021xxx_20231114094943_d3c96317-6d1f-4901-b790-50d1f6e05d5e.wav", "record_file": "https://xxxx/18xxxxx_20231114094946_d3c96317-6d1f-4901-b790-50d1f6e05d5e.wav", "valid": 1, "round_num": 2, "otk_id": xx, "otn_id": xxx, "ctg_id": xxx, "rules": { "invite": true, "yes_num": 0, "talk_num": 0, "knowledge": 0, "reject_num": 0, "reject_last": false }, "message": [ { "role": 0, "route": "对话流程-开场白-普通节点", "message": { "data": { "text": "小朋友的家长您好xxxxx", "break": true, "sound": [ { "file": "", "text": "小朋友的家长您好xxxx", "type": "tts" } ], "intent": true, "wait_sec": 10, "silence_ms": 10000 }, "type": "text" }, "time": 1699926587 }, { "role": 1, "route": "", "message": { "data": { "text": "" }, "type": "request", "debug": { "node": "普通节点", "title": "默认" } }, "time": 1699926587 }, { "role": 0, "route": "对话流程-开场白-跳转节点", "message": { "data": { "text": "好的,xxxxx,再见", "sound": [ { "file": "", "text": "好的,xxxxx,再见", "type": "tts" } ] }, "type": "text" }, "time": 1699926587 }, { "role": 0, "route": "", "message": { "data": [], "type": "hangup" }, "time": 1699926587 } ] } } ```
照坤
2024年8月27日 10:55
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
分享
链接
类型
密码
更新密码