Pular para o conteúdo principal
As configurações por chat ficam em client.chat (WaAppStateMutationCoordinator). São mutações de app-state — sincronizam entre todos os seus dispositivos vinculados, e mudanças feitas em outro lugar voltam no evento mutation.
Essas operações afetam a visão da sua conta (e dos seus outros dispositivos). Elas não mudam nada para os outros participantes — ex.: deletar um chat não o deleta para eles. Para deletar para todos, use um revoke.

Mute

muteEndTimestampMs é obrigatório ao silenciar (epoch ms). Para “silenciar para sempre”, passe um timestamp bem no futuro. O client não remove o silêncio sozinho quando o timer expira — esse é o momento em que o WhatsApp reativa as notificações.

Pin & arquivar

Pin e arquivar são mutuamente exclusivos — fixar um chat limpa o flag de arquivado e vice-versa. O WhatsApp limita a quantidade de chats fixados no servidor.

Lido / não lido

Lock

Travar também limpa o arquivado e o pin.

Favoritar uma mensagem

Uma mensagem é identificada por uma WaAppStateMessageKey:

Limpar & deletar

clearChat mantém mensagens favoritadas e mídia por padrão; defina deleteStarred / deleteMedia para apagá-las também. Nenhum dos dois sai de um grupo — use client.group.leaveGroup para isso.

Deletar uma mensagem para mim

Remove uma única mensagem apenas do(s) seu(s) dispositivo(s) — os destinatários continuam vendo:
Para deletar para todos, envie um revoke.

Além dos helpers

Os métodos acima são atalhos tipados. Para qualquer coisa sem um helper dedicado — contatos, labels, quick replies, privacidade de status e a lista completa de schemas de app-state — use o client.chat.set() / client.chat.remove() genérico. Veja a referência de chat mutations.

Reagindo a mudanças

Quando uma configuração de chat muda em outro dispositivo, você recebe um evento mutation:
Última modificação em 28 de maio de 2026