Boas práticas de envio

​

Perfil completo

• 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

​

Pense como o WhatsApp Web: múltiplas conexões por número

• ❌ 1 instância atendendo sozinha 400 conversas/dia → parece um robô.
• ✅ 4 instâncias do mesmo número atendendo 100 conversas/dia cada → parece uma equipe de 4 atendentes humanos usando o WhatsApp Web.

​

Peça para ser adicionado nos contatos

“Para garantir que nossas mensagens cheguem sempre, salve este número nos seus contatos.”

​

Cadência entre mensagens

​

Janela humana: 1 conversa por vez por instância

1. Chega uma mensagem.
2. Já existe uma janela ativa nessa instância?
   • Sim → enfileira o contato e responde com uma mensagem de espera.
   • Não → abre a janela para esse contato e responde normalmente.
3. Ao fim da janela (ou quando o assunto se resolve), pega o próximo da fila.

​

Presença em paralelo é veneno

# 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
  }'

​

Por que paralelizar presença entrega o bot

// ❌ NÃO faça isso: dispara "Digitando..." para todos de uma vez
await Promise.all(
  contacts.map(async (contact) => {
    await setPresence(contact.phone, 'typing'); // todos "digitando" juntos
    await sendMessage(contact.phone, contact.text);
  }),
);

// ✅ Serializa: só começa a "digitar" para o próximo quando o atual termina
async function setPresence(phone, status) {
  await fetch(`https://api.zapsterapi.com/v1/wa/instances/SUA_INSTANCIA/presence`, {
    method: 'PATCH',
    headers: {
      Authorization: 'Bearer SEU_TOKEN',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      recipient: phone,
      status,
      // mantém "Digitando..." até a mensagem sair de fato
      duration_strategy: 'until_next_message',
    }),
  });
}

for (const contact of contacts) {
  await setPresence(contact.phone, 'typing');
  await sendMessage(contact.phone, contact.text);
  await new Promise((r) => setTimeout(r, 45000)); // intervalo entre conversas
}

​

Use o dispositivo original regularmente

• 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

​

Personalize as mensagens

Olá! Temos uma promoção especial para você. Acesse nosso site.

Olá João! Vi que você se interessou pelo plano Pro na semana passada.
Ainda está avaliando? Posso te ajudar com alguma dúvida.

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

“Se não quiser mais receber nossas mensagens, responda SAIR.”

​

Higienização de contatos

• Use o endpoint de verificação de destinatário para checar se o número tem WhatsApp
• Remova números que não respondem há meses
• Remova números que pediram opt-out
• Remova duplicatas

​

Horários de envio

​

O que fazer se receber restrição

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

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

​

Auto-auditoria do workflow (regra 80/20)

• Quantas instâncias eu mantenho por número? Estou usando o modelo do WhatsApp Web (até 4 dispositivos) ou sobrecarregando uma só?
• Meu agente/bot responde várias conversas em paralelo? Ou trata uma de cada vez?
• Tenho controle de concorrência (fila, lock, debounce por contato)? Ou tudo dispara ao mesmo tempo?
• Onde eu envio presence: typing? Está serializado por instância ou paralelo?
• Qual o intervalo médio entre envios para o mesmo contato?
• Meu volume diário bate com “X atendentes humanos trabalhando das 9h às 18h”? Ou só faz sentido se fosse um robô?

​

Checklist rápido

• 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…”)?
• Tenho múltiplas instâncias por número para distribuir as conversas?
• A presença (“Digitando…”) está serializada (uma por vez), nunca em paralelo?
• Tenho debounce por contato (uma janela por vez, sem atender tudo simultaneamente)?
• 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

• Sobre os dispositivos associados no WhatsApp Business
• Como vincular vários dispositivos a um número (recurso multidispositivo)
• Sobre contas banidas no WhatsApp
• Sobre restrições temporárias no WhatsApp
• Sobre mensagens de segurança no WhatsApp