通话记录回调数据格式说明

在电话外呼结束后，如果配置了通话记录回调，则会进行回调，同一通通话可能会回调多次，可以使用sessionId 来进行唯一处理

字段说明

sessionId string

通话记录 ID，每通通话都有一个唯一的 ID。

---

customerId string

客户 ID，客户的唯一标识。

---

phoneNumber string

客户号码，可以是标准手机号，也可以是固话。

---

callStatus string

通话状态，枚举值如下：

• unconnected：未接通
• call_success：呼叫成功
• line_fault：线路故障
• no_one_answer：无人接听
• timeout：超时未接听
• user_refuse：用户拒接
• voice_mail：语音信箱
• call_remind：来电提醒
• unreachable：无法接通
• insufficient_balance：用户欠费
• powered_off：关机
• service_suspended：停机
• invalid_number：空号
• call_fail：呼叫失败
• busy：占线

---

robotId string

机器人 ID，通话所使用的机器人。

---

robotName string

机器人名称。

---

taskId string

任务 ID，通话所绑定的任务。

---

taskName string

任务名称。

---

hangupParty string

挂断方：

• customer：客户挂断
• system：系统挂断

---

callDuration int

通话时长，单位为秒，当通话状态非正常接通时，通话时长为 null

---

callStartTime string

通话开始时间，格式为 "YYYY-MM-DD HH:mm:ss"。

---

callEndTime string

通话结束时间，格式为 "YYYY-MM-DD HH:mm:ss"。

---

callRecording string

通话录音地址，有效期为 7 天，7 天后失效。

---

call_tags array 通话产生的标签，可能会有多个标签。

---

conversationContent array

通话内容，以数组格式存储。结构如下：

点击展开字段说明

query string

客户说的内容

---

answer string

机器人说的内容

返回数据

回调方在成功接收到数据之后，需要返回指定结构的数据，如果没有收到该数据，认为是回调不成功，会进行重试。数据结构如下：

success boolean

true ：成功接收到数据，并且数据正常。

数据示例

{
  "sessionId": "1234",
  "customerId": "1",
  "phoneNumber": "10086",
  "callStatus": "call_success",
  "robotId": "12345",
  "robotName": "机器人名称",
  "taskId": "11",
  "taskName": "任务名称",
  "hangupParty": "customer",
  "callDuration": 12,
  "callStartTime": "2025-01-01 12:32:30",
  "callEndTime": "2025-01-01 12:32:42",
  "callRecording": "http://www.aa.com/aaa.wav",
  "call_tags": [
    "满意",
    "很满意"
  ],
  "conversationContent": [
    {
      "query": "",
      "answer": "你好，我是机器人"
    },
    {
      "query": "你好，我是客户",
      "answer": "好的，咱们开始对话吧"
    }
  ]
}

响应示例

{
  "success": true
}