call.ended

EVENTOcall.endeddesde M7envelope v1

Chamada encerrada.

Quando é emitido

A chamada terminou; sai uma vez por chamada. missed: true quando tocou sem ninguém atender e não foi rejeitada. reason: caller_hangup (tocou sem atender até quem ligou desistir), accepted_elsewhere (atendida no celular ou em outro aparelho da conta; sai logo depois de call.accepted, no atendimento: o aparelho vinculado não é avisado do fim da conversa), ended (encerrada depois de atendida), rejected (por calls.auto_reject), rejected_by_peer (o outro lado rejeitou e nenhum fim chegou em 5 segundos), timeout (nenhum sinal em 2 minutos) ou outro motivo enviado pelo WhatsApp. O "reject" que um aparelho hospedado do WhatsApp (hosted.lid, aparelho 99) manda logo após toda oferta é ignorado.

Campos de data

Campo	Tipo	Descrição
call_id	string	Id da chamada.
chat	string	Chat de quem ligou, ou o grupo.
caller	string	JID de quem ligou.
reason	string	Motivo do fim (opcional).
missed	boolean	Chamada perdida (opcional).
timestamp	string	Quando terminou.

O envelope (id, type, version, instance_id, timestamp,data) está em Visão geral. Campos novos podem ser adicionados emdata sem mudar a versão: ignore os que não conhecer.

Exemplos

Corpo do POST

{
  "id": "evt_9c4f2a8e6b1d3075",
  "type": "call.ended",
  "version": 1,
  "instance_id": "inst_7f3a9c2e5b1d4086",
  "timestamp": "2026-10-18T10:09:00.000Z",
  "data": {
    "call_id": "7D1A3F9B2E5C",
    "chat": "5511999999999@s.whatsapp.net",
    "caller": "5511999999999@s.whatsapp.net",
    "media": "audio",
    "reason": "timeout",
    "missed": true,
    "timestamp": "2026-10-18T10:09:00Z"
  }
}

Entrega e ordem

• Por webhook: pelo menos uma vez, com retry por até 24 horas. O mesmo evento pode chegar duas vezes: deduplique porX-LiteZap-Event-Id. Veja Entrega e retentativas.
• A ordem entre eventos não é garantida (retentativas reordenam): use timestamp.
• Por SSE: ao vivo, sem replay. Veja Tempo real com SSE.
• Para assinar só este tipo: "events": ["call.ended"] no webhook, ou?types=call.ended no SSE.

Relacionados: call.received · call.accepted

Equivalente na Z-API: Webhook de chamadas.