Pular para o conteúdo
apiwpp

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.

Equipe apiwpp · 13 min de leitura

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 pareamentoPor horaPor diaDestinatários novos em 24 h
Até 6 horas5205
De 6 a 24 horas105010
De 1 a 3 dias2010020
De 3 a 7 dias3015030
De 7 a 14 dias4520050
Envios por dia e destinatários novos em cada etapa dos 14 dias de aquecimento.

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 202 do envio já traz o position e o scheduledAt, 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 429 com new_recipient_cap_reached e 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çãoO aquecimento recomeça?
Queda de rede, reinício ou atualização dos servidoresNão. A sessão fica salva e a conexão volta sozinha.
Desconectar pela API e reconectar depoisNão. A sessão continua guardada e não pede QR code novo.
Fatura atrasada que suspende a contaNão. Os números voltam sem QR code novo depois do pagamento.
Logout no celular ou aparelho removidoSim. É preciso parear de novo.
Parear outro número na conexãoSim. É 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/check confere até 100 números de uma vez. Enviar para quem não tem WhatsApp falha com not_on_whatsapp e 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:

  • limits sã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.isInWarmup diz se o número ainda está aquecendo, e warmup.endsAt (Unix em milissegundos) diz quando o aquecimento termina, 14 dias depois do pareamento em warmup.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:

  1. 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.
  2. 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.
  3. 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 o Retry-After ou reagende no seu sistema.
  4. 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 scheduledAt para saber quando.
  5. 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

  1. 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.
  2. Separe na sua base quem já conversa com o número e quem nunca falou com ele, e comece pelos primeiros.
  3. Consulte GET /connections/{id}/queue antes de enviar avisos em lote e respeite limits e usage.newRecipients.
  4. Trate o 429 com new_recipient_cap_reached no seu sistema, usando o Retry-After, e envie sempre com um clientRef.
  5. Registre os eventos connection.status para saber quando um novo pareamento vai recomeçar o aquecimento.
  6. 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:

Conecte seu primeiro número hoje.

7 dias grátis, sem cartão de crédito.