Pular para o conteúdo
whatsapi.sh
Tema
Docs

Como não ser banido

Esta é uma API não oficial do WhatsApp. O WhatsApp pode restringir ou banir qualquer número que use uma. Os limites e a fila reduzem rajadas de envios, mas não eliminam o risco. Este guia mostra o que conferir antes de enviar e como recuperar um número desconectado.

Por que os números são restringidos

O WhatsApp pontua todo número em três coisas: com que velocidade ele envia, quanto ele envia, e como as pessoas reagem, ou seja, bloqueios, denúncias de “não é meu contato” e mensagens ignoradas. Um número que dispara textos idênticos pra desconhecidos em rajada erra nas três de uma vez. Restrição raramente se anuncia. O sintoma de sempre é o número silenciosamente perder a sessão e se recusar a parear de novo.

Ninguém fora do WhatsApp conhece os limites exatos, e quem cita um número está chutando. O que vem abaixo são os ritmos que a gente viu sobreviver a bastante tempo de produção.

Espace todos os envios

Mensagens que você inicia ficam guardadas numa fila por padrão, mesmo para quem já conversou com o número. Elas saem uma por vez, com o intervalo configurado. Só a resposta para quem escreveu para este número nas últimas 24 horas sai na hora. Veja a fila de envio para grupos, códigos de login e outras exceções explícitas.

Se pular ou desligar a fila, espaçar os envios vira tarefa sua. Não use o limite por minuto do plano como meta de envio. Este exemplo coloca minutos entre as mensagens:

loop com espaçamento
const jitter = () => 15_000 + Math.random() * 45_000; // 15–60s

for (const recipient of queue) {
  await send(recipient);
  await sleep(jitter()); // same average pace, no fingerprint
}

O limite por minuto do seu plano é um teto, não uma meta. Ele existe pra que um loop descontrolado não torre um número enquanto você dorme.

Divida a carga entre números

Dez números enviando 20 mensagens cada parecem dez pessoas ocupadas. Um número enviando 200 parece uma máquina. Conecte mais números e revese os destinatários entre eles. Cada um traz o próprio limite de conversas novas, que é o teto que de fato pesa.

Mantenha os envios espaçados, mesmo usando vários números. send_batch coloca todo destinatário na fila com o intervalo completo, inclusive quem já conversou com o número. Um lote para pessoas novas também gasta o limite de conversas novas do dia.

O limite de conversas novas

Todo número tem um limite diário para as conversas que ele começa, ou seja, pessoas com quem nunca conversou antes. Isso limita novas abordagens. A fila de envio é outra proteção: ela também espaça mensagens para quem já conversou com o número, se a pessoa não escreveu nas últimas 24 horas.

Responder quem escreveu pra você primeiro nunca gasta esse limite, e mensagem para grupo também não. Só a primeira abordagem gasta.

O limite cresce conforme o número ganha reputação. Quando você pareia um, perguntamos há quanto tempo a linha está mesmo em uso, porque o WhatsApp nunca conta, e somamos os dias que acompanhamos desde então:

ReputaçãoConversas novas por dia
Primeira semana5
Semanas 2–410
Depois de um mês20

Gastou, e os envios para gente nova respondem 429 com scope: "newConversations" até a meia-noite. Nenhum plano levanta isso: plano maior compra mais números, e cada número traz o próprio limite. Mesmo assim, você pode definir o limite de um número, pra mais ou pra menos, nos ajustes de envio dele no painel ou com update_number. Acima desta tabela, o risco de banimento é seu. Um número que o WhatsApp restringiu volta pra primeira linha, perde o limite que você definiu e sobe de novo.

Aqueça antes do volume

Número recém-pareado não tem reputação nenhuma. Trate as primeiras semanas dele como treino: troque mensagens de verdade, deixe as pessoas responderem, salve contatos, entre num grupo. Comece com um punhado de envios por dia e cresça por semana, não da noite pro dia. Os números que morrem são os que foram pareados ao meio-dia e às duas já estavam disparando.

Envie como gente

  • Envie no horário em que a pessoa está acordada, onde ela mora. Nada de bom acontece às 3 da manhã.
  • Varie o texto entre destinatários. Cinquenta cópias da mesma frase é a digital clássica de spam.
  • Não comece uma mensagem fria com um link.
  • Escreva para quem espera saber de você, e respeite pedidos de descadastro na hora.

Leia os sinais de alerta

Mais falhas de entrega, envios lentos ou um LOGGED_OUT de repente podem indicar perda de sessão ou restrição. Pare novos envios e abra o WhatsApp no celular. Restrições temporárias costumam acabar em cerca de 1 hora, mas podem durar até 24 horas. Siga o aviso no celular. Quando conseguir enviar e receber mensagens normalmente, use Reconectar em Números e confirme a recuperação. Aqui não há trava fixa de 24 horas. Se o celular ainda mostrar restrição ou banimento, não insista na reconexão. As mensagens que ainda não saíram continuam na fila.

O que aplicamos de qualquer jeito

Todo envio é medido contra quatro tetos: por chave por minuto, por conta por dia, por conta por mês, e o limite de conversas novas por número, lá de cima. Envio em lote também exige plano pago. São redes de proteção, calibradas abaixo dos ritmos que matam número:

PlanoMêsDiaMinuto (por chave)
Free100204
Starter1.000608
Pro5.00025012
Scale20.00070020

Quando você bate em um, a resposta diz exatamente qual e quando libera. O guia de erros decifra cada código.