Disparo em massa no WhatsApp: por que números são bloqueados e o que fazer
Por que disparo em massa para listas frias derruba números no WhatsApp, o que usar no lugar e como enviar avisos recorrentes com opt-in, LGPD e opt-out.
Você tem uma planilha com milhares de telefones, uma mensagem pronta e uma API que envia pelo WhatsApp. A conta parece simples: um laço, uma requisição por linha e a campanha está no ar. Quem já tentou sabe como costuma terminar: o número para de entregar, aparece um bloqueio temporário e, em pouco tempo, a sessão cai de vez.
O problema não é a API, nem o horário, nem o texto. É o formato. O WhatsApp foi feito para conversas entre pessoas que se conhecem, e um disparo em massa para quem nunca falou com o número é exatamente o comportamento que os sistemas antispam dele procuram.
Este guia explica por que isso acontece, qual é a posição da apiwpp sobre disparos, o que usar no lugar e como montar uma comunicação recorrente (avisos de cobrança, lembretes, novidades para clientes) que cabe nos limites e respeita a LGPD.
O que é disparo em massa e por que ele derruba números
Disparo em massa é o envio da mesma mensagem, ou de variações mínimas dela, para uma lista grande de contatos de uma só vez. O termo cobre coisas muito diferentes, e a diferença decide o destino do número:
- Lista fria: telefones comprados, raspados de sites, herdados de outra empresa ou coletados sem que a pessoa soubesse que receberia mensagens por WhatsApp.
- Base com opt-in: clientes que deixaram o número num cadastro, numa compra ou num atendimento e aceitaram receber aquele tipo de aviso.
Com uma lista fria, quase todo destinatário é um desconhecido do número, e muitos reagem da forma mais natural: bloqueiam, apagam a conversa sem responder ou tocam em "denunciar". Cada uma dessas reações conta contra o número. Uma campanha para alguns milhares de contatos frios gera essas reações todas de uma vez, e o WhatsApp não precisa de muito mais para agir.
Há ainda os sinais de comportamento, que valem mesmo antes de qualquer denúncia: um aparelho recém-conectado que já começa enviando muito, dezenas de conversas novas por hora e mensagens saindo em intervalos idênticos não se parecem com uma pessoa usando o celular.
| Lista fria | Base com opt-in | |
|---|---|---|
| Quem recebe | Desconhecidos do número | Clientes que pediram o contato |
| Reação típica | Bloqueio, denúncia, conversa apagada | Leitura, resposta, clique |
| Conta como conversa nova | Quase todos os envios | Só quem não falou com o número recentemente |
| Base legal na LGPD | Difícil de sustentar | Consentimento ou legítimo interesse, conforme o caso |
| Risco para o número | Alto | Muito menor, com ritmo adequado |
Nada disso é exclusivo das APIs não oficiais. O mesmo número, operado à mão com o mesmo comportamento, teria o mesmo destino. A diferença é que uma integração consegue repetir o erro milhares de vezes em poucos minutos. O guia sobre como evitar o bloqueio do número detalha cada um desses sinais.
Por que a apiwpp não é uma ferramenta de disparo
A apiwpp conecta o número pelo protocolo do WhatsApp Web, como um aparelho conectado. Não é a API oficial da Meta, não tem selo verde nem aprovação de templates, e o número fica sujeito às mesmas regras de qualquer usuário. Por isso ela foi desenhada para conversar com quem espera a mensagem, e não para campanhas frias.
Na prática, cada número tem uma fila com ritmo anti-bloqueio com estes limites padrão:
- 3 mensagens por minuto, 60 por hora e 200 por dia;
- um intervalo aleatório de 3 a 8 segundos entre dois envios;
- pelo menos 30 segundos entre duas mensagens para o mesmo destinatário;
- no máximo 100 destinatários novos a cada 24 horas.
Destinatário novo é quem não trocou nenhuma mensagem com o número nos últimos 28 dias, contados depois do pareamento atual. Passado o teto, a API não enfileira nada e responde na hora:
HTTP/1.1 429 Too Many Requests
Retry-After: 3600
{
"error": "new_recipient_cap_reached",
"message": "…"
}
O cabeçalho Retry-After traz os segundos até abrir uma vaga (o valor acima é só um exemplo). Contatos conhecidos nunca são barrados por esse teto, e grupos não contam.
Nos primeiros 14 dias depois de conectar, o número ainda passa pelo aquecimento: começa com 20 envios por dia e 5 destinatários novos, e só chega aos limites normais na última etapa. Se, mesmo assim, o WhatsApp aplicar o bloqueio temporário de novas conversas (o reach-out timelock), a apiwpp detecta, avisa pelo evento connection.status com o motivo reachout_timelock e para de tentar os envios até o prazo acabar, porque cada tentativa aprofundaria a restrição.
Esses limites não são um obstáculo a contornar. Com 100 destinatários novos por dia, uma lista fria de 10 mil nomes levaria mais de três meses, e o número dificilmente chegaria ao fim dela. A conta foi feita para que o disparo frio não compense. Mesmo com tudo isso, nenhuma ferramenta garante que um número nunca será restringido: quem decide é o WhatsApp. O que a fila faz é reduzir o risco para quem já usa o canal do jeito certo.
O que usar no lugar do disparo em massa
A pergunta certa não é "como enviar para todo mundo", e sim "o que eu quero que aconteça". Para cada objetivo existe um caminho que funciona melhor.
Mensagens transacionais para quem já é cliente
Confirmação de pedido, aviso de pagamento, código de rastreio, lembrete de consulta, fatura perto do vencimento. São mensagens que a pessoa espera, sobre algo que ela mesma fez, e que raramente geram denúncia. É o uso para o qual a apiwpp foi feita, e os casos de notificações de pedido e lembretes de agendamento mostram o fluxo completo.
Opt-in: construa a base em vez de comprar
Uma base própria cresce devagar, mas cada contato vale muito mais do que dez de uma lista comprada. Algumas formas de pedir o opt-in:
- No cadastro ou no checkout, com uma caixa específica para o WhatsApp e o tipo de aviso escrito por extenso ("avisos de pedido e de entrega"), sem vir marcada.
- Na primeira conversa, quando o próprio cliente escreve para o número: ele já iniciou o contato, e você pode perguntar se ele quer receber os próximos avisos por ali.
- Num link ou QR code no site, na loja ou na nota fiscal, que abre uma conversa com o número. Quem escreve primeiro já chega como contato conhecido.
Guarde no seu sistema quando, onde e para quê cada pessoa deu o opt-in. Essa informação é o que sustenta o envio perante a LGPD e o que permite respeitar a saída depois.
API oficial para campanhas de marketing em volume
Se o objetivo é marketing para uma base grande, com gente que não conversa com a empresa há muito tempo, o canal adequado é a Cloud API oficial da Meta. Ela tem categorias próprias para marketing, modelos aprovados, limites formais por número e cobrança por mensagem, com valores publicados na tabela oficial da Meta. O comparativo entre os dois modelos está em API oficial ou não oficial e na página apiwpp ou API oficial.
Nada impede usar os dois: a oficial para campanhas e a apiwpp para as conversas e avisos do dia a dia com clientes.
| Objetivo | Caminho indicado |
|---|---|
| Avisar o cliente sobre o que ele comprou ou agendou | Mensagem transacional pela apiwpp |
| Responder quem escreveu para o número | apiwpp, com resposta pelo seu sistema |
| Lembrete ou aviso periódico para quem deu opt-in | apiwpp, com envio distribuído ao longo dos dias |
| Campanha de marketing para uma base grande | Cloud API oficial da Meta |
| Falar com quem nunca deu o número para você | Nenhum: comece pelo opt-in |
Como estruturar comunicação recorrente sem estourar limites
Avisos recorrentes, como fatura do mês ou lembrete de renovação, são legítimos e funcionam bem, desde que o envio seja planejado para o ritmo do número e não para o relógio de quem aperta o botão.
Faça a conta antes de agendar
Um detalhe muda o planejamento: o contato só é conhecido se trocou mensagem com o número nos últimos 28 dias. Num aviso mensal, o cliente que não respondeu o aviso anterior provavelmente volta a contar como destinatário novo, e o teto de 100 por 24 horas passa a valer para ele.
Veja um exemplo com 1.000 clientes que recebem o aviso de fatura uma vez por mês, num número fora do aquecimento:
- pelo limite diário, 200 envios por dia levariam 5 dias;
- se a maioria conta como destinatário novo, o teto de 100 por 24 horas estica isso para cerca de 10 dias.
A solução é distribuir o envio pelo próprio calendário do negócio: cada cliente recebe o aviso alguns dias antes do vencimento dele, em vez de todos no dia 1º. Quem vence no dia 10 recebe no dia 7, quem vence no dia 20 recebe no dia 17, e o volume diário fica naturalmente abaixo dos limites. Os casos de cobrança e de notificações transacionais usam o mesmo princípio.
Envie o lote do dia, não a base inteira
Em vez de colocar mil envios na fila de uma vez, consulte o estado do número e envie só o que cabe hoje. A rota GET /connections/{id}/queue devolve os limites em vigor (limits), o uso atual (usage) e quantos envios ainda aguardam (pending e scheduled). O exemplo usa o fetch nativo do Node.js e um template com variáveis criado antes pela rota de templates de mensagem:
const API = 'https://api.apiwpp.com'
const headers = {
Authorization: `Bearer ${process.env.APIWPP_KEY}`,
'Content-Type': 'application/json',
}
type Aviso = { clienteId: string; telefone: string; nome: string; vencimento: string }
export async function enviarLoteDoDia(connectionId: string, avisos: Aviso[], competencia: string) {
const fila = await fetch(`${API}/connections/${connectionId}/queue`, { headers }).then((r) => r.json())
// Conta conservadora: o que resta do dia, descontado o que já aguarda na fila
const vagas = Math.max(0, fila.limits.perDay - fila.usage.day - fila.pending - fila.scheduled)
const pendentes: Aviso[] = []
for (const [i, aviso] of avisos.entries()) {
if (i >= vagas) {
pendentes.push(aviso)
continue
}
const res = await fetch(`${API}/connections/${connectionId}/send`, {
method: 'POST',
headers,
body: JSON.stringify({
to: aviso.telefone,
template: 'aviso_vencimento',
variables: { nome: aviso.nome, vencimento: aviso.vencimento },
// Mesmo cliente, mesma competência: repetir nunca duplica a mensagem
clientRef: `fatura-${competencia}-${aviso.clienteId}`,
}),
})
if (res.status === 429) {
// new_recipient_cap_reached: nada foi enfileirado; o resto fica para amanhã
pendentes.push(...avisos.slice(i))
break
}
if (!res.ok) throw new Error(`Envio recusado: ${res.status}`)
}
return pendentes
}
O clientRef é o que torna esse lote seguro para rodar de novo: se o processo cair no meio e o agendador repetir, a API responde 200 com "duplicate": true para quem já estava na fila, em vez de mandar o mesmo aviso duas vezes. Receber a mesma cobrança em dobro é um convite para a denúncia. A lista avisos já deve chegar filtrada: só quem deu opt-in e não pediu para sair.
Cuide do número, não só da fila
- Não comece a rotina num número recém-conectado. Nos 14 dias de aquecimento os limites são menores; use esse período para conversar com quem já fala com o número.
- Não divida uma lista fria entre vários números. Isso só multiplica as denúncias. Vários números fazem sentido quando atendem públicos ou funções diferentes, como uma filial ou um setor, cada um com a própria fila.
- Respeite o horário. Agende avisos não urgentes para o horário comercial.
- Acompanhe os eventos.
message.send_failedavisa quando um envio comclientRefnão vai acontecer, econnection.statuscomreachout_timelocké o alarme para parar e revisar a rotina.
LGPD e opt-out: ofereça a saída e respeite
A Lei Geral de Proteção de Dados (Lei 13.709/2018) trata o telefone de uma pessoa como dado pessoal. Para usá-lo em mensagens, você precisa de uma base legal, como o consentimento ou, conforme o caso, o legítimo interesse, e o titular pode revogar o consentimento e pedir para não receber mais contatos. A política de mensagens para empresas do WhatsApp vai na mesma linha: pede opt-in e que os pedidos de saída sejam respeitados. Isto não é aconselhamento jurídico; na dúvida, fale com quem cuida da proteção de dados na sua empresa.
Na apiwpp, quem define para quem enviar é você, que responde como controlador dos dados dos seus contatos, como descrevem os termos de uso. A parte prática cabe em três regras:
- Diga como sair. Uma linha no fim do aviso, como "responda SAIR para não receber mais estas mensagens", custa pouco e evita que a pessoa use o botão de denúncia.
- Registre a saída na hora. O pedido chega no seu webhook como
message.incoming; grave o contato numa lista de exclusão. - Filtre antes de cada envio. Toda rotina consulta a lista de exclusão antes de chamar a API, inclusive as que outra equipe escreveu.
Um endpoint em Express que verifica a assinatura HMAC do webhook e registra o pedido de saída:
import { createHmac, timingSafeEqual } from 'node:crypto'
import express from 'express'
import { listaDeExclusao } from './lista-de-exclusao' // o seu repositório
const SECRET = process.env.WHATSAPP_WEBHOOK_SECRET
if (!SECRET) throw new Error('WHATSAPP_WEBHOOK_SECRET não está definido')
const PEDIDO_DE_SAIDA = /^\s*(sair|parar|cancelar)\s*[.!]*\s*$/i
function assinado(rawBody: Buffer, timestamp?: string, signature?: string) {
if (!timestamp || !/^\d+$/.test(timestamp) || !signature) return false
if (Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) return false
const mac = createHmac('sha256', SECRET!).update(`${timestamp}.`).update(rawBody).digest('hex')
const esperado = Buffer.from(`sha256=${mac}`)
const recebido = Buffer.from(signature)
return esperado.length === recebido.length && timingSafeEqual(esperado, recebido)
}
const app = express()
app.post('/webhooks/whatsapp', express.raw({ type: 'application/json' }), async (req, res) => {
if (!assinado(req.body, req.get('X-Sales-Timestamp'), req.get('X-Sales-Signature'))) {
return res.sendStatus(401)
}
const evento = JSON.parse(req.body.toString('utf8'))
const { type, tenantId, data } = evento
const individual = type === 'message.incoming' && !data.jid.endsWith('@g.us')
if (individual && PEDIDO_DE_SAIDA.test(data.body ?? '')) {
// Idempotente: registrar a mesma saída duas vezes não muda nada.
// phone vem null quando o remetente chegou só com LID: guarde também o jid.
await listaDeExclusao.registrar({ projeto: tenantId, telefone: data.phone, jid: data.jid })
}
res.sendStatus(200)
})
app.listen(3000)
Alguns detalhes desse código importam. A assinatura é calculada sobre o corpo bruto, por isso a rota usa express.raw em vez de um parser de JSON. A entrega é pelo menos uma vez, então o mesmo evento pode chegar de novo, e o registro precisa aceitar repetição. E mensagens de grupo chegam com o jid do grupo, por isso o exemplo só trata conversas individuais. Quando o remetente chega só com um identificador LID, o phone vem null; o evento contact.resolved informa o telefone depois, e aí você completa o registro. Se quiser confirmar a saída com uma resposta curta, ela vai para quem acabou de escrever, que é um contato conhecido. O guia de webhooks do WhatsApp mostra o envelope completo e a mesma verificação em PHP.
Como começar hoje
- Separe a sua base em dois grupos: quem deu opt-in e quem não deu. Não envie nada para o segundo grupo; convide essas pessoas a escrever para o número por outros canais.
- Crie uma lista de exclusão e um endpoint de webhook que registre pedidos de saída, como no exemplo acima.
- Transforme o texto da campanha em um template com variáveis e inclua a linha de saída no fim.
- Passe os telefones por
POST /connections/{id}/contacts/check, em lotes de até 100, e marque quem não tem WhatsApp. - Distribua os avisos recorrentes pelas datas de vencimento ou de agendamento, com um
clientRefestável por cliente e competência. - Se o que você precisa é marketing em volume para quem não conversa com a empresa, avalie a API oficial da Meta para essa parte.
- Crie sua conta na apiwpp e conecte o primeiro número para os avisos do dia a dia. Os valores por número estão em preços.
Perguntas frequentes
Dá para fazer disparo em massa com a apiwpp?
Não para listas frias. A fila de cada número limita o ritmo a 200 mensagens por dia e a 100 destinatários novos a cada 24 horas por padrão, justamente para impedir esse uso. Para avisos a clientes que deram opt-in, distribuídos ao longo dos dias, ela funciona bem.
Por que números que fazem disparo em massa são bloqueados?
Porque o disparo frio reúne os sinais que o WhatsApp usa para identificar spam: muitas conversas novas com desconhecidos, envio em ritmo mecânico e denúncias de quem recebe. Quanto maior a lista, mais denúncias chegam ao mesmo tempo. O resultado costuma ser um bloqueio temporário de novas conversas e, depois, a perda do número.
Usar vários números em paralelo resolve?
Não. Dividir a mesma lista fria entre vários números só espalha as denúncias e coloca todos eles em risco. Cada número tem a própria fila e o próprio aquecimento, e deve ser usado para conversar com quem espera aquele contato.
Qual é a alternativa para campanhas de marketing em volume?
A Cloud API oficial da Meta, que tem categoria própria para marketing, modelos aprovados e cobrança por mensagem conforme a tabela da Meta. Ela pode conviver com a apiwpp: a oficial para campanhas, a apiwpp para avisos e conversas com clientes.
Preciso de opt-in para enviar avisos pelo WhatsApp?
Você precisa de uma base legal para usar o telefone da pessoa, e o consentimento é a mais clara para mensagens por WhatsApp. Guarde quando e para quê cada contato aceitou receber avisos. Isto não é aconselhamento jurídico: confirme o seu caso com quem cuida da proteção de dados na empresa.
Como tratar quem pede para sair da lista?
Ofereça uma forma simples, como responder SAIR, e registre o pedido assim que o evento message.incoming chegar no seu webhook. Toda rotina de envio deve consultar essa lista de exclusão antes de chamar a API. Respeitar a saída protege a pessoa e também o número, porque evita a denúncia.
Leia também: