Webhook chat_presence

{
  "type": "chat_presence",
  "event_id": "01J5Q8ZK3M4N5P6Q7R8S9T0V1Y",
  "instance_id": "8f2a3c1e-6b7d-4e5f-9a0b-1c2d3e4f5a6b",
  "momment": 1786968540000,
  "phone": "5511988887777",
  "status": "COMPOSING",
  "last_seen": null
}

​

Para que serve

• Segurar a resposta automática enquanto o cliente ainda está digitando (espere PAUSED ou a mensagem chegar).
• Mostrar “digitando…” no seu painel de atendimento.
• Detectar que o cliente está online antes de enviar algo urgente.

​

O que esperar

• O WhatsApp só envia presença de contatos com quem há conversa recente e que não a ocultaram na privacidade. Nem todo contato gera eventos.
• COMPOSING, RECORDING e PAUSED chegam sozinhos nas conversas ativas. AVAILABLE e UNAVAILABLE só chegam de contatos consultados em GET /contacts/{phone}/presence e enquanto o seu número está online (always_online nas configurações).
• É o webhook de maior volume, e cada tecla pode virar um COMPOSING. Vem desligado por padrão (chat_presence_url: null). Ligue só se for usar e considere um endpoint separado para não atrasar os demais.
• Em grupos, phone é o id do grupo; hoje o Wabox não informa qual participante está digitando.