call.received

EVENTOcall.receiveddesde M7envelope v1

Chamada recebida.

Quando é emitido

Uma chamada de voz ou vídeo está tocando (individual, ou em grupo com is_group). Com calls.auto_reject uma chamada individual é rejeitada antes do evento (em menos de 3 segundos) e sai com rejected: true; calls.reject_message vai ao autor pela fila. Chamadas em grupo e ofertas com mais de 1 minuto (entregues depois de uma reconexão) só são informadas. Atender chamadas pela API não é possível.

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.
is_group	boolean	Chamada de grupo (opcional).
media	string	audio ou video (opcional).
rejected	boolean	Rejeitada automaticamente (opcional).
timestamp	string	Quando tocou.

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_1f6c9a3e7b0d2584",
  "type": "call.received",
  "version": 1,
  "instance_id": "inst_7f3a9c2e5b1d4086",
  "timestamp": "2026-10-18T10:07:00.000Z",
  "data": {
    "call_id": "4B2E9D1F7A3C",
    "chat": "5511999999999@s.whatsapp.net",
    "caller": "5511999999999@s.whatsapp.net",
    "media": "audio",
    "rejected": true,
    "timestamp": "2026-10-18T10:07: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.received"] no webhook, ou?types=call.received no SSE.

Relacionados: call.accepted · call.ended

Equivalente na Z-API: Webhook de chamadas.