Skip to main content
O WhatsApp organiza conversas em etiquetas, que nas versões recentes do app aparecem como Listas. Estes webhooks notificam quando uma etiqueta é criada, editada ou excluída, e quando ela é aplicada ou removida de uma conversa ou de uma mensagem. Todos seguem o envelope comum — o conteúdo específico fica em data.
Os webhooks entregam mudanças. Ao conectar, a sessão sincroniza todas as etiquetas e associações da conta, mas essa sincronização não gera webhooks (seria o mesmo estado reenviado a cada reconexão). Para o estado completo, use GET /labels/list e GET /labels/contact-labels.

labels.edit

string
required
Identificador da etiqueta.
string
Nome da etiqueta.
number
Código de cor da etiqueta.
boolean
true quando a etiqueta foi excluída.
string
Tipo da lista. custom para as criadas pelo usuário; as listas do próprio WhatsApp vêm como unread (Não lidas), favorites (Favoritos), groups (Grupos), predefined (sugeridas pelo app, como “Novo pedido”), entre outras. Etiquetas antigas podem vir como none.
number
Identificador da lista sugerida pelo WhatsApp, quando list_type é predefined. 0 nas demais.
number
Posição da lista no app.
boolean
Se a lista está ativa no app.
boolean
true para listas do sistema, que o usuário não pode renomear nem excluir.
number
Momento do evento em milissegundos (epoch).

labels.association.chat

string
required
Identificador da etiqueta.
string | null
Nome da etiqueta. null se ela ainda não foi sincronizada.
number | null
Cor da etiqueta. null se ela ainda não foi sincronizada.
string
required
JID da conversa (...@s.whatsapp.net ou ...@g.us). Quando o número do contato não é conhecido pela sessão, vem como LID (...@lid).
boolean
required
true aplica a etiqueta à conversa; false remove.

labels.association.message

Mesmos campos de labels.association.chat, mais o identificador da mensagem.
string
required
Identificador da mensagem.