Callbot API orderDetailList

callbot-api

v1.0.0

Base URLs:

• 正式环境: https://nxbot.nxcloud.com

aibot外部接口v3.0/通话操作

鉴权方式

鉴权请查看文档https://github.com/nxtele/http-api-document/wiki/Callbot-API-authorization

POST 列出通话详情

POST /callcentre/api/v3/listOrderDetail

按订单ID列出该订单下每通通话的详细信息

Body 请求参数

{
  "productID": "callbot",
  "userTaskID": "string",
  "orderList": [
    "string"
  ]
}

请求参数

名称	位置	类型	必选	中文名	说明
requestID	header	string	是		请求唯一id
uuid	header	string	是		uuid,由被调用方给出
createTs	header	string	是		请求时间戳,(秒级)
sign	header	string	是		签名
body	body	object	否		none
» productID	body	string	是	产品id	定值"callbot"
» userTaskID	body	string	是	任务id	请求方的任务id(调用方生成并且保证唯一)，建议使用uuid
» orderList	body	[string]	是	订单列表	限制最多500个订单id

返回示例

200 Response

{
  "retCode": 0,
  "retMsg": "string",
  "responseID": "string",
  "orderDetailList": [
    {
      "orderID": "string",
      "userPhone": "string",
      "userName": "string",
      "sceneID": "string",
      "userTaskID": "string",
      "taskID": "string",
      "finish": true,
      "other": "string",
      "callInfoDetailList": [
        {
          "callID": "string",
          "callStatus": 1,
          "callStartTs": 0,
          "callAnswerTs": 0,
          "callEndTs": 0,
          "callDuration": 0,
          "callAudioUrl": "string",
          "intents": [
            {}
          ],
          "sms": [
            {}
          ],
          "agent": {
            "agentName": null,
            "agentGroup": null,
            "agentCallStatus": null,
            "agentCallElapsed": null,
            "agentLabel": null,
            "manualCallStart": null,
            "manualCallAnswer": null,
            "manualCallEnd": null
          },
          "params": [
            {}
          ],
          "recordDetail": [
            {}
          ]
        }
      ]
    }
  ]
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» retCode	integer	true	none	响应码	0为成功，其余为失败
» retMsg	string	true	none	响应消息	none
» responseID	string	true	none	响应id	随机唯一id，用于请求追踪，定位问题时需要提供该次请求的responseID
» orderDetailList	[object]	true	none		none
»» orderID	string	true	none	订单id	none
»» userPhone	string	true	none	手机号	none
»» userName	string	true	none	用户名	none
»» sceneID	string	true	none	话术模板id	none
»» userTaskID	string	true	none	用户任务id	none
»» taskID	string	true	none	任务id	none
»» finish	boolean	true	none	订单完成	none
»» other	string	true	none	透传字段	none
»» callInfoDetailList	[object]	true	none		none
»»» 通话详细信息	object	false	none	通话详细信息	none
»»»» callID	string	true	none	通话id	none
»»»» callStatus	integer	true	none	通话状态	none
»»»» callStartTs	integer	true	none	通话拨打时间戳	none
»»»» callAnswerTs	integer	true	none	通话接听时间戳	接听时间戳有值不代表通话被接听，请参照callStatus判断通话状态
»»»» callEndTs	integer	true	none	通话挂断时间戳	none
»»»» callDuration	integer	true	none	通话接听秒数	none
»»»» callAudioUrl	string	true	none	通话录音Url	通话录音url（有效期3个月），格式为wav,形如https://xxxx.wav
»»»» intents	[object]	true	none	意向	可通过查询该任务所属话术模板的意向标签设置获取
»»»»» intentID	string	true	none	意向标签id	none
»»»»» intentTag	string	true	none	意向标签tag	可通过查询该任务所属话术模板的意向标签设置获取
»»»»» intentName	string	true	none	意向标签名	none
»»»» sms	[object]	false	none	短信	none
»»»»» smsSendTs	integer	true	none	短信发送时间	none
»»»»» sysMessageID	string	true	none	短信发送id	none
»»»»» smsContent	string	true	none	短信发送内容	none
»»»» agent	object	false	none	坐席相关信息	none
»»»»» agentName	string	true	none	接听坐席名	none
»»»»» agentGroup	string	true	none	接听坐席组	none
»»»»» agentCallStatus	integer	true	none	坐席接听状态	none
»»»»» agentCallElapsed	integer	true	none	坐席接听时长	none
»»»»» agentLabel	string	true	none	坐席标签	none
»»»»» manualCallStart	integer	true	none	转人工开始时间戳	none
»»»»» manualCallAnswer	integer	true	none	转人工接通时间戳	none
»»»»» manualCallEnd	integer	true	none	转人工结束时间戳	none
»»»» params	[object]	false	none	变量	none
»»»»» name	string	true	none	变量名	none
»»»»» value	string	true	none	变量值	none
»»»» recordDetail	[object]	false	none	通话记录详情	none
»»»»» recordWord	string	true	none	记录文字	none
»»»»» recordIndex	integer	true	none	记录顺序	none
»»»»» recordRole	integer	true	none	记录角色	none
»»»»» recordType	integer	true	none	记录类型	none
»»»»» nodeID	string	true	none	节点id	none
»»»»» nodeDesc	string	true	none	节点描述	none
»»»»» createTs	integer	true	none	记录时间	none

枚举值

属性	值	说明
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	通话结束-无效号码(号码检测非法,不满足当地号段)
smsSendTs	0	未发送
smsSendTs	1	已发送
smsSendTs	2	发送成功
smsSendTs	3	发送失败
smsSendTs	4	点击成功
agentCallStatus	1	拨打中
agentCallStatus	2	响铃中
agentCallStatus	3	接通
agentCallStatus	4	完成通话
agentCallStatus	10	通话完成-坐席繁忙
agentCallStatus	12	通话完成-用户拒接
recordRole	0	机器人记录
recordRole	1	用户记录
recordRole	2	坐席记录
recordType	5	用户端超时
recordType	6	用户端打断
recordType	7	用户端正常回应
recordType	8	服务端回应
recordType	18	客服回复