Disparo em Massa no WhatsApp com a API Oficial: Templates, Opt-in e Botões

Disparo em massa no WhatsApp com template e botões pela API oficial
Compartilhar este Post

O disparo em massa no WhatsApp é o envio de uma mesma campanha para muitos contatos que autorizaram receber mensagens pela API oficial do WhatsApp. Ele só é sustentável com opt-in comprovado, templates aprovados na categoria certa e um botão de saída visível.

Extensões e aplicativos não oficiais colocam o número em risco. Quem busca escala precisa combinar a automatização de atendimento com as regras da Meta sobre limites, qualidade e descadastro.

Disparo em massa no WhatsApp com template e botões pela API oficial
Campanha pela API oficial: opt-in comprovado, template aprovado e botão de saída visível.

Principais Conclusões

  • O disparo em massa no WhatsApp só é seguro pela API oficial, com opt-in que cite o nome da empresa e templates aprovados na categoria correta.
  • Botões de resposta rápida, URL e cupom facilitam a resposta com um toque, e uma saída visível ajuda a evitar bloqueios e denúncias, que derrubam a nota de qualidade.
  • A Meta controla o volume em várias camadas (limite do portfólio, pacing de templates novos e limite de marketing por usuário), e acompanhar os erros 131049 e 131050 evita envios desperdiçados.

O Que É Disparo em Massa no WhatsApp

Comparação entre envio não oficial e envio pela API oficial do WhatsApp

A expressão “disparo em massa” tem dois sentidos no mercado: um oficial, previsto pela Meta, e outro de risco, feito por automações sem autorização. Separar os dois é o primeiro passo de qualquer campanha.

Definição, Usos e Lista de Transmissão

No sentido oficial, o disparo em massa é o envio de templates (modelos) aprovados pela Meta para contatos com opt-in, fora da janela de atendimento de 24 horas. Pela visão geral de templates, eles são o único tipo de mensagem permitido fora dessa janela.

Os usos legítimos incluem promoções, repescagem de carrinho, lembretes de consulta e avisos transacionais, como confirmação de pedido. Cada uso se encaixa em uma das três categorias de template: marketing, utilidade ou autenticação.

A lista de transmissão do WhatsApp Business é outra coisa: é manual, depende do celular e tem alcance limitado. Na coexistência com a API, as listas de transmissão do app ficam apenas para leitura.

API Oficial x Ferramentas Não Oficiais

Extensões e aplicativos que automatizam o envio pelo WhatsApp comum violam os Termos de Serviço do WhatsApp e podem levar à suspensão do número. Os riscos, os tipos de bloqueio e a recuperação estão no guia sobre WhatsApp banido.

Pela API oficial, há limites claros, qualidade visível e descadastro previsto. A Política do WhatsApp Business exige opt-in antes do contato e o respeito a qualquer pedido de saída, dentro ou fora do WhatsApp, incluindo remover a pessoa da lista de contatos.

Com a coexistência, explicada no guia da API oficial, o número segue ativo no celular enquanto as campanhas saem pela API, e a equipe continua atendendo pelo app e pelo WhatsApp Web normalmente.

Nenhuma dessas medidas garante bloqueio zero, mas elas colocam a operação dentro das regras, reduzem o risco e dão indicadores, como a nota de qualidade e a pausa de templates, para corrigir a rota a tempo.

Opt-in e Consentimento para Campanhas no WhatsApp

Checklist do opt-in válido para campanhas no WhatsApp

Sem opt-in válido não existe disparo seguro. O consentimento é a primeira exigência da Meta para mensagens iniciadas pela empresa e uma das bases legais previstas na LGPD para campanhas de marketing.

Requisitos de um Opt-in Válido

Segundo as orientações da Meta sobre opt-in, o texto de consentimento precisa deixar claro que a pessoa aceita receber mensagens pelo WhatsApp e citar o nome da empresa. Um aceite genérico, sem canal definido, não cumpre essa exigência.

Um texto de opt-in bem escrito reúne três elementos:

  • Nome da empresa: a marca que vai enviar as mensagens aparece de forma explícita no aceite.
  • Canal WhatsApp: o texto menciona o WhatsApp, e não apenas “comunicações” em geral.
  • Tipo de mensagem: a pessoa sabe se vai receber promoções, avisos de pedido ou ambos.

Separar o opt-in por categoria, com promoções de um lado e avisos de pedido do outro, é uma boa prática que apoia a retenção de clientes. A Meta também alerta que baixa qualidade persistente gera limitação de envio e penalidades.

Onde Coletar e Como Registrar o Consentimento

Os canais aceitos pela Meta incluem SMS, site, URA ou atendimento telefônico, coleta presencial e formulário em papel. Como boa prática recomendada pela Meta, o aviso explica em todos eles como a pessoa pode sair da lista.

O registro do consentimento deve guardar data, origem e o texto exato aceito, junto do cadastro do contato. A integração com CRM facilita esse controle, porque serve tanto para provar o opt-in quanto para segmentar as campanhas depois.

Templates de Mensagem para Disparo em Massa

Anatomia de um template do WhatsApp: cabeçalho, corpo, rodapé e botões

Toda mensagem de campanha é um template aprovado. A estrutura e a categoria escolhidas definem se ele passa na revisão, quanto custa por entrega e como a Meta vai tratá-lo durante o envio.

Componentes, Limites e Formatos de Marketing

Conforme a documentação de componentes de template, só o corpo é obrigatório. Cabeçalho, rodapé e botões são opcionais, e as variáveis personalizam nome, pedido ou cupom de cada destinatário sem criar um template por pessoa.

ComponenteObrigatório?Limite
Cabeçalho (texto)Não60 caracteres
CorpoSim1.024 caracteres
RodapéNão60 caracteres
Rótulo do botãoNão25 caracteres

Os templates de marketing também têm formatos específicos, segundo a Meta: cupom, carrossel, oferta por tempo limitado, catálogo e produto. Na hora de comparar ferramentas de IA para WhatsApp, vale conferir quais desses formatos cada plataforma permite enviar.

Categorias e Recategorização

As regras de categorização da Meta tratam como marketing o template que mistura conteúdos, como atualização de pedido com promoção, o que é genérico (“{{1}}”, “Parabéns!”) e o que busca awareness, vendas, retargeting ou relacionamento.

Desde 16/04/2025, se a empresa já recebeu aviso de uso indevido, a troca de utilidade para marketing é instantânea. A revisão pode ser pedida em até 60 dias, mas a campanha já terá saído com o custo de marketing.

Por isso, avisos transacionais devem usar templates de utilidade “puros”, sem oferta embutida. Promoções, cupons e reativação de clientes ficam em templates de marketing, criados já na categoria correta desde o início.

Botões Interativos nas Campanhas

Template do WhatsApp com botões interativos e opção de descadastro
Template de campanha com botões interativos e uma opção de descadastro visível para o cliente.

Os botões transformam o disparo em conversa, porque o cliente responde com um toque. Eles também têm limites de quantidade e de compatibilidade que interferem no desenho da campanha.

Tipos e Quantidade de Botões

Um template aceita até 10 botões no total, e as respostas rápidas precisam ficar agrupadas. Cada tipo de botão tem um papel diferente na campanha:

  • Resposta rápida (até 10): qualifica o interesse, como “Quero saber mais” ou “Agora não”.
  • URL (até 2): leva à página da oferta, ao carrinho ou ao rastreio do pedido.
  • Telefone (1): inicia uma ligação para quem prefere falar com a equipe.
  • Copiar código (1): copia o cupom de desconto com um toque.

A resposta rápida é o botão que mais conversa com a automação. Quando o cliente toca em uma opção, um chatbot para WhatsApp pode continuar o fluxo, tirar dúvidas e encaminhar o contato para a próxima etapa da venda.

Compatibilidade com o Desktop e Botão de Saída

Pela mesma documentação, templates com 4 ou mais botões, ou com resposta rápida misturada a outro tipo, não aparecem no WhatsApp desktop. Quando o público usa muito o computador, o ideal é ficar em até 3 botões de um único tipo.

Toda campanha de marketing deve incluir uma saída visível, como uma resposta rápida “Parar promoções”. A Meta trata instruções claras de saída como boa prática, recomendada para evitar bloqueios e denúncias, dois sinais que pesam na nota de qualidade.

Um botão que não remove ninguém da lista gera o efeito contrário: o cliente insiste, perde a paciência e recorre ao bloqueio. Por isso, o toque em “Parar” precisa atualizar a base antes da campanha seguinte.

Passo a Passo para Fazer Disparo em Massa no WhatsApp

Passo a passo do disparo em massa no WhatsApp, do objetivo ao envio monitorado

O roteiro prático vai da conta conectada ao primeiro envio monitorado. Cada etapa depende da anterior, e pular a preparação costuma aparecer depois como erro de entrega ou queda de qualidade.

Preparação da Conta e da Base

O primeiro passo é conectar o número à Cloud API, a versão da API oficial hospedada pela Meta, direto ou pelo Embedded Signup, o cadastro guiado feito pelo parceiro.

Em seguida, a empresa confere a nota de qualidade no WhatsApp Manager e limpa a base. Só devem ficar contatos com opt-in registrado, e quem já pediu para sair precisa ser removido antes da primeira campanha.

Também é preciso definir quem vai responder o público. Uma campanha bem-sucedida pode gerar muitas conversas ao mesmo tempo, e o WhatsApp com múltiplos atendentes distribui essas respostas entre a equipe sem perder o histórico.

Criação, Aprovação e Envio da Campanha

Com a conta pronta, a campanha segue seis etapas:

  1. Definir o objetivo e a categoria do template (marketing ou utilidade).
  2. Escrever o template com variáveis, botões e uma opção de saída.
  3. Enviar o template para aprovação da Meta.
  4. Segmentar o público pela categoria de opt-in e pelo histórico.
  5. Fazer um envio de teste para um lote pequeno e acompanhar o pacing.
  6. Liberar o restante e monitorar as métricas e os erros.

O lote de teste protege o número, porque revela problemas antes do envio completo. Com ferramentas de automação, dá para agendar os lotes, pausar a campanha diante de sinais ruins e reprogramar envios que falharem.

Segmentação e Frequência de Envio

A segmentação pode combinar a categoria de opt-in, o histórico de compra e o engajamento recente. Como a taxa de leitura influencia o limite por usuário, enviar a quem não lê reduz a entrega das próximas campanhas.

A frequência ideal varia de negócio para negócio, e a Meta não define um número fixo. O critério prático é espaçar as campanhas e priorizar a conversa dentro da janela de atendimento sempre que o cliente responder.

No delivery, por exemplo, faz sentido enviar a promoção só para quem pediu nos últimos meses e deixar o chatbot de delivery fechar o pedido na conversa. Assim, a campanha vira venda sem novos templates.

Limites de Envio, Pacing e Limite por Usuário

Níveis de limite de envio e fluxo de pacing de templates

A Meta libera o volume aos poucos, conforme o histórico da empresa, a reação do público e o teto de marketing de cada pessoa.

Níveis de Limite e Como Subir de Nível

Os limites de mensagens contam destinatários únicos em 24 horas fora da janela. Os níveis são 250, 2.000, 10.000, 100.000 e ilimitado, e o limite vale para todo o portfólio empresarial (a conta da empresa no Gerenciador de Negócios), e não por número.

A partir de 2.000, o limite sobe um nível em até 6 horas quando a qualidade está alta e a empresa usou pelo menos metade do limite nos últimos 7 dias. O nível e a nota de qualidade aparecem no WhatsApp Manager.

As conversas na janela de atendimento não entram nessa conta, e um atendimento via WhatsApp que responde rápido a quem reagiu à campanha não consome o limite.

Pacing e Pausa de Templates

O pacing de templates vale para os de marketing e utilidade novos, recém-despausados ou sem nota verde (alta) de qualidade. Depois de um lote inicial, as demais mensagens ficam retidas (status held_for_quality_assessment) enquanto a Meta avalia a reação do público.

A Meta busca entregar as mensagens retidas em até uma hora em 99% dos casos. Se o feedback for negativo, porém, o template é pausado e as retidas são descartadas (erro 132015).

As pausas duram 3 horas e depois 6 horas, e em seguida o template é desativado. Tentativas com template pausado não são cobradas, e os outros templates bons do número continuam saindo.

O aviso de pausa chega pelo webhook message_template_status_update. Seguir boas práticas de atendimento, com conteúdo relevante, ajuda a manter o feedback positivo e o template ativo.

Limite por Usuário e Erro 131049

Decisão para mensagem de marketing não entregue: erros 131049, 131050 e 132015

O limite por usuário restringe quantos templates de marketing cada pessoa recebe, somando todas as empresas. Esse limite é dinâmico e depende da taxa de leitura recente da pessoa. Quando ele é atingido, o envio falha com o erro 131049.

A orientação da Meta é esperar pelo menos 24 horas antes de tentar reenviar a mesma mensagem de marketing, porque retentativas em excesso bloqueiam a entrega por até 24 horas.

O marketing enviado dentro da janela de atendimento não conta para esse limite, e a regra não se aplica no Espaço Econômico Europeu (EEE), no Reino Unido, no Japão e na Coreia.

Na prática, a automação de follow-up deve reprogramar a repescagem para outro dia, em vez de insistir no mesmo contato logo após o erro.

Custos e Métricas do Disparo em Massa

O que é cobrado e o que é grátis nos templates da API oficial

Cada template entregue entra na conta, e cada campanha deixa rastros de resultado e de risco. Olhar custo e métricas juntos mostra se o disparo vende sem comprometer o número.

Cobrança por Template Entregue

Pela tabela de preços da Meta, desde 01/07/2025 a cobrança é por template entregue, nas categorias marketing, utilidade e autenticação. O valor depende da categoria e do país do destinatário.

Até 30/09/2026, as mensagens que não são template e os templates de utilidade enviados na janela de atendimento são gratuitos, segundo a tabela oficial, que deve ser conferida antes de cada campanha.

A partir de 01/10/2026, a Meta passa a cobrar por mensagem de serviço, a mensagem livre enviada na janela, com 1.000 entregues grátis por mês para cada número, e também pela utilidade enviada dentro da janela.

A Marketing Messages API tem a mesma cobrança da Cloud API e acrescenta otimização de entrega e métricas de conversão. Responder rápido com IA no atendimento via WhatsApp aproveita o interesse da campanha e ajuda a converter na conversa.

Métricas Oficiais por Template

Funil de métricas do disparo em massa no WhatsApp, de enviadas a conversões, com sinais de alerta

As métricas de templates da Meta mostram, para cada modelo, mensagens enviadas, entregues, lidas, cliques e custo. Com a Marketing Messages API, o painel inclui também as conversões atribuídas à campanha.

Os dados são diários e ficam guardados por 90 dias. Leituras e cliques só contam até 7 dias depois do envio, o que exige cuidado ao comparar campanhas de datas diferentes ou fechar relatórios cedo.

Esses números devem conversar com as métricas de atendimento da equipe, como tempo de resposta e resolução. Assim, a empresa enxerga o caminho completo, do template enviado à venda concluída na conversa.

Indicadores de Saúde da Campanha

Alguns indicadores antecipam problemas de entrega. A lista abaixo é uma sugestão editorial, sem benchmark oficial da Meta, com a ação indicada para cada sinal:

  • Descadastros e respostas: um salto em pedidos de saída indica segmento errado ou conteúdo pouco relevante.
  • Erros 131049 e 131050: muitos casos pedem revisão da frequência e limpeza da base.
  • Qualidade e templates pausados: nota média ou baixa, ou um aviso de pausa de template, pede um intervalo nas campanhas e a revisão do texto.

Descadastro e LGPD no Disparo em Massa

Camadas de uma campanha segura no WhatsApp com LGPD

A saída da lista tem duas camadas: o controle que o próprio WhatsApp dá ao usuário e as exigências da lei brasileira. As duas se encontram em um único processo de registro e respeito ao pedido.

Opt-out, Erro 131050 e Webhook user_preferences

Segundo a documentação de templates de marketing, o usuário pode desligar o marketing de uma empresa no ajuste “Ofertas e anúncios” do WhatsApp. Depois disso, todo template de marketing para essa pessoa falha com o erro 131050.

O webhook user_preferences avisa quando a pessoa para ou volta a aceitar marketing. Sincronizar esse status com o CRM evita tentativas inúteis, e plataformas como a ConverZap fazem essa sincronização do opt-out automaticamente.

Reconhecer palavras como “SAIR” e “PARAR” em texto livre é boa prática, não regra oficial. Agentes de inteligência artificial conseguem identificar esse pedido na conversa e atualizar a base automaticamente.

Revogação do Consentimento e Tratamento dos Dados

Pela Lei Geral de Proteção de Dados, o consentimento pode ser revogado a qualquer momento, “por procedimento gratuito e facilitado” (art. 8º, §5º). Na prática, a saída precisa ser tão fácil quanto a entrada.

Isso vale para um botão na mensagem, uma palavra-chave digitada na conversa ou o ajuste do próprio WhatsApp. A campanha também deve usar só os dados necessários, como nome e histórico de compra, sem coletar além da finalidade.

Quando um agente de IA responde às campanhas, um prompt bem definido precisa trazer regras claras para reconhecer pedidos de saída, confirmar o descadastro e nunca insistir com quem pediu para parar.

Perguntas Frequentes sobre Disparo em Massa no WhatsApp

Dúvidas comuns sobre bloqueio, limites, custos e descadastro

As respostas abaixo tratam de dúvidas que costumam surgir na primeira campanha e que vão além do passo a passo.

A empresa pode enviar campanha para clientes antigos que nunca deram opt-in?

Não. A Política do WhatsApp Business exige opt-in antes do contato, e um cadastro antigo que não cita o WhatsApp nem o nome da empresa não cumpre essa regra. O caminho é pedir o consentimento por um canal aceito, como site, SMS ou atendimento telefônico, e só depois incluir o contato nas campanhas.

O que muda quando o cliente responde à campanha?

A resposta abre a janela de atendimento de 24 horas, em que a empresa pode enviar mensagens livres, sem template. Essas conversas não contam no limite do portfólio, e responder com IA no atendimento ao cliente aproveita o momento em que o interesse está alto.

O disparo em massa pode levar imagem, vídeo ou PDF?

Sim. Segundo a documentação de componentes da Meta, o cabeçalho do template pode ser de mídia, como imagem, vídeo, GIF ou documento em PDF, além de texto e localização. A mídia fica no topo da mensagem, acima do corpo e dos botões.

Onde a empresa descobre por que uma mensagem da campanha não foi entregue?

O código de erro, como 131049, 131050 ou 132015, chega no webhook de status da mensagem. A pausa do template aparece no webhook message_template_status_update e no WhatsApp Manager, o que permite separar falhas de um contato de problemas do template inteiro.

Conclusão

Campanhas que duram dependem menos de volume e mais de disciplina: consentimento que cita marca e canal, template na categoria certa, saída a um toque e atenção a limites, pausas e códigos de erro. Assim o número fica protegido e cada envio vira conversa com quem quer comprar.

A ConverZap reúne agentes de IA na API oficial com coexistência, disparos com templates e descadastro, integração com CRM e dashboards de envios, respostas e descadastros. Conheça a ConverZap e planeje a primeira campanha dentro das regras.

Compartilhar:

Cadastre-se na nossa Newsletter
Receba novidades e atualizações sobre nossas soluções
Veja mais...
WhatsApp para escolas: Guia de automação
Configuração e Uso do WhatsApp Business

WhatsApp para escolas: Guia de automação

Descubra como o WhatsApp para escolas otimiza o atendimento, qualifica leads de matrículas e melhora a comunicação com pais e alunos 24 horas por dia.

WhatsApp para academias: como atrair alunos e automatizar
Configuração e Uso do WhatsApp Business

WhatsApp para academias: como atrair alunos e automatizar

Descubra como usar o WhatsApp para academias. Aprenda a automatizar o atendimento, qualificar leads e aumentar as matrículas com agentes de IA.

Experimente Grátis
Entenda como podemos ajudar sua empresa com nosso universo de soluções
Conexão da ConverZap com a API oficial do WhatsApp pela Meta
plugins premium WordPress