Documentação / Comece Aqui / API Não Oficial / Restrições em Conexões Não Oficiais
Comece Aqui · API Não Oficial

Restrições em Conexões Não Oficiais

Conexões não oficiais — Z-API, Evolution API e ferramentas semelhantes — funcionam simulando o comportamento do WhatsApp Web para vincular um número à plataforma. Como esse método não é autorizado pela Meta, os números conectados assim ficam sujeitos a restrições, bloqueios temporários e, em casos mais graves, banimento permanente. Esta página explica o que provoca esses bloqueios, o que fazer quando acontecem e por que a API oficial continua sendo a recomendação.

⚠️

Importante: a C&M Executive não se responsabiliza por bloqueios ou banimentos decorrentes do uso de conexões não oficiais. O risco é inerente ao método, não à plataforma. Sempre que for possível, o uso da API oficial do WhatsApp é a opção recomendada.

01 O que é um soft ban

O soft ban é um bloqueio temporário que o WhatsApp aplica quando identifica comportamento considerado suspeito. Ele é diferente do banimento permanente em um aspecto que costuma confundir: não vem acompanhado de uma mensagem de erro clara. O número simplesmente para de enviar ou receber mensagens direito, sem aviso.

Um dos sinais mais comuns é o erro z301, retornado por ferramentas como a Z-API, que indica que o número foi temporariamente restrito.

02 O que provoca as restrições

O WhatsApp cruza vários sinais para identificar uso automatizado. Estes são os que mais pesam:

  • Divergência de localização (IP) — o número está registrado em uma cidade, mas a conexão parte de um servidor em outra região ou país. É um dos sinais mais fortes de detecção;
  • Tempo de resposta do chatbot — respostas instantâneas e padronizadas, abaixo de um segundo, denunciam automação;
  • Alto volume de mensagens — muitos envios em pouco tempo, especialmente para contatos que nunca interagiram com o número;
  • Bloqueios em massa — quando muitos destinatários bloqueiam ou denunciam o número num intervalo curto;
  • Múltiplos IPs ou dispositivos — o mesmo número conectado em várias instâncias, ou alternando de servidor com frequência;
  • Instabilidade na conexão — quedas e reconexões repetidas criam um padrão de uso anormal;
  • Falta de aquecimento — números novos que já começam disparando alto volume, sem um período de uso gradual.

03 Consequências possíveis

Soft ban temporário. O número fica restrito por horas ou dias. Costuma se resolver sozinho depois de um período de inatividade.

Banimento permanente. Em caso de reincidência ou violação grave, o número pode ser banido definitivamente, sem possibilidade de recurso.

Perda do número. Esta é a consequência que merece mais atenção. Em banimentos permanentes originados de conexão não oficial, a Meta não oferece suporte para recuperação — porque o uso da ferramenta já configura, por si só, uma violação dos termos de serviço. Não existe formulário de revisão a preencher, como acontece na API oficial.

04 O que fazer em caso de soft ban

A reação natural é tentar reconectar imediatamente — e é exatamente o que agrava o problema. Cada nova tentativa reforça o padrão que gerou a restrição.

1
Desconecte o número

Tire o número da ferramenta não oficial imediatamente e não tente reconectar.

2
Aguarde

Espere pelo menos 24 a 48 horas antes de qualquer tentativa de reconexão. Em alguns casos é preciso aguardar até 72 horas.

3
Reduza o volume ao voltar

Ao reconectar, diminua bastante a quantidade de mensagens e aumente aos poucos, ao longo de dias.

05 A recomendação: API oficial

A única forma de eliminar esse risco — em vez de apenas reduzi-lo — é migrar para a API oficial do WhatsApp, que entrega:

  • conexão autorizada e estável;
  • nenhum risco de soft ban ou banimento por uso de ferramenta não autorizada;
  • suporte da Meta para resolver problemas, incluindo pedido de revisão em caso de bloqueio;
  • limites de envio maiores, que crescem conforme a qualidade do número.

O passo a passo de conexão está em Cloud API. Se você precisa manter o aplicativo funcionando no celular com o mesmo número, a alternativa é a Cloud API QR Code (Coexistência).

ℹ️

Vale ter em mente que os soft bans estão cada vez mais frequentes, porque o WhatsApp segue aprimorando os mecanismos de detecção. Mesmo seguindo todas as boas práticas, o risco em conexões não oficiais nunca é eliminado — apenas reduzido. E se um número já sofreu soft bans repetidos, a migração para a API oficial deixa de ser recomendação e vira urgência: o próximo bloqueio pode ser o permanente.

Suporte