Como aquecer um número novo na API não oficial do WhatsApp

Aquecer um número novo na API não oficial do WhatsApp é dar a ele histórico antes de colocá-lo em produção: perfil completo, conversas reais nos dois sentidos e volume que cresce aos poucos, ao longo de algumas semanas. Número recém-criado enviando como número antigo é um dos sinais mais fortes de spam; número aquecido, falando com quem pediu, tem risco de bloqueio muito baixo.

Este guia traz um plano semana a semana, os endpoints para deixar o perfil pronto e um cuidado que pega muita gente: mensagens interativas não aparecem para contato frio.

A camada não oficial não é afiliada, endossada ou suportada pelo WhatsApp ou pela Meta. O uso é de responsabilidade de quem envia.

Por que número novo precisa de aquecimento

Pense no que um spammer faz: compra um chip, conecta, dispara até cair, compra outro. O anti-spam aprendeu esse padrão, então todo número sem histórico começa com pouca confiança. Não é punição; é ausência de reputação.

Reputação se constrói com o que números legítimos fazem naturalmente:

• têm foto, nome e recado;
• recebem mensagens, não só enviam;
• conversam com gente que os tem salvos;
• crescem de uso aos poucos.

Nenhuma camada técnica substitui isso. A anti-detecção da WAME cuida para a conexão não parecer robô, mas a reputação do número é construída pelo uso.

Antes do primeiro envio: o número em si

Algumas escolhas facilitam o caminho:

• Chip ativo e com titular. Número que recebe SMS e ligação, de uma operadora comum.
• Instalado no celular primeiro. Crie a conta no app do WhatsApp (ou WhatsApp Business), use por alguns dias como qualquer pessoa usaria, e só depois conecte à API como aparelho.
• Um número, um propósito. Não reaproveite número que já foi restrito.

Depois disso, conecte a instância por QR Code ou código de pareamento:

curl -X POST "https://us.api-wa.me/SUA_KEY/instance"

Perfil completo pela API

Perfil vazio é característica de número descartável. Complete os três campos por código — útil também quando você provisiona números para vários clientes:

# Nome de exibição
curl -X PUT "https://us.api-wa.me/SUA_KEY/instance/profile/name" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Clínica Sorriso — Atendimento" }'

# Foto (link público, de preferência quadrada)
curl -X PUT "https://us.api-wa.me/SUA_KEY/instance/profile/picture" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://seusite.com.br/logo-quadrado.png" }'

# Recado
curl -X PUT "https://us.api-wa.me/SUA_KEY/instance/status" \
  -H "Content-Type: application/json" \
  -d '{ "text": "Atendimento de seg. a sex., 8h às 18h" }'

Mais detalhes sobre foto em trocar a foto do perfil pela API.

O plano semana a semana

Os números abaixo não são regra oficial do WhatsApp — ele não publica limites para a camada não oficial. São uma sugestão prática, conservadora, para você ajustar ao seu caso. O que importa é a direção: pouco, depois mais, sempre com conversa real.

Semana 1: presença e conversas de verdade

• Poucas dezenas de conversas por dia, no máximo.
• Priorize receber mensagens: coloque o número no site, na assinatura de e-mail, no link de atendimento (wa.me), e deixe os clientes chamarem.
• Responda tudo, com ritmo humano (digitando, pausa proporcional ao texto).
• Nada de comunicação ativa para contatos que nunca falaram com o número.

Semana 2: comunicação ativa com quem já conhece

• Comece a enviar para clientes que pediram: confirmação de pedido, lembrete de agendamento, retorno de orçamento.
• Aumente o volume gradualmente, dia a dia, sem saltos.
• Continue priorizando mensagens que geram resposta.

Semana 3: volume da operação, com fila

• Aproxime-se do volume normal da operação.
• Coloque os envios ativos numa fila com espaçamento, sem rajadas — veja fila, rate limit e retry.
• Observe: mensagens entregues e lidas, respostas, bloqueios.

Semana 4 em diante: manutenção

• Mantenha o padrão: comunicação para quem pediu, em horário comercial, com contexto.
• Mudanças grandes de volume (Black Friday, campanha) devem subir em degraus de alguns dias, não de uma vez.

Se em qualquer etapa aparecer sinal de problema — desconexões repetidas, entregas caindo, aviso no app —, volte um degrau e espere. Os sinais estão em como saber se o número está em risco.

Contato frio e mensagens interativas

Existe um comportamento do WhatsApp que parece bug e não é: botões e listas não aparecem no celular do destinatário quando são a primeira mensagem de uma conversa que nunca existiu. O envio dá certo, o texto simples chegaria, mas o menu interativo simplesmente não é exibido.

É uma proteção do app de quem recebe contra mensagem interativa não solicitada. A saída é aquecer a conversa: basta que já exista uma mensagem normal antes, seja do cliente ou sua.

Um texto seu já basta — não precisa esperar o cliente responder. Por isso, desenhe todo fluxo que começa do seu lado para abrir com texto e só depois mandar o menu:

const API = 'https://us.api-wa.me/SUA_KEY';
const post = (path, body) => fetch(`${API}${path}`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify(body),
});

// 1) Abre a conversa com contexto
await post('/message/text', {
  to: '5511999999999',
  text: 'Oi, Carla! Aqui é da Clínica Sorriso sobre sua consulta de quinta.',
});

// 2) Depois, o menu
await post('/message/button_reply', {
  to: '5511999999999',
  header: { title: 'Consulta' },
  text: 'Você confirma quinta às 14h?',
  buttons: [
    { type: 'quick_reply', id: 'sim', text: 'Confirmo' },
    { type: 'quick_reply', id: 'remarcar', text: 'Remarcar' },
  ],
});

O que atrapalha o aquecimento

• Grupos de aquecimento entre chips. Conversas artificiais entre números seus não criam o histórico que importa (contato real que responde) e criam um padrão próprio, fácil de identificar.
• Lista comprada. Esquente com ela e você só vai acelerar as denúncias. A WAME não apoia spam — a base tem que ser de quem pediu.
• Adicionar gente em grupo sem pedir. Em número novo, é um dos jeitos mais rápidos de ser denunciado.
• Mensagens idênticas. Mesmo com clientes reais, personalize.
• Pressa. Pular da semana 1 para o volume pleno desfaz o trabalho.

Validar antes de falar

Parte do aquecimento é não desperdiçar envio com número que nem tem WhatsApp. Antes de mandar para um contato novo da sua base, confira:

curl "https://us.api-wa.me/SUA_KEY/actions/registered?number=5511999999999"

O uso completo, inclusive na hora do cadastro, está em verificar se um número tem WhatsApp.

E número que já existe?

Se você vai conectar um número que já usa há anos no celular, com contatos e conversas reais, ele já tem histórico. O cuidado aqui é outro: não mudar o padrão de uso de repente. Se o número respondia poucos clientes por dia, não passe a falar com centenas de pessoas novas na semana em que conectou à API. Suba em degraus, como no plano acima.

Conclusão

Aquecer número não tem segredo, tem paciência: perfil completo, conversas reais nos dois sentidos, comunicação ativa só para quem pediu e volume que cresce em degraus. A WAME cuida da parte técnica — identidade de dispositivo, ritmo, reconexão e pausa quando o número dá sinal de risco. Com as duas partes, um número novo chega à produção com risco de bloqueio muito baixo. Os endpoints de perfil e mensagem estão na documentação.