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