Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://developer.zapsterapi.com/llms.txt

Use this file to discover all available pages before exploring further.

O WhatsApp usa algoritmos para detectar comportamento automatizado. Quando o sistema entende que um número está enviando mensagens de forma não natural, ele pode restringir ou banir o número. As boas práticas abaixo ajudam a manter seu número funcionando por mais tempo. A lógica é simples: quanto mais o seu uso se parecer com o de uma pessoa real, menor o risco de restrição.
Estas recomendações se aplicam principalmente a instâncias não oficiais (QR code). Instâncias WABA (oficiais) seguem as políticas da Meta diretamente e têm risco muito menor de banimento. Ainda assim, boas práticas de conteúdo e opt-in valem para os dois tipos.

​
Perfil completo

Preencha o perfil do WhatsApp Business com o máximo de informações possíveis:
  • Foto de perfil (logotipo ou foto profissional)
  • Nome comercial
  • Descrição do negócio
  • Endereço
  • Horário de funcionamento
  • E-mail de contato
  • Site
Um perfil completo aumenta a confiança do algoritmo no número. Perfis vazios ou incompletos são um sinal de conta descartável.
Ative o PIN de segurança (verificação em duas etapas) no WhatsApp. Além de proteger contra clonagem, indica para o sistema que é uma conta legítima que se preocupa com segurança.

​
Peça para ser adicionado nos contatos

Sempre que possível, peça ao destinatário que adicione o número da instância na agenda de contatos do celular. Quando alguém salva seu número, o WhatsApp entende que existe um relacionamento real entre vocês. Isso eleva o “score” do número e reduz a chance de que suas mensagens sejam marcadas como spam. Na prática, você pode incluir uma frase como:
“Para garantir que nossas mensagens cheguem sempre, salve este número nos seus contatos.”

​
Cadência entre mensagens

Não envie mensagens em rajada. O WhatsApp detecta envios em massa com facilidade. Recomendações de intervalo:
CenárioIntervalo mínimoIdeal
Envio para lista de contatos30 segundos45 a 60 segundos
Follow-up após interação10 segundos20 a 30 segundos
Respostas automáticas (chatbot)3 a 5 segundos5 a 10 segundos
Quanto maior o intervalo, melhor. Se você precisa enviar para 100 contatos, espere pelo menos 30 segundos entre cada envio. Isso significa que o lote leva cerca de 50 minutos pra finalizar. Parece lento, mas é o que mantém o número vivo.
Enviar mais de 1 mensagem por segundo para destinatários diferentes é um dos comportamentos que mais gera restrição. Evite sempre.

​
Use o endpoint de presença

Antes de enviar uma mensagem, use o endpoint de atualização de presença para simular o comportamento humano: 
# Simular "Digitando..." por 5 segundos antes de enviar
curl -X PATCH https://api.zapsterapi.com/v1/wa/instances/SUA_INSTANCIA/presence \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": "5511999999999",
    "status": "typing",
    "duration_strategy": "maximum_duration",
    "max_duration": 5
  }'
O destinatário vai ver “Digitando…” por 5 segundos antes de receber a mensagem. Isso faz o envio parecer mais natural, tanto para quem recebe quanto para o algoritmo. Para áudios, use "status": "recording" para mostrar “Gravando áudio…”. Você também pode usar "duration_strategy": "until_next_message" para manter o status ativo até que a mensagem seja enviada de fato. Isso funciona bem quando o tempo de processamento varia (como em respostas de IA).

​
Use o dispositivo original regularmente

A Meta desconecta dispositivos vinculados que ficam inativos por mais de 14 dias. Isso significa que se ninguém abrir o aplicativo do WhatsApp no celular original durante 14 dias, a conexão da instância pode cair. Recomendação: pelo menos uma vez por semana, abra o WhatsApp no celular onde o número está registrado. Não precisa fazer nada complexo:
  • Abrir o app
  • Navegar pelas conversas
  • Enviar uma mensagem para alguém (pode ser para você mesmo em outro número)
  • Verificar se tem atualizações pendentes do app
