Receiving Events
call.ended
call.ended reports an ended call and includes data.call.id, reason and duration_seconds. List call.ended in subscribed_events to receive outbound events.
Event payload
{
"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
}
}Notes
- call.ended reports an ended call and includes data.call.id, reason and duration_seconds. List call.ended in subscribed_events to receive outbound events.
- Standard workspaces must explicitly list call.answered and call.ended in subscribed_events to receive outbound events. Beta workspaces can also use *, an empty list, or an omitted list. Delivery, retry, and dead-letter replay check the current eligibility and subscription. message.* call records are independent.
- duration_seconds measures connected time rounded down to whole seconds; 0 does not prove the call was unanswered. Track call.answered as well. A synchronous creation error may have no call.ended event. This event is not a chat system message.