接收事件

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。本事件唔等同聊天系統訊息。