Esse uso periódico mantém o vínculo ativo e evita desconexões inesperadas.
Referência: Sobre os dispositivos associados no WhatsApp Business

​
Personalize as mensagens

Mensagens idênticas enviadas para muitas pessoas são um dos sinais mais fortes de automação. O WhatsApp compara o conteúdo das mensagens enviadas por um número e detecta padrões repetitivos. Ruim: 
Olá! Temos uma promoção especial para você. Acesse nosso site.
(mesma mensagem para 200 pessoas) Bom: 
Olá João! Vi que você se interessou pelo plano Pro na semana passada.
Ainda está avaliando? Posso te ajudar com alguma dúvida.
(mensagem personalizada com nome e contexto) Na API da Zapster, você monta a mensagem dinamicamente no seu código antes de enviar. Cada request ao POST /v1/wa/messages pode ter um texto diferente: 
const contacts = [
  { phone: '5511999999999', name: 'João', interest: 'plano Pro' },
  { phone: '5511888888888', name: 'Maria', interest: 'integração N8n' },
];

for (const contact of contacts) {
  await fetch('https://api.zapsterapi.com/v1/wa/messages', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer SEU_TOKEN',
      'X-Instance-ID': 'SUA_INSTANCIA',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      recipient: contact.phone,
      text: `Olá ${contact.name}! Vi que você se interessou por ${contact.interest}. Posso te ajudar?`,
    }),
  });

  // Esperar entre envios
  await new Promise(r => setTimeout(r, 45000)); // 45 segundos
}

​
Opt-in e opt-out

Envie mensagens apenas para quem deu consentimento. Pessoas que não esperam receber suas mensagens vão denunciar como spam, e isso derruba o score do número rapidamente. Opt-in: Tenha alguma forma de consentimento antes de enviar. Pode ser um formulário no site, uma confirmação por e-mail, ou uma interação prévia no próprio WhatsApp. Opt-out: Sempre dê a opção de parar de receber mensagens. Inclua algo como:
“Se não quiser mais receber nossas mensagens, responda SAIR.”
E respeite quando alguém pedir para sair. Continuar enviando para quem pediu para parar é o caminho mais rápido para restrição.

​
Higienização de contatos

Antes de enviar para uma lista, verifique se os números são válidos: Enviar para números inválidos ou inativos gera falhas silenciosas que o WhatsApp contabiliza negativamente.

​
Horários de envio

Enviar mensagens de madrugada ou em horários estranhos gera mais denúncias. Prefira horários comerciais:
HorárioRecomendação
8h às 12hBom
12h às 14hAceitável (horário de almoço, taxa de leitura menor)
14h às 18hBom
18h às 20hAceitável
20h às 8hEvitar
Finais de semanaEvitar para mensagens comerciais
Com o recurso de mensagens agendadas, você pode preparar o envio fora do horário e deixar a Zapster disparar no momento certo.

​
O que fazer se receber restrição

Se o número for restrito temporariamente:
  1. Pare imediatamente de enviar mensagens automatizadas
  2. Espere o período de restrição passar (geralmente 24 a 48 horas)
  3. Volte devagar com volume reduzido e intervalos maiores
  4. Revise suas práticas antes de retomar o volume anterior
Se o número for banido permanentemente:
  1. O número não pode ser recuperado na maioria dos casos
  2. Considere migrar para uma instância WABA (oficial) que não tem esse risco
  3. Se precisar de um novo número não oficial, comece com volume baixo e siga todas as práticas acima desde o início

​
Checklist rápido

Use esta lista antes de iniciar um envio em volume:
  • O perfil do WhatsApp está completo (foto, descrição, endereço)?
  • Os destinatários deram consentimento para receber mensagens?
  • As mensagens estão personalizadas com nome ou contexto?
  • O intervalo entre envios é de pelo menos 30 segundos?
  • Estou usando o endpoint de presença (“Digitando…”)?
  • Os números da lista são válidos e ativos?
  • O horário de envio é dentro do horário comercial?
  • Tem opção de opt-out na mensagem?
  • Usei o app do WhatsApp no celular original esta semana?

​
Referências