Aquecimento de número: por que os primeiros 14 dias importam
Como o limite de envio do WhatsApp cresce nos 14 dias depois da conexão, o que recomeça o aquecimento e o que fazer com o número nesse período.
Você conectou um número novo à API, escreveu a integração, testou com o seu próprio celular e agora quer avisar os clientes. Aí vem a surpresa: a fila aceita as mensagens, mas agenda boa parte delas para daqui a algumas horas, e alguns envios voltam com 429. Não é um defeito. É o aquecimento do número.
Aquecer um número (muita gente fala em "aquecer o chip") é fazer o volume de mensagens crescer aos poucos depois que ele é conectado, em vez de sair enviando no ritmo máximo no primeiro minuto. O motivo é simples: um aparelho recém-conectado que começa a iniciar dezenas de conversas é exatamente o comportamento que o WhatsApp associa a spam.
Este guia explica por que os primeiros 14 dias importam, quais são as etapas que a apiwpp aplica, o que faz o aquecimento recomeçar do zero e como usar bem esse período, com exemplos da API. Uma ressalva antes de tudo: o aquecimento reduz o risco de restrição, mas nenhuma ferramenta garante que um número nunca será bloqueado. Quem decide é o WhatsApp.
O que é aquecer um número
Aquecimento é um período de limites menores logo depois do pareamento, com tetos que sobem por etapas até chegar ao ritmo normal. Na apiwpp ele dura 14 dias, é automático e vale para todo número conectado, em qualquer plano. A definição curta está no glossário, em aquecimento de número.
Três limites crescem juntos durante esse período:
- Envios por hora, que controlam o ritmo imediato da fila;
- Envios por dia, que controlam o volume total;
- Destinatários novos por 24 horas, ou seja, quantas pessoas que nunca trocaram mensagem com o número ele pode alcançar num dia.
O terceiro é o que mais importa. Enviar muito para quem já conversa com você raramente é um problema. Começar conversa com desconhecidos, logo após conectar, é o que costuma gerar denúncia e restrição.
Por que um número recém-conectado é mais vigiado
A API da apiwpp funciona pelo protocolo do WhatsApp Web: o seu número entra como um aparelho conectado, igual ao WhatsApp Web no navegador. Para o WhatsApp, cada novo pareamento é um evento, e o comportamento das primeiras horas e dias diz muito sobre quem está do outro lado.
Uma pessoa que conecta o WhatsApp Web continua as conversas que já tinha: responde quem escreveu, manda uma mensagem aqui e outra ali. Um robô de disparo conecta e começa a mandar o mesmo texto para centenas de números que nunca falaram com ele. As restrições do WhatsApp a novas conversas, como o bloqueio temporário que a apiwpp detecta e reporta, costumam aparecer justamente em números conectados há pouco tempo que escrevem para quem nunca escreveu para eles.
Por isso o aquecimento não é só "enviar menos". É fazer o número se comportar, nos primeiros dias, como alguém que acabou de abrir o WhatsApp Web para trabalhar: conversas em andamento primeiro, contatos novos com parcimônia.
As cinco etapas do aquecimento na apiwpp
Os limites são contados a partir do momento do pareamento e mudam sozinhos quando o número passa de uma etapa para a outra:
| Desde o pareamento | Por hora | Por dia | Destinatários novos em 24 h |
|---|---|---|---|
| Até 6 horas | 5 | 20 | 5 |
| De 6 a 24 horas | 10 | 50 | 10 |
| De 1 a 3 dias | 20 | 100 | 20 |
| De 3 a 7 dias | 30 | 150 | 30 |
| De 7 a 14 dias | 45 | 200 | 50 |
Depois do 14º dia valem os limites normais da fila com ritmo anti-bloqueio: 3 mensagens por minuto, 60 por hora e 200 por dia por número, com intervalo aleatório de 3 a 8 segundos entre envios, pelo menos 30 segundos entre duas mensagens para o mesmo destinatário e 100 destinatários novos a cada 24 horas.
Alguns detalhes fazem diferença na hora de planejar:
- Nenhuma etapa passa dos limites normais. O aquecimento só aperta: em cada etapa vale o menor valor entre o da tabela e o limite normal da fila.
- O limite por minuto também cai. Com poucos envios por hora, a fila espaça mais as mensagens. O valor em vigor aparece na API, como você verá adiante.
- Mensagens não são perdidas por hora ou por dia. Quando o teto por hora ou por dia é atingido, a fila agenda o envio para a próxima vaga. A resposta
202do envio já traz opositione oscheduledAt, o horário previsto. - Destinatários novos são recusados na hora. Quando o número já alcançou o teto de destinatários novos das últimas 24 horas, o envio para mais uma pessoa nova responde
429comnew_recipient_cap_reachede nada é colocado na fila.
Esse último ponto é importante para a sua integração. Durante o aquecimento, o cabeçalho Retry-After dessa resposta traz os segundos até abrir uma vaga ou até a próxima etapa aumentar o teto, o que vier antes. Ou seja: às vezes basta esperar a mudança de etapa.
Quem conta como destinatário novo
É conhecido o contato que trocou mensagem com o número nos últimos 28 dias e depois do pareamento atual: escreveu para ele ou recebeu mensagem dele, pela API ou digitada no celular. Todo o resto é destinatário novo. Grupos não contam, e cada destinatário novo conta uma vez a cada 24 horas.
A consequência prática é boa: quem escreve para o número vira contato conhecido na hora. Responder um cliente que mandou mensagem nunca é barrado pelo teto de destinatários novos, nem no primeiro dia.
O que recomeça o aquecimento (e o que não recomeça)
O relógio do aquecimento conta a partir do pareamento, não da última vez que a conexão abriu. Isso separa dois tipos de situação:
| Situação | O aquecimento recomeça? |
|---|---|
| Queda de rede, reinício ou atualização dos servidores | Não. A sessão fica salva e a conexão volta sozinha. |
| Desconectar pela API e reconectar depois | Não. A sessão continua guardada e não pede QR code novo. |
| Fatura atrasada que suspende a conta | Não. Os números voltam sem QR code novo depois do pagamento. |
| Logout no celular ou aparelho removido | Sim. É preciso parear de novo. |
| Parear outro número na conexão | Sim. É um pareamento novo. |
Quando o aquecimento recomeça, as contagens por minuto, hora e dia voltam do zero e a lista de contatos conhecidos é zerada: todos os contatos voltam a ser destinatários novos, mesmo que o número seja o mesmo.
É por isso que reconectar "para ver se resolve" é uma péssima ideia quando algo dá errado. Um novo pareamento deixa o número mais limitado, não menos. Os detalhes de como a sessão sobrevive a reinícios estão em sessão persistente, e o passo a passo do pareamento está no guia de conexão por QR code.
O que fazer nesses 14 dias
O aquecimento define o teto. O que você envia dentro dele é que constrói a reputação do número. Um roteiro que funciona para a maioria das integrações:
Primeiras 24 horas: só conversas em andamento
Use o número para responder quem escreve e para avisos que a pessoa está esperando naquele momento: o código do pedido que ela acabou de fazer, a confirmação do agendamento que ela acabou de marcar. Com 5 destinatários novos nas primeiras 6 horas e 10 até completar um dia, não há espaço para avisos em lote, e tudo bem.
Se você migrou o número de um celular que já era usado com clientes, lembre que, para a apiwpp, esses clientes contam como novos até trocarem uma mensagem com o número depois do pareamento. Uma resposta deles basta para virarem conhecidos.
Do 1º ao 7º dia: avisos transacionais para quem é cliente
Com 20 a 30 destinatários novos por dia, dá para mandar avisos transacionais para quem tem um motivo claro para recebê-los: pagamento confirmado, pedido enviado, lembrete de um horário marcado. Mande primeiro para quem já conversou com o número e deixe os demais para depois.
Mesmo com a fila cuidando do ritmo, vale evitar picos: distribua os avisos ao longo do horário comercial em vez de enfileirar tudo às 9h.
Do 7º ao 14º dia: aproximando do ritmo normal
Na última etapa o número já envia até 200 mensagens por dia, o mesmo teto diário do ritmo normal, com até 50 destinatários novos. É a hora de ligar os fluxos recorrentes da sua integração e observar: se aparecerem bloqueios temporários de novas conversas, o problema é o público ou o conteúdo, não o volume.
Em todas as etapas
- Envie para quem pediu. Lista comprada ou raspada gera denúncia em qualquer fase, e no aquecimento o estrago é maior.
- Verifique os números antes. A rota
POST /connections/{id}/contacts/checkconfere até 100 números de uma vez. Enviar para quem não tem WhatsApp falha comnot_on_whatsappe só gasta tentativa. Veja verificação de números. - Varie o texto. Templates com variáveis, como
{{nome}}e{{pedido}}, fazem cada mensagem ser daquela pessoa. - Ofereça uma saída. Uma linha como "responda SAIR para não receber mais avisos" evita que a pessoa use o botão de denúncia.
Acompanhe o aquecimento pela API
A rota GET /connections/{id}/queue mostra a fila do número, os limites que valem agora, o uso atual e o estado do aquecimento. Ela exige uma chave com o escopo connections:read:
curl https://api.apiwpp.com/connections/$ID/queue \
-H "Authorization: Bearer $APIWPP_KEY"
Um número no segundo dia de aquecimento responderia algo assim:
{
"pending": 2,
"scheduled": 5,
"limits": { "perMinute": 1, "perHour": 20, "perDay": 100, "newRecipientsPerDay": 20 },
"usage": { "minute": 0, "hour": 8, "day": 31, "newRecipients": 12 },
"warmup": {
"createdAt": 1788364800000,
"messagesSent": 64,
"isInWarmup": true,
"endsAt": 1789574400000
}
}
Os campos que interessam:
limitssão os tetos em vigor, já com a etapa do aquecimento aplicada. Depois dos 14 dias, voltam aos valores normais.usage.newRecipientsé quantos destinatários novos o número alcançou nas últimas 24 horas.warmup.isInWarmupdiz se o número ainda está aquecendo, ewarmup.endsAt(Unix em milissegundos) diz quando o aquecimento termina, 14 dias depois do pareamento emwarmup.createdAt.
Com isso a sua integração pode decidir antes de enviar. O exemplo abaixo, em TypeScript com fetch, adia um aviso para um contato novo quando o teto do dia já foi usado e trata o 429 com Retry-After quando a vaga acaba entre a consulta e o envio:
const API = 'https://api.apiwpp.com'
const headers = {
Authorization: `Bearer ${process.env.APIWPP_KEY}`,
'Content-Type': 'application/json',
}
type Outcome = { queued: true; jobId: string } | { queued: false; retryAfterSeconds: number }
export async function sendToNewContact(connectionId: string, to: string, message: string, clientRef: string): Promise<Outcome> {
const queue = await fetch(`${API}/connections/${connectionId}/queue`, { headers }).then((res) => res.json())
const cap = queue.limits.newRecipientsPerDay
if (cap !== null && queue.usage.newRecipients >= cap) {
// No slot for a new recipient right now: reschedule on your side.
return { queued: false, retryAfterSeconds: 60 * 60 }
}
const res = await fetch(`${API}/connections/${connectionId}/send`, {
method: 'POST',
headers,
body: JSON.stringify({ to, message, clientRef }),
})
if (res.status === 429) {
return { queued: false, retryAfterSeconds: Number(res.headers.get('Retry-After') ?? 3600) }
}
if (!res.ok) throw new Error(`send failed: ${res.status} ${await res.text()}`)
const { jobId } = await res.json()
return { queued: true, jobId }
}
O clientRef garante que repetir a chamada depois de um erro de rede não duplica a mensagem: a API devolve o envio original com "duplicate": true. Mais exemplos de envio e de webhook em Node.js estão na página de integração com Node.js.
Vale também guardar os eventos connection.status que chegam pelos webhooks. Eles mostram quando a conexão abriu, quando fechou e por quê (logged_out indica que será preciso parear de novo, e com isso o aquecimento recomeça), e avisam o bloqueio temporário de novas conversas com o motivo reachout_timelock.
Erros comuns nos primeiros 14 dias
Quase todo número restringido na primeira semana passa por um destes erros:
- Dividir uma lista grande entre vários números novos. Cada número tem o próprio aquecimento, então a soma parece caber. Mas a mesma lista fria multiplicada por vários números só multiplica as denúncias.
- Parear de novo para "zerar" um problema. Um novo pareamento recomeça o aquecimento e apaga os contatos conhecidos. O número volta à etapa mais restrita.
- Ignorar o
429. Repetir o envio em loop quando o teto de destinatários novos foi atingido não faz a mensagem sair antes. Respeite oRetry-Afterou reagende no seu sistema. - Esperar entrega imediata. A fila não é tempo real. Durante o aquecimento, com poucos envios por hora, um aviso pode sair bem depois da chamada. Use o
scheduledAtpara saber quando. - Testar só com números da equipe. Eles viram contatos conhecidos logo e não mostram como o número se comporta com clientes. Faça um piloto pequeno com clientes reais que esperam a mensagem.
Para o quadro completo do que leva a uma restrição, o guia sobre como evitar o bloqueio do número cobre ritmo, conteúdo e o que fazer quando algo dá errado. Se a ideia era usar o número para campanhas em volume, leia antes o texto sobre disparo em massa.
Como começar hoje
- Escolha o número e conecte uma única vez, por QR code ou código de pareamento. Evite trocar de aparelho conectado nos próximos 14 dias.
- Separe na sua base quem já conversa com o número e quem nunca falou com ele, e comece pelos primeiros.
- Consulte
GET /connections/{id}/queueantes de enviar avisos em lote e respeitelimitseusage.newRecipients. - Trate o
429comnew_recipient_cap_reachedno seu sistema, usando oRetry-After, e envie sempre com umclientRef. - Registre os eventos
connection.statuspara saber quando um novo pareamento vai recomeçar o aquecimento. - Crie sua conta na apiwpp e conecte o primeiro número: são 7 dias de teste com os recursos PRO. Os valores por número estão em preços.
Perguntas frequentes
Quanto tempo dura o aquecimento de um número na apiwpp?
O aquecimento dura 14 dias contados a partir do pareamento. Nesse período os limites por hora, por dia e de destinatários novos sobem em cinco etapas. Depois disso valem os limites normais da fila.
Posso desligar o aquecimento para enviar mais no começo?
Não. O aquecimento vale para todo número recém-pareado, em qualquer plano, porque é justamente o período em que o risco de restrição é maior. Não há cobrança por mensagem: o limite existe para proteger o número.
Reiniciar ou desconectar o número recomeça o aquecimento?
Não. Quedas de rede, reinícios dos servidores e a desconexão pela API mantêm a sessão salva e o relógio do aquecimento. Só um novo pareamento, como depois de um logout no celular ou ao conectar outro número, recomeça o aquecimento e zera os contatos conhecidos.
Meus clientes antigos contam como destinatários novos?
Contam até trocarem uma mensagem com o número depois do pareamento atual. Quando o cliente escreve para o número ou recebe uma mensagem dele, passa a ser conhecido por 28 dias. Responder quem escreveu nunca é barrado pelo teto de destinatários novos.
O que acontece quando o número atinge o limite da etapa?
Se for o limite por hora ou por dia, a fila agenda o envio para a próxima vaga e a resposta 202 traz o horário previsto em scheduledAt. Se for o teto de destinatários novos, a API responde 429 com new_recipient_cap_reached e o cabeçalho Retry-After, sem colocar nada na fila.
O aquecimento garante que meu número não será bloqueado?
Não. Ele reduz o risco, mas quem decide é o WhatsApp, e nenhuma ferramenta pode garantir que um número nunca será restringido. O que mais protege o número é enviar para quem espera a mensagem e oferecer sempre uma forma de sair.
Leia também: