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

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

字段说明

sessionId string

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

customerId string

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

phoneNumber string

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

numberLocation string

客户号码归属地

numberCarrier 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：占线
call_rate_limit：呼叫限制

robotId string

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

robotName string

机器人名称。

taskId string

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

taskName string

任务名称。

lineId string

线路ID。

lineName string

线路名称。

callAttemptNumber int

呼叫次序，表示同一客户号码在同一任务中的第几次呼叫尝试，从 1 开始计数。当对同一号码进行多次外呼时，该字段用于标识这是第几次拨打。

retryCall boolean

是否为重试呼叫（由重呼配置触发的通话标记），true-是，false-否

hangupParty string

挂断方：

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

callDuration int

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

ringDuration int

振铃时长，单位：秒

turnCount int

对话轮次，通话过程中用户与机器人之间完成的对话总轮次。

importedAt string

通话记录被系统导入的时间。示例 2026-02-09 10:23:45。

callStartTime string

通话开始时间，格式为 yyyy-MM-dd HH:mm:ss。

callEndTime string

通话结束时间，格式为 yyyy-MM-dd HH:mm:ss。

callRecording string

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

ringbackToneUrl string

振铃音地址，有效期为7天

ext object

随路数据

callTags array 通话产生的标签（过程标签），可能会有多个标签。

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

extractResult map 通话产生信息提取数据。

summary string 通话内容摘要。由AI自动分析通话内容生成的简要总结。

前置条件： 需要先启用摘要功能，配置路径：「机器人详情」→「AI智能分析」→「对话摘要设置」

字段说明：

包含内容：对话要点、客户意图、关键信息
为空情况：未启用配置 / 非有效通话（包含系统标签） / 异步生成中
长度限制：最大为500字符

conversationContent array

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

点击展开字段说明

query string

客户说话内容

queryTime string

客户说话时间点，格式为 yyyy-MM-dd HH:mm:ss ，精确到秒

answer string

机器人回复内容

answerTime string

机器人回复时间点，格式为 yyyy-MM-dd HH:mm:ss，精确到秒

返回数据

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

success boolean

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

数据示例

json

{
  "sessionId": "1234",
  "customerId": "1",
  "phoneNumber": "10086",
  "numberLocation": "北京",
  "numberCarrier": "移动",
  "callStatus": "call_success",
  "robotId": "12345",
  "robotName": "机器人名称",
  "taskId": "11",
  "taskName": "任务名称",
  "lineId": "线路ID",
  "lineName": "线路名称",
  "callAttemptNumber": 1,
  "retryCall": false,
  "hangupParty": "customer",
  "callDuration": 12,
  "ringDuration": 55,
  "turnCount": 3,
  "importedAt": "2026-02-09 10:23:45",
  "callStartTime": "2025-01-01 12:32:30",
  "callEndTime": "2025-01-01 12:32:42",
  "callRecording": "http://www.aa.com/aaa.wav",
  "ringbackToneUrl": "http://www.aa.com/ringing.wav",
  "ext": {
    "客户姓名": "张三",
    "手机尾号": "0086"
  },
  "callTags": [
    "满意",
    "很满意"
  ],
  "resultTags": [
    "有需求"
  ],
  "extractResult": {
    "满意度调查": "非常满意"
  },
  "summary": "客户在对话中表现出对客服提及的项目有一定关注，虽未明确表达参与意愿，但回应中包含‘知道了’‘嗯嗯嗯’等认可性语言，结合上下文判断存在潜在意向。",
  "conversationContent": [
    {
      "query": "WELCOME",
      "queryTime": "2026-01-01 12:30:30",
      "answer": "你好，我是机器人",
      "answerTime": "2026-01-01 12:30:31"
    },
    {
      "query": "你好，我是客户",
      "queryTime": "2026-01-01 12:30:35",
      "answer": "好的，咱们开始对话吧",
      "answerTime": "2026-01-01 12:30:36"
    }
  ]
}

响应示例

json

{
  "success": true
}

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

字段说明 ​

返回数据 ​

数据示例 ​

响应示例 ​

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

字段说明

返回数据

数据示例

响应示例