Callbot API orderDetailList - nxtele/http-api-document GitHub Wiki

callbot-api

v1.0.0

Base URLs:

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 是 签名
algorithm header string 否 签名的算法：MD5或者SHA256，不填默认用MD5
body body object 否
» 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",
          "hangupCause": "string",
    	  "termSipCode": "string",
          "intents": [
            {}
          ],
          "sms": [
            {}
          ],
          "agent": {
            "agentName": null,
            "agentGroup": null,
            "agentCallStatus": null,
            "agentCallElapsed": null,
            "agentLabel": null,
            "manualCallStart": null,
            "manualCallAnswer": null,
            "manualCallEnd": null,
            "manualHangupBy": 0
          },
          "params": [
            {}
          ],
          "recordDetail": [
            {}
          ]
        }
      ]
    }
  ]
}

返回结果

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

响应的header

名称 类型 必选 说明
requestID string 是 与请求头一致
uuid string 是 与请求头一致
createTs string 是 响应时的秒级时间戳
sign string 是 生成方法与请求头sign生成算法一样
algorithm string 否 与请求头一致，签名的算法：MD5或者SHA256，不填默认用MD5

返回数据结构

状态码 200

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