查看结果：发送记录与话单推送
三种结果获取途径的对比与实操：控制台记录、查询 API 与 Webhook 推送。
语音呼叫的逐通结果有三种获取途径，可按需组合使用。
开始前的准备
- 已发起过呼叫任务（见 发起呼叫）
三种途径对比
| 途径 | 实时性 | 适合场景 |
|---|---|---|
| Console 发送记录 | 手动查看 | 人工排查、日常巡检 |
| 查询 API | 按需拉取 | 定时对账、落库分析 |
| 话单推送（Webhook） | 实时推送 | 事件驱动的业务闭环 |
推荐组合：Webhook 实时接收 + 查询 API 兜底对账。
Console 发送记录
在语音控制台的发送记录页查看逐通结果，支持按被叫号码、呼叫结果（成功/失败）、结束码、批次号、国家、时间段筛选；详情包含通话时长与录音回放。
查询 API 要点
- 时间窗口必填（
startDate，格式yyyy-MM-dd HH:mm:ss），仅允许查询最近 90 天 taskId即发送接口返回的callId，可精确定位一个任务countryCode必填；支持按被叫号码、批次、模板过滤- 分页
page/size（≤100）；限流 30 QPS（超限040001）
话单推送要点
- 呼叫到达终态后，平台向配置的回调地址 POST 事件（
eventCode=cdr_status_push，eventId即callId） - 接收端须返回 2xx；当前版本失败不自动重试，请保障服务稳定
- 按
eventId幂等处理，避免重复入库 - 支持可选的
X-CALLBACK-IDHMAC-SHA256 签名验证，协议与验签示例见 话单推送
结果字段解读
| 字段 | 含义 |
|---|---|
| callState | 呼叫结果状态（成功/失败） |
| callDesc / callDescMsg | 结束码与文字说明（挂断原因） |
| answerTime | 接通时间（未接通为空） |
| recallCount | 已重拨次数 |
| recordUrl | 录音地址（无录音为空） |
| smsSendTime / smsStatus | 挂机短信的发送时间与状态 |
结束码（callDesc）的具体取值以实际返回为准；Console 记录、查询 API 与推送三处的同一字段语义一致。
对账建议
- 以
bulkId/callId+mobile为对账键 - Webhook 实时落库；每日（或每小时）用查询 API 按时间窗拉取比对，补齐推送丢失的话单
acceptedCount（受理数）与最终话单数的差值用于发现异常
常见问题
收不到 Webhook 推送？
依次检查：回调地址已在平台配置、接收服务公网可达、响应为 2xx、对应呼叫是否已到终态。配置查看入口见 使用语音控制台。
同一通电话收到多次推送？
当前版本失败不重试，但仍建议按 eventId（= callId）幂等处理，防网络重放或未来版本引入重试机制。
查询 API 查不到记录？
确认时间窗在 90 天内、countryCode 与呼叫国家一致；新受理的任务稍等片刻再查（外呼与落库存在时延）。
相关资源
最后更新于