Como bloqueio e desbloqueio um contato?
Use POST /contacts/{phone}/block e POST /contacts/{phone}/unblock, com o telefone no endereço. GET /blocked-contacts devolve a lista de números bloqueados e o total. O bloqueio vale no WhatsApp da instância: a pessoa bloqueada não consegue escrever para o número. Bloquear não apaga a conversa.
Esta rota é de administração: tem teto por hora e por dia, como as demais rotas de admin (veja erros e limites). Se o número não tiver WhatsApp, a resposta é number_not_on_whatsapp.
Como silencio, marco como não lida ou apago uma conversa?
- Silenciar:
POST /chats/{chat}/mutecomvalue: true. O camposecondsdefine por quanto tempo (até um ano); sem ele, silencia para sempre. Comvalue: false, a conversa volta a avisar. - Marcar como não lida:
POST /chats/{chat}/unreadcomunread: true(oufalsepara marcar como lida). - Apagar:
DELETE /chats/{chat}apaga a conversa do aparelho da instância. Não apaga para a outra pessoa e não tem como desfazer. Comdelete_media: true, apaga também as fotos, vídeos e arquivos.
chat é o número do contato ou o id do grupo, o mesmo formato do campo to nas rotas de envio.
Como fixo uma mensagem no alto da conversa?
POST /messages/{message_id}/pin com o chat, o value (true para fixar, false para soltar) e, se quiser, seconds com 86400 (24 horas), 604800 (7 dias, o padrão) ou 2592000 (30 dias). Em grupo, se a mensagem for de outra pessoa, envie também sender com o telefone dela e from_me: false.
Quer rodar isto agora? O sandbox é grátis, não precisa de número e já vem com a chave da API.
Testar grátisComo mudo a privacidade do número?
PUT /profile/privacy muda uma regra por vez: name pode ser groupadd (quem coloca o número em grupos), last (visto por último), status, profile (foto), readreceipts (confirmação de leitura), online, calladd (quem liga) ou messages. value pode ser all, contacts, contact_blacklist, none, match_last_seen ou known. Nem toda combinação vale para toda regra: o WhatsApp recusa a que não faz sentido, e a resposta traz o motivo. Beta de 14/11/2026, repetir o valor atual de quatro regras foi aceito e a resposta devolveu as regras do número.
Como administro comunidades e canais?
- Comunidade: criar comunidade pela API não funciona: em beta de 14/11/2026 o WhatsApp recusou o pedido (erro 400), e a rota foi retirada. Crie a comunidade no aplicativo. Depois,
POST /communities/{community}/groups/linkcoloca um grupo que você administra dentro dela,.../groups/unlinktira eGET /communities/{community}/groupslista os grupos. Essas três ainda não foram provadas em número real. - Canal:
POST /channelscomnameedescriptiondevolve ochannel_ide o código de convite (aceito pelo WhatsApp em 14/11/2026).POST /channels/mutesilencia um canal que a instância segue. A API não apaga canal: exclua pelo aplicativo. Publicar mensagens em canal não é suportado.
Como controlo quem entra no grupo?
PUT /groups/{group}/member-add-mode define se só administradores (admin_add) ou todos (all_member_add) podem adicionar gente. PUT /groups/{group}/join-approval liga ou desliga a aprovação de quem pede para entrar (as duas foram provadas em aparelho real em 14/11/2026); os pedidos aparecem em GET /groups/{group}/requests e se aprovam ou recusam com as rotas de grupos.
Como envio um convite de evento?
POST /messages/event envia um convite com name, start_time (no futuro, em ISO 8601), e opcionalmente end_time, description, location_name com latitude e longitude, e join_link (https). Provado em aparelho real em 14/11/2026: o convite chega como evento do WhatsApp, com nome, dia e horário e os botões "Editar evento" e "Adicionar ao calendário". É uma mensagem de envio: conta no limite de 10 por minuto e 500 por dia.
O que não é suportado?
Adicionar ou editar contato na agenda, vídeo redondo, catálogo de produtos, publicar em canal, mudar o recado do perfil, criar comunidade e botão PIX não estão disponíveis. O recado e a criação de comunidade foram testados em 14/11/2026 e o WhatsApp recusou o pedido (erro 400). O botão PIX foi testado em aparelho real em 14/11/2026: o WhatsApp aceitou o envio, mas a mensagem não chegou; por isso a rota foi retirada. Para cobrar por PIX, envie o código copia e cola em texto. Mensagem em massa também não, por decisão da casa (veja segurança).
Veja também
- Referência da API de WhatsApp: todas as rotas
- Grupos e canais pela API
- Contatos pela API de WhatsApp
- Erros e limites da API de WhatsApp
Índice completo: índice dos guias. Sobre o produto: API de WhatsApp com IP brasileiro dedicado.
Autoria: equipe técnica da ProxyBox. Atualizado em 14/11/2026. As rotas estão em beta (as provadas estão indicadas acima); o comportamento descrito vem da biblioteca do WhatsApp e do catálogo da versão 1.4.