Chats, contatos e presença

Estes eventos mantêm seu sistema sincronizado com o estado dos chats, os dados de contatos e a presença (online, visto por último). Todos seguem o envelope comum — o conteúdo específico fica em data.

`chats.update` e `chats.upsert`

chats.upsert indica um chat criado ou recebido na sincronização; chats.update indica uma atualização de um chat existente. Os dois eventos têm o mesmo formato de data.

{
  "event": "chats.update",
  "sessionId": "my-session",
  "timestamp": "2026-01-24T23:05:00.000Z",
  "data": {
    "jid": "5511999999999@s.whatsapp.net",
    "name": "João",
    "unread_count": 2,
    "conversation_timestamp": 1769295900,
    "archived": false,
    "pinned": 0,
    "mute_end_time": 0
  }
}

string

required

JID do chat (contato ou grupo).

string

Nome do chat (contato ou nome do grupo).

number

Quantidade de mensagens não lidas.

number

Momento da última atividade da conversa em segundos (epoch).

boolean

true quando o chat está arquivado.

number

Indica se o chat está fixado (0 quando não está).

number

Momento (epoch) em que o silenciamento termina; 0 quando não está silenciado.

Eventos chats.upsert passam por debounce de 2 segundos por chat: múltiplas atualizações do mesmo chat em sequência são agrupadas.

`contacts.update` e `contacts.upsert`

contacts.upsert indica um contato criado ou recebido na sincronização; contacts.update indica uma atualização de um contato existente. Os dois eventos têm o mesmo formato de data.

{
  "event": "contacts.update",
  "sessionId": "my-session",
  "timestamp": "2026-01-24T23:06:00.000Z",
  "data": {
    "jid": "5511999999999@s.whatsapp.net",
    "push_name": "João",
    "full_name": "João Silva",
    "first_name": "João",
    "business_name": ""
  }
}

string

required

JID do contato.

string

Nome de exibição definido pelo próprio contato no WhatsApp.

string

Nome completo do contato (quando salvo na agenda).

string

Primeiro nome do contato.

string

Nome comercial, quando se trata de uma conta business. String vazia ("") quando não se aplica.

Eventos contacts.upsert passam por debounce de 2 segundos por contato: múltiplas atualizações do mesmo contato em sequência são agrupadas.

`presence`

Disparado quando muda a presença de um contato (online/offline, visto por último).

{
  "event": "presence",
  "sessionId": "my-session",
  "timestamp": "2026-01-24T23:07:00.000Z",
  "data": {
    "jid": "5511999999999@s.whatsapp.net",
    "name": "João",
    "unavailable": false,
    "last_seen": 1769296020
  }
}

string

required

JID do contato cuja presença mudou.

string

Nome do contato.

boolean

true quando o contato está offline/indisponível; false quando está online.

number

Momento do último acesso em segundos (epoch), quando disponível.

O evento presence passa por deduplicação de 5 segundos por contato e estado (online/offline): mudanças idênticas dentro dessa janela não geram webhooks duplicados.

Introdução

API Oficial (SaaS)

Assistente de Integração

Ligações

Webhooks

Chats, contatos e presença

`chats.update` e `chats.upsert`

`contacts.update` e `contacts.upsert`

`presence`

​chats.update e chats.upsert

​contacts.update e contacts.upsert

​presence

`chats.update` e `chats.upsert`

`contacts.update` e `contacts.upsert`

`presence`