Aquecimento automático de número por 14 dias
Todo número recém-conectado à apiwpp passa por 14 dias de aquecimento, com limites de envio que sobem por etapa. Veja a tabela e como acompanhar pela API.
Atualizado em
Um número que acabou de ser conectado a um sistema e, no mesmo dia, começa a enviar centenas de mensagens tem o comportamento típico de um robô. É o tipo de padrão que o WhatsApp observa com mais atenção. O aquecimento de número (muita gente chama de aquecimento de chip) é o período em que o volume sobe aos poucos, para o número ganhar histórico antes de chegar ao ritmo normal.
Na apiwpp você não precisa controlar isso na mão. Durante os 14 dias depois do pareamento, a fila de cada número aplica limites menores, que sobem em etapas. Você envia normalmente pela API e a fila decide quando cada mensagem sai.
As cinco etapas do aquecimento
Os valores abaixo são os padrões da apiwpp e contam a partir do momento em que o número foi pareado:
| Desde a conexão | Por hora | Por dia | Destinatários novos por 24 horas |
|---|---|---|---|
| Até 6 horas | 5 | 20 | 5 |
| 6 a 24 horas | 10 | 50 | 10 |
| 1 a 3 dias | 20 | 100 | 20 |
| 3 a 7 dias | 30 | 150 | 30 |
| 7 a 14 dias | 45 | 200 | 50 |
Depois do 14º dia valem os limites normais do número: 3 envios por minuto, 60 por hora, 200 por dia e 100 destinatários novos a cada 24 horas. Em qualquer momento continuam valendo o intervalo aleatório de 3 a 8 segundos entre dois envios e o mínimo de 30 segundos entre duas mensagens para a mesma pessoa. Esses limites são explicados em detalhe na página da fila com ritmo anti-bloqueio.
Nenhuma etapa passa dos limites normais. O aquecimento só aperta; ele nunca libera mais do que o número teria depois dos 14 dias.
O que conta como destinatário novo
Um contato é conhecido quando trocou mensagem com o número nos últimos 28 dias, depois da conexão atual: escreveu para ele ou recebeu mensagem dele, pela API ou digitada no celular. Qualquer outro é um destinatário novo, e cada um conta uma vez a cada 24 horas. Grupos não contam.
Quando o número já alcançou o limite de destinatários novos da etapa, um envio para mais uma pessoa nova é recusado na hora, sem entrar na fila:
{ "error": "new_recipient_cap_reached", "message": "This number already reached 100 new recipients …" }
A resposta vem com status 429 e o cabeçalho Retry-After: os segundos até uma vaga abrir ou, durante o aquecimento, até a próxima etapa aumentar o limite, o que vier antes. Contatos conhecidos nunca são barrados por esse limite. Por isso, nos primeiros dias, as mensagens para quem já conversa com o número continuam saindo normalmente.
Quando o aquecimento recomeça
O aquecimento pertence ao pareamento, não ao chip. Ele começa de novo quando:
- você conecta outro número a uma conexão;
- o mesmo número volta depois de um logout, ou depois de o WhatsApp encerrar a sessão do lado dele (o evento
connection.statuschega comreason: logged_out).
Nesses casos, as contagens por minuto, hora e dia recomeçam do zero, e os contatos conhecidos também: todos voltam a ser destinatários novos até trocarem mensagem com o número outra vez.
Já uma queda de rede, um reinício do servidor ou uma desconexão feita pela API não reiniciam nada. A sessão fica salva e criptografada, e o número volta sem novo QR code, com o aquecimento no ponto em que estava. Veja mais em conexão por QR code ou código de pareamento.
Como acompanhar o aquecimento pela API
O estado atual da fila de cada número está em GET /connections/{id}/queue, que precisa de uma chave com o escopo connections:read:
curl https://api.apiwpp.com/connections/$CONNECTION_ID/queue \
-H "Authorization: Bearer $APIWPP_KEY"
A resposta traz os limites que valem agora, quanto deles já foi usado e o bloco warmup:
{
"pending": 1,
"scheduled": 2,
"limits": { "perMinute": 3, "perHour": 20, "perDay": 100, "newRecipientsPerDay": 20 },
"usage": { "minute": 1, "hour": 12, "day": 40, "newRecipients": 7 },
"warmup": { "createdAt": 1789646400000, "messagesSent": 40, "isInWarmup": true, "endsAt": 1790856000000 }
}
warmup.isInWarmupdiz se o número ainda está no período de aquecimento.warmup.createdAtewarmup.endsAtsão o início (o pareamento) e o fim, em milissegundos unix.limitsjá mostra os valores da etapa atual, eusage.newRecipientsquantas pessoas novas o número alcançou nas últimas 24 horas.
Com esses campos, o seu sistema pode exibir um aviso no painel do cliente ("número em aquecimento até o dia 12"), segurar campanhas grandes até o fim do período ou priorizar os envios que importam.
Como aproveitar os primeiros 14 dias
O aquecimento reduz o risco de restrição, mas nada garante que um número nunca será bloqueado pelo WhatsApp. O que você envia nesses dias pesa tanto quanto o volume:
- Comece por quem já conhece o número. Clientes que escreveram para você ou esperam a mensagem são contatos conhecidos e não gastam a cota de destinatários novos.
- Responda às mensagens recebidas. Conversas de ida e volta são o comportamento normal de uma pessoa, e cada resposta transforma o remetente em contato conhecido.
- Deixe campanhas para depois. Lembretes e confirmações cabem nos limites da primeira semana; listas grandes, não.
- Trate o
429como informação. Respeite oRetry-Aftere reenvie depois, em vez de insistir. - Evite trocar de número à toa. Cada novo pareamento recomeça as etapas do zero.
O guia completo, com o raciocínio por trás de cada etapa, está no post aquecimento de número: por que os primeiros 14 dias importam. Para o conjunto de práticas que reduzem o risco de bloqueio, veja como evitar o bloqueio do número.
Perguntas frequentes
Posso desligar o aquecimento?
Não pela API. O aquecimento faz parte da proteção de cada número recém-conectado e é aplicado pela fila automaticamente. Um número que já estava conectado antes de o aquecimento existir continua com os limites normais.
O teste grátis também passa pelo aquecimento?
Sim. O número do teste de 7 dias segue as mesmas etapas de qualquer número conectado. Durante o teste, dá para enviar o suficiente para validar a integração; os limites maiores chegam com o passar dos dias.
O que acontece com as mensagens que passam do limite da etapa?
Elas esperam na fila: a resposta 202 do envio já traz scheduledAt, o horário previsto, e position, o lugar na fila. A exceção é o limite de destinatários novos, que recusa o envio na hora com 429 e Retry-After, sem enfileirar nada.
Reconectar depois de uma queda reinicia o aquecimento?
Não. Quedas de rede, reinícios e desconexões feitas pela API mantêm a sessão salva e o aquecimento continua de onde parou. Só um novo pareamento, depois de logout ou com outro número, começa as etapas do zero.
Outros recursos
Todos: Recursos →Cada número conectado tem uma fila que envia no ritmo de uma pessoa: limites por minuto, hora e dia, intervalo aleatório entre envios e um teto de destinatários novos por dia. Mensagens ilimitadas dentro desses limites.
Cada número entra na apiwpp como um aparelho conectado, igual ao WhatsApp Web: escaneie o QR code ou digite um código de 8 caracteres no celular e acompanhe o status pela API e pelo webhook connection.status.
Cada número sai para o WhatsApp por um IP brasileiro de provedor de internet, compartilhado só com números do mesmo cliente. Você pode trocar pelo seu próprio proxy ou, no plano PRO, contratar um IP só para um número.