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:
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ção | Conversas novas por dia |
|---|---|
| Primeira semana | 5 |
| Semanas 2–4 | 10 |
| Depois de um mês | 20 |
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:
| Plano | Mês | Dia | Minuto (por chave) |
|---|---|---|---|
| Free | 100 | 20 | 4 |
| Starter | 1.000 | 60 | 8 |
| Pro | 5.000 | 250 | 12 |
| Scale | 20.000 | 700 | 20 |
Quando você bate em um, a resposta diz exatamente qual e quando libera. O guia de erros decifra cada código.