O que é aquecimento de número (chip)
Aquecimento de número (ou de chip) é o período depois de conectar um WhatsApp em que os limites de envio começam baixos e sobem aos poucos, para o número ganhar histórico antes de chegar ao volume normal. Na apiwpp, ele dura 14 dias e é aplicado pela fila.
Atualizado em
Aquecimento de número, também chamado de aquecimento de chip, é o período logo depois de conectar um número de WhatsApp a um sistema em que ele envia pouco e aumenta o volume aos poucos. Em vez de sair de zero para centenas de mensagens no primeiro dia, o número começa com limites baixos, que sobem por etapas até chegar ao ritmo normal.
Por que o aquecimento existe
Um número que acabou de ser conectado e, no mesmo dia, começa a enviar muitas mensagens para gente que nunca falou com ele tem o comportamento típico de um robô. É o tipo de padrão que o WhatsApp observa com mais atenção, e que costuma terminar em restrição do número, sobretudo quando os destinatários denunciam as mensagens.
O aquecimento reduz esse risco de duas formas: segura o volume enquanto o número ainda não tem histórico e limita quantas pessoas novas ele alcança por dia. Nos primeiros dias, o que mais pesa a favor do número é conversar com quem já o conhece e responder às mensagens que recebe.
Um aviso honesto: o aquecimento reduz o risco, mas nada garante que um número nunca será restringido pelo WhatsApp. O conteúdo das mensagens e o consentimento de quem as recebe continuam fazendo diferença.
Os 14 dias de aquecimento na apiwpp
Na apiwpp você não controla isso na mão. Durante os 14 dias depois do pareamento, a fila de cada número aplica limites menores, que sobem em cinco etapas (valores padrão):
| 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 disso valem os limites normais: 3 envios por minuto, 60 por hora, 200 por dia e 100 destinatários novos a cada 24 horas. Destinatário novo é quem não trocou mensagem com o número nos últimos 28 dias, desde o pareamento atual. Quando esse limite estoura, o envio é recusado com 429 new_recipient_cap_reached e o cabeçalho Retry-After; os demais envios esperam na fila, com o horário previsto em scheduledAt.
O aquecimento pertence ao pareamento, não ao chip. Ele recomeça quando outro número é conectado ou quando o mesmo número volta depois de um logout. Quedas de rede e reinícios não reiniciam nada, porque a sessão do aparelho conectado fica guardada. O estado atual aparece no bloco warmup de GET /connections/{id}/queue.
A tabela completa e o acompanhamento pela API estão em aquecimento automático de número. O raciocínio por trás de cada etapa e o que fazer nesses dias estão no post aquecimento de número: por que os primeiros 14 dias importam.
Perguntas frequentes
Aquecimento de chip e aquecimento de número são a mesma coisa?
Sim. "Chip" é o nome popular, porque o número vem do chip do celular. Na apiwpp, porém, o que conta é o pareamento: o aquecimento começa quando o número é conectado e recomeça a cada novo pareamento, depois de um logout ou com outro número.
Posso pular o aquecimento?
Não. O aquecimento faz parte da proteção de cada número recém-conectado e é aplicado pela fila automaticamente, inclusive no teste grátis de 7 dias. Os limites da primeira semana já bastam para validar uma integração e mandar lembretes e confirmações.
Mensagens para quem já conversa comigo também são limitadas?
Elas seguem os limites por hora e por dia da etapa, mas nunca são barradas pelo limite de destinatários novos. Por isso, nos primeiros dias, vale priorizar clientes que já escreveram para o número.
Outros termos
Todos: Glossário →Aparelho conectado é um dispositivo extra ligado a uma conta de WhatsApp, como o WhatsApp Web, o aplicativo de desktop ou o servidor de uma API. Ele é pareado pelo celular uma vez e depois envia e recebe mensagens mesmo com o celular desligado.
QR code de pareamento é o código que o celular escaneia para ligar o número de WhatsApp a um aparelho conectado, como o WhatsApp Web ou uma API. Ele muda a cada poucos segundos e pode ser trocado por um código de 8 caracteres.
Uma operação é idempotente quando repeti-la tem o mesmo efeito que fazê-la uma vez. Em APIs, isso se consegue com uma chave de idempotência: o cliente manda o mesmo identificador em cada tentativa e o servidor reconhece a repetição em vez de executar de novo.