Receiving Events

call.endedbeta

この機能はクローズドベータ版です。ワークスペースでの利用を希望する場合は、テクニカルサポートにお問い合わせください。

call.ended は終了した通話の data.call.id、reason、duration_seconds を通知します。ベータワークスペースでは subscribed_events に call.ended または * を指定するか、空配列または省略で受信できます。

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
  }
}

注記

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 がない場合があります。チャットのシステムメッセージとは別です。