API 参考

接收事件

call.endedbeta

当前功能处于内测阶段,可联系技术支持申请开通工作区资格。

call.ended 表示本系统管理的通话已结束,包含 data.call.id、reason、duration_seconds。内测工作区的 subscribed_events 包含 call.ended 或 *,或为空数组、省略时均可接收。

事件载荷

{
  "id": "evt_call_example",
  "type": "call.ended",
  "provider": "whatsapp",
  "account_id": "acc_example",
  "occurred_at": "2026-10-10T12:00:42Z",
  "data": {
    "call": {
      "id": "call_example",
      "direction": "outbound",
      "media_type": "voice",
      "state": "ended"
    },
    "reason": "remote_hangup",
    "duration_seconds": 42
  }
}

备注

  • call.ended 表示本系统管理的通话已结束,包含 data.call.id、reason、duration_seconds。内测工作区的 subscribed_events 包含 call.ended 或 *,或为空数组、省略时均可接收。
  • 通话事件权限由工作区 is_beta 控制。内测工作区的 subscribed_events 为 *、空数组或省略时包含通话事件;具体事件列表仍仅匹配列出的事件。非内测工作区可使用通配订阅,但不会收到通话事件;明确订阅通话事件仍返回 403 beta_feature_not_enabled。每次投递、重试及死信重放都重新核验资格,查询失败不放行;普通 message.* 通话记录独立,不受该限制。
  • duration_seconds 是接通时长,向下取整为秒;0 不一定表示未接通,应同时记录 call.answered。创建阶段同步失败可能没有 call.ended 回调。本事件不等同于聊天系统消息。