API Reference

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.