Como evitar banimento na API de WhatsApp

Banimento quase sempre é consequência de comportamento: mensagem para quem não pediu, volume que cresce rápido demais e conteúdo que gera denúncia. Com consentimento, aquecimento do número e envio gradual, o risco cai bastante. Nenhum fornecedor sério promete risco zero.

Por que números são bloqueados

O WhatsApp não publica a regra exata, mas os sinais que pesam são conhecidos por quem opera números há algum tempo. Todos têm a ver com a experiência de quem recebe:

  • Denúncias e bloqueios. Cada vez que alguém toca em "denunciar" ou bloqueia o contato, o número perde reputação. Poucas denúncias num período curto bastam para uma restrição.
  • Mensagens sem resposta. Um número que só envia e quase nunca recebe resposta se parece com spam, mesmo que o conteúdo seja legítimo.
  • Crescimento brusco. Um número que ontem conversava com dez pessoas e hoje envia para cinco mil chama atenção.
  • Padrão de máquina. Mesmo texto, mesmo intervalo, em sequência para contatos que não têm o número salvo.

Isso vale para qualquer API de WhatsApp, oficial ou não. Na não oficial, o controle é todo seu; na oficial, a Meta mede a qualidade do número e limita o envio quando ela cai.

Boas práticas de envio

Consentimento antes de tudo

Só envie para quem pediu, e registre como pediu: checkbox no cadastro, clique num botão de "falar no WhatsApp", pedido feito na loja. Lista comprada ou raspada de grupo é o caminho mais curto para o bloqueio. Guarde a data e a origem do consentimento junto do contato no seu banco; isso também ajuda a responder ao cliente que pergunta por que recebeu.

Aquecimento de número novo

Um número recém-ativado não tem histórico. Nas primeiras semanas, use-o como uma pessoa usaria: conversas com contatos que respondem, alguns grupos, mensagens recebidas e enviadas. Só depois comece a automatizar, e comece pelos contatos mais engajados.

Volume gradual e intervalos

Aumente o volume diário aos poucos e distribua os envios ao longo do dia, com intervalos variáveis entre mensagens. Se o seu caso exige disparar para muitos contatos, divida entre números e respeite o ritmo de cada um. Na D-API, o endpoint /api/v1/limits/{sessionId} retorna as cotas de mensagens e restrições da conta, o que ajuda a calibrar o ritmo:

curl https://api.d-api.cloud/api/v1/limits/vendas-01 \
  -H "Authorization: SUA_API_KEY"

Conteúdo que as pessoas querem receber

Personalize com o nome e com o contexto real do contato (o pedido, a consulta, a fatura). Evite link encurtado desconhecido, texto todo em maiúsculas e a mesma mensagem idêntica para milhares de pessoas. Uma mensagem que a pessoa estava esperando raramente é denunciada.

Responda e deixe sair

Trate as respostas: um número que conversa tem reputação melhor do que um que só dispara. Processe o webhook de mensagens recebidas e encaminhe para um atendente ou para um bot. E ofereça uma saída clara, como "responda SAIR para não receber mais", removendo o contato da lista na hora.

Checklist antes de automatizar um número

  • Todos os contatos da lista deram consentimento, e a origem está registrada.
  • O número tem pelo menos algumas semanas de uso real, com conversas nos dois sentidos.
  • Nome, foto e descrição do perfil identificam a empresa.
  • O volume do primeiro dia é pequeno e existe um plano de crescimento semanal.
  • Os envios têm intervalo variável e ficam em horário comercial.
  • Cada mensagem é personalizada e tem motivo claro para aquele contato.
  • Existe opção de sair, e o pedido é atendido imediatamente.
  • As respostas chegam ao seu sistema por webhook e alguém ou algo responde.
  • Seu sistema acompanha o status da conexão e para os envios se o número cair.
  • Há um plano para quando um número for restrito: quem avisa quem e o que para.

O papel da infraestrutura

Boa prática reduz a chance de bloqueio. Infraestrutura reduz o tamanho do problema quando ele acontece, e evita que problemas de rede pareçam comportamento suspeito.

  • IP dedicado por conexão. Dezenas de números saindo do mesmo endereço formam um padrão que não se parece com uso real. Na D-API, cada conexão recebe um proxy com IP único, gerenciado pela plataforma.
  • Isolamento entre números. Cada conexão roda em ambiente próprio, com credenciais e webhook próprios. Se um número de um cliente for bloqueado, os números dos outros clientes seguem funcionando.
  • Reconexão estável. Conexões que caem e voltam o tempo todo geram pareamentos repetidos. A reconexão automática mantém a sessão de pé sem ninguém precisar ler QR de novo a cada instabilidade.

Isso importa principalmente para quem opera muitos números de clientes diferentes, como um SaaS ou uma agência. A forma de organizar essa operação está em API de WhatsApp com múltiplos números.

Quando o disparo é o objetivo

Se o seu caso é comunicação para uma base grande, vale considerar a API oficial para a parte que inicia conversa, e a não oficial para o atendimento que vem depois. A comparação está em API oficial vs não oficial. Para campanhas com volume, a página de disparo em massa pela API mostra como estruturar o envio sem queimar números, e a API não oficial da D-API explica a infraestrutura por trás de cada conexão.

Perguntas frequentes

Dá para garantir que um número nunca será banido?

Não. Quem decide o bloqueio é o WhatsApp, com critérios que não são públicos. O que está ao seu alcance é reduzir muito a chance, com consentimento, volume gradual e conteúdo que as pessoas querem receber, e limitar o estrago se acontecer.

Quanto tempo leva para aquecer um número novo?

Não existe prazo oficial. Uma referência prática é passar algumas semanas com uso parecido com o de uma pessoa: conversas de ida e volta, poucos contatos novos por dia, crescimento gradual. Pressa nessa fase é a causa mais comum de bloqueio em número novo.

Usar a API oficial elimina o risco de bloqueio?

Reduz, mas não elimina. Na oficial, a Meta acompanha a qualidade do número com base em bloqueios e denúncias e pode limitar o envio ou restringir a conta quando a qualidade cai. Consentimento e relevância continuam valendo.

Um número banido afeta os outros da mesma conta?

Depende da infraestrutura. Se todos os números saem do mesmo servidor e do mesmo IP, um problema pode respingar nos outros. Na D-API, cada conexão roda isolada e com IP próprio justamente para evitar esse efeito dominó.

O que fazer quando um número é bloqueado?

Pare os envios automáticos daquele número, revise o que foi enviado nas últimas horas e para quem, e use o pedido de revisão do próprio aplicativo. Antes de colocar outro número no lugar, corrija a causa, senão o novo número vai pelo mesmo caminho.

Teste a API de WhatsApp da D-API

Trial de 3 dias com acesso completo. Sem cartão, sem fidelidade.