-
Notifications
You must be signed in to change notification settings - Fork 6
Callbot API callCallback
Jcateye edited this page Dec 16, 2024
·
5 revisions
v1.0.0
Base URLs:
鉴权请查看文档https://github.com/nxtele/http-api-document/wiki/Callbot-API-authorization
POST /api/v3/callCallback
Body 请求参数
{
"callbackType": 1,
"orderID": "string",
"userPhone": "string",
"userName": "string",
"sceneID": "string",
"userTaskID": "string",
"taskID": "string",
"finish": true,
"other": "string",
"callInfoDetail": {
"callID": "string",
"callStatus": 1,
"callStartTs": 0,
"callAnswerTs": 0,
"callEndTs": 0,
"callDuration": 0,
"callAudioUrl": "string",
"hangupCause": "string",
"termSipCode": "string",
"intents": [
{
"intentID": "string",
"intentTag": "string",
"intentName": "string",
"intentLevel": 0
}
],
"sms": [
{
"smsSendTs": 0,
"sysMessageID": "string",
"smsContent": "string"
}
],
"agent": {
"agentName": "string",
"agentGroup": "string",
"agentCallStatus": 1,
"agentCallElapsed": 0,
"agentLabel": "string",
"manualCallStart": 0,
"manualCallAnswer": 0,
"manualCallEnd": 0,
"manualHangupBy": 0
},
"params": [
{
"name": "string",
"value": "string"
}
]
}
}
名称 | 位置 | 类型 | 必选 | 说明 |
---|---|---|---|---|
requestID | header | string | 是 | 请求唯一id |
uuid | header | string | 是 | uuid,由被调用方给出 |
createTs | header | string | 是 | 请求时间戳,(秒级) |
sign | header | string | 是 | 签名,使用的签名算法可在后台->开发者 查看 |
body | body | object | 否 | |
» callbackType | body | integer | 是 | 回调类型 |
» orderID | body | string | 是 | 订单id |
» userPhone | body | string | 是 | 手机号 |
» userName | body | string | 是 | 用户名 |
» sceneID | body | string | 是 | 话术模板id |
» userTaskID | body | string | 是 | 用户任务id |
» taskID | body | string | 是 | 任务id |
» finish | body | boolean | 是 | 订单完成 |
» other | body | string | 是 | 透传字段 |
» callInfoDetail | body | object | 是 | 通话详细信息 |
»» callID | body | string | 是 | 通话id |
»» callingNumber | body | string | 是 | 主叫号码 |
»» lineAddress | body | string | 是 | 线路IP |
»» callStatus | body | integer | 是 | 通话状态 |
»» callStartTs | body | integer | 是 | 通话拨打时间戳 |
»» callAnswerTs | body | integer | 是 | 通话接听时间戳,接听时间戳有值不代表通话被接听,请参照callStatus判断通话状态 |
»» callEndTs | body | integer | 是 | 通话挂断时间戳 |
»» callDuration | body | integer | 是 | 通话接听秒数 |
»» callAudioUrl | body | string | 是 | 通话录音Url,通话录音url(有效期3个月),格式为wav,形如https://xxxx.wav |
»» hangupCause | body | string | 是 | 挂断原因 |
»» termSipCode | body | string | 是 | sipCode |
»» intents | body | [object] | 是 | 意向,可通过查询该任务所属话术模板的意向标签设置获取 |
»»» intentID | body | string | 是 | 意向标签id |
»»» intentTag | body | string | 是 | 意向标签tag,可通过查询该任务所属话术模板的意向标签设置获取 |
»»» intentName | body | string | 是 | 意向标签名 |
»»» intentLevel | body | string | 是 | 意向优先级 |
»» sms | body | [object] | 否 | 短信 |
»»» smsSendTs | body | integer | 是 | 短信发送时间 |
»»» sysMessageID | body | string | 是 | 短信发送id |
»»» smsContent | body | string | 是 | 短信发送内容 |
»» agent | body | object | 否 | 坐席相关信息 |
»»» agentName | body | string | 是 | 接听坐席名 |
»»» agentGroup | body | string | 是 | 接听坐席组 |
»»» agentCallStatus | body | integer | 是 | 坐席接听状态 |
»»» agentCallElapsed | body | integer | 是 | 坐席接听时长 |
»»» agentLabel | body | string | 是 | 坐席标签 |
»»» manualCallStart | body | integer | 是 | 转人工开始时间戳 |
»»» manualCallAnswer | body | integer | 是 | 转人工接通时间戳 |
»»» manualCallEnd | body | integer | 是 | 转人工结束时间戳 |
»»» manualHangupBy | body | integer | 是 | 被谁挂断了0:none,1:坐席挂断,2:用户挂断 |
»» params | body | [object] | 否 | 变量 |
»»» name | body | string | 是 | 变量名 |
»»» value | body | string | 是 | 变量值 |
属性 | 值 | |
---|---|---|
» callbackType | 1 | 任务回调 |
» callbackType | 2 | 订单回调 |
» callbackType | 3 | 通话回调 |
»» callStatus | 1 | 准备通话 |
»» callStatus | 2 | 调度中 |
»» callStatus | 3 | 拨打中 |
»» callStatus | 4 | 响铃中 |
»» callStatus | 5 | 正在通话 |
»» callStatus | 6 | 通话结束-完成通话 |
»» callStatus | 8 | 通话结束-不合法号码 |
»» callStatus | 9 | 通话结束-暂时无法接通 |
»» callStatus | 10 | 通话结束-用户占线 |
»» callStatus | 11 | 通话结束-用户忙线并拒接 |
»» callStatus | 12 | 通话结束-用户拒接 |
»» callStatus | 13 | 通话结束-用户拒接 |
»» callStatus | 15 | 通话结束-tts合成失败 |
»» callStatus | 16 | 通话结束-未知原因 |
»» callStatus | 17 | 通话结束-黑名单号码 |
»» callStatus | 18 | 通话结束-用户叫停 |
»» callStatus | 21 | 通话结束-无效号码(号码检测非法,不满足当地号段) |
»» callStatus | 22 | 通话结束-响铃不接 |
»» callStatus | 23 | 通话结束-拨打没响应 |
»» callStatus | 24 | 通话结束-早媒体-语音信箱 |
»» callStatus | 25 | 通话结束-响铃过长 |
»»» smsSendTs | 0 | 未发送 |
»»» smsSendTs | 1 | 已发送 |
»»» smsSendTs | 2 | 发送成功 |
»»» smsSendTs | 3 | 发送失败 |
»»» smsSendTs | 4 | 点击成功 |
»»» agentCallStatus | 1 | 拨打中 |
»»» agentCallStatus | 2 | 响铃中 |
»»» agentCallStatus | 3 | 接通 |
»»» agentCallStatus | 4 | 完成通话 |
»»» agentCallStatus | 10 | 通话完成-坐席繁忙 |
»»» agentCallStatus | 12 | 通话完成-用户拒接 |
返回示例
200 Response
{
"retCode": 0,
"retMsg": "string",
"responseID": "string"
}
状态码 | 状态码含义 | 说明 | 数据模型 |
---|---|---|---|
200 | OK | 成功 | Inline |
状态码 200
名称 | 类型 | 必选 | 约束 | 解释 |
---|---|---|---|---|
» retCode | integer | true | none | 响应码,0为成功,其余为失败 |
» retMsg | string | true | none | 响应消息 |
» responseID | string | true | none | 响应id,随机唯一id,用于请求追踪,定位问题时需要提供该次请求的responseID |
简介
短信
语音
- 上传语音录音文件
- 上传语音录音文件_v1
- 已上传录音文件查询
- 发送语音群呼
- 发送语音通知
- 发送语音验证码
- 语音验证码回填上报
- 语音回执回调
- 语音记录查询
- 上传语音录音文件-旧版本已废弃
- 发送语音群呼‐旧版已废弃
- 发送语音通知‐旧版已废弃
- 发送语音验证码‐旧版已废弃
- 语音回执回调‐旧版已废弃
云呼叫中心(NXLink)
- Web SDK
- Iframe集成
- 手动拨号通话记录查询
- 通过orderId查询
- 手动拨号记录回调
- 坐席信息查询
- 坐席状态查询
- 坐席组查询
- 坐席可用主叫查询
- 坐席组成员查询
- 坐席组更新成员
- 坐席效率统计
- 创建AICC外呼任务
- Webhook-手动外呼
云呼叫中心(AI自动外呼)
- Callbot API概述
- Callbot API鉴权
- Callbot 接口探活
- 创建自动拨号任务
- 批量添加拨打名单
- 创建自动拨号任务并添加拨打名单
- 任务控制(启动/暂停)
- 更新任务
- 获取通话列表
- 获取任务列表
- 获取拨打订单列表
- 停止订单拨打
- 查询订单维度拨打详情
- 通话维度回调
- 订单维度拨打回调
- 任务状态回调
- 批次-导出最新批次数据
- 批次-导入最新批次数据
Flash Call
短链
邮件验证码
DID号码
- DID号码进行短信下行V2
- DID短信结果回调(加签)
- DID短信结果回调(无加签)
- DID号码短信记录查询(新接口,未启用)
- DID号码通话记录查询
- DID呼出并转接到Amazon坐席
- DID呼出前与Connect号码绑定
通用
号码检测
- 发送消息
- webhook
- 标记入站消息已读
- 上传媒体文件
- 获取媒体文件
- 删除媒体文件
- 查询号码信息
- 查询消息模板
- 创建消息模板
- 编辑消息模板
- 删除消息模板
- 上传模板示例文件
- 嵌入式页面登录
- 创建客户应用
- 客户应用的号码列表
- 获取验证码
- 核验验证码
- flows-创建流
- flows-更新流
- flows-根据流ID查询流信息
- flows-根据whatsapp号码查询流列表
- flows-根据流ID查询流预览地址
- flows-查询流JSON
- flows-发布流
- flows-删除流草稿
- flows-废弃已发布的流
- flows-更新流JSON
- flows-上传业务公钥
- ads-根据公共主页ID查询绑定的数据集列表
- ads-根据数据集ID上报CAPI广告数据
Viber
Zalo ZNS
Super Message API
隐私号(旧)
PNS
坐席(旧版)
- NXphone PC 使用说明
- NXphone Android 使用说明
- NXphone Android SDK 接入文档
- 呼叫挂断原因解释
- 话单CDR查询接口
- 话单CDR回调接口说明(V1.0)
- 坐席API调用接口说明(V1.0)
- 根据orderid查询话单CDR接口
- 坐席系统sip链接调用方式(推荐)
- 号码脱敏处理
- 修改话机密码接口
- 查询审批单
- 查询话机
- WebRTC SDK使用说明
AI Agent(对外api)