Pular para o conteúdo principal

Perfil

O client.profile (WaProfileCoordinator) lê e grava campos de perfil da sua conta e os consulta para terceiros.

Foto de perfil

getProfilePicture(jid, type?, existingId?) retorna um WaProfilePictureResult{ url?, directPath?, id?, type? }. O segundo argumento escolhe entre a variante compacta 'preview' (default) e o original em alta resolução 'image'; ambos vêm no mesmo envelope, só os bytes por trás de url / directPath diferem. Passe o existingId cacheado para o servidor fazer short-circuit quando a foto não mudou (o resultado então volta sem o novo url/directPath).

Recado / texto de status

Push name

O pushName é o nome de exibição que os contatos veem para a sua conta em chats e listas de participantes de grupo. A mudança é aplicada às credenciais locais imediatamente (então client.getCredentials()?.pushName já reflete o novo valor) e é roteada por uma mutação de app-state; os contatos veem o novo nome na sua próxima mensagem enviada.
Passar string vazia restaura o nome para o padrão de fingerprint do dispositivo.

Modo temporário padrão

O setDisappearingMode define a duração padrão de modo temporário aplicada a novos chats 1:1 iniciados por você. Chats existentes mantêm a configuração por chat.
Para mensagens temporárias por grupo, veja Grupos → mensagens temporárias.

Consultas em lote

Checar se um número está no WhatsApp

Resolva números de telefone para o LID e descubra se cada um está registrado no WhatsApp:

Nomes de usuário

Privacidade

O client.privacy (WaPrivacyCoordinator) controla as categorias de privacidade e a lista de bloqueios.

Configurações de privacidade

Os nomes e valores das configurações vêm das constantes WA_PRIVACY_* (last, online, profile, status, readreceipts, groupadd, …). Veja a referência de JID e constantes.

Lista de bloqueios

Listas de exceção

Para configurações escopadas a uma lista específica de contatos (por exemplo, “compartilhar com todos, exceto…”):

Business

O client.business (WaBusinessCoordinator) lê perfis business e nomes verificados, e gerencia o seu próprio perfil business. Conta business — necessária para editar seu próprio perfil ou foto de capa; os métodos de leitura funcionam para qualquer conta.

Business hours tipados

WaBusinessHoursDay e WaBusinessHoursMode são aliases de union ('sun' | 'mon' | …, 'open_24h' | 'specific_hours' | 'appointment_only'). Os valores também estão congelados em WA_BUSINESS_HOURS_DAYS e WA_BUSINESS_HOURS_MODES. Passar um mode desconhecido para editBusinessProfile agora lança um erro local claro em vez de o servidor responder 406 not-acceptable — dias fechados continuam sendo expressos omitindo-os da config, não por um mode dedicado.

Configurações de chat

As configurações por chat — silenciar, fixar, arquivar, lido, lock, favoritar, limpar, excluir — ficam em client.chat e sincronizam entre seus dispositivos. Elas têm um guia próprio:

Gerenciando chats

Silencie, fixe, arquive, marque como lido, trave, favorite mensagens, limpe e exclua chats.
Última modificação em 12 de junho de 2026