Empresa brasileira · Entrega automática · Suporte em português Seg a sex, 9h as 18h · PIX em reais
ProxyBox
API de WhatsApp · Enviar e receber

Bloquear contatos, silenciar conversas e administrar grupos, comunidades e canais pela API de WhatsApp

Bloquear contatos, silenciar e apagar conversas, fixar mensagem, mudar a privacidade, administrar grupos, comunidades e canais e enviar evento pela API.

5 min de leitura Atualizado em 14 de novembro de 2026
Resposta curta
A versão 1.4 da API de WhatsApp da ProxyBox acrescentou 16 rotas para tarefas que antes só dava para fazer no celular: bloquear e desbloquear contatos, silenciar e apagar conversas, fixar mensagem, mudar a privacidade do perfil, criar canais, administrar comunidades, controlar quem entra nos grupos e enviar convite de evento. Todas estão em teste (beta). Provadas em aparelho real em 14/11/2026: bloquear, desbloquear, listar bloqueados, fixar mensagem, convite de evento, quem adiciona membros ao grupo e aprovação de entrada. A privacidade e a criação de canal foram aceitas pelo WhatsApp; as demais têm teste automatizado e ainda não foram provadas em número real. Este guia explica cada tarefa; o formato exato de cada rota está na referência.

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}/mute com value: true. O campo seconds define por quanto tempo (até um ano); sem ele, silencia para sempre. Com value: false, a conversa volta a avisar.
  • Marcar como não lida: POST /chats/{chat}/unread com unread: true (ou false para 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. Com delete_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átis

Como 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/link coloca um grupo que você administra dentro dela, .../groups/unlink tira e GET /communities/{community}/groups lista os grupos. Essas três ainda não foram provadas em número real.
  • Canal: POST /channels com name e description devolve o channel_id e o código de convite (aceito pelo WhatsApp em 14/11/2026). POST /channels/mute silencia 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

Í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.

Guias relacionados

Pronto para colocar no ar?

Comece no sandbox, grátis. Quando funcionar, contrate a instância do seu número e pague com PIX ou saldo.

Com IP brasileiro dedicado R$ 89,90/mês
Só a instância (traga o seu IP) R$ 39,90/mês
Travou em alguma etapa?Manda o print do erro no WhatsApp. Respondemos em português.
Suporte em português Fale no WhatsApp