WhatsApp e API

Disparo em massa no WhatsApp pela API oficial: o passo a passo da primeira campanha

Disparo em massa WhatsApp API oficial em 7 passos: opt-in, template de marketing, limite do portfólio, custo por mensagem e relatório da campanha.

Disparo em massa no WhatsApp pela API oficial: o passo a passo da primeira campanha

Fazer disparo em massa no WhatsApp pela API oficial dá mais trabalho na primeira semana do que apertar “enviar” numa extensão de navegador. Você precisa de opt-in, de template aprovado, de forma de pagamento cadastrada na Meta e de paciência com um limite diário que começa em 250 pessoas. O que você ganha em troca é sair do risco de banimento por automação e passar a ter um relatório que diz o que a campanha fez. Este é o passo a passo, na ordem em que as coisas quebram se você pular uma etapa.

TL;DR: O disparo em massa pela API oficial do WhatsApp segue sete passos: número conectado à API (no modo normal ou em coexistência), base com opt-in, segmentação, template de marketing na categoria certa, envio dimensionado pelo limite do portfólio, leitura do relatório e resposta dentro da janela de 24 horas. Cada mensagem de marketing entregue custa R$ 0,3217 no Brasil. Na nossa leitura, a API oficial não bane por automação, que é o uso previsto, mas ela restringe por qualidade: denúncias e bloqueios levam a bloqueio de templates e de envio.

O que muda quando o disparo sai pela API oficial

Disparo em massa pela API oficial é o envio de um template aprovado pela Meta para uma lista de contatos que autorizou receber mensagens da sua empresa, feito por sistema e cobrado por mensagem entregue. A diferença para a lista de transmissão ou para a ferramenta não oficial está no que o WhatsApp considera normal: aqui, mandar mensagem automatizada para muita gente é o uso previsto do canal, desde que o conteúdo passe pela aprovação e a base tenha consentido.

Isso muda a pergunta que você faz antes de uma campanha. Na ferramenta não oficial, a pergunta era “quanto dá para mandar antes de o número cair?”. Na API oficial, as perguntas são três: quem pode receber, quanto vai custar e em quantos dias o meu limite deixa a campanha sair. A comparação completa entre os caminhos está no guia de disparo em massa no WhatsApp. Aqui o foco é a execução.

Antes do passo 1: o que precisa estar pronto

Três coisas travam a primeira campanha antes do template.

O número conectado à API. Você escolhe entre o modo normal, em que o número passa a funcionar só pela API, e a coexistência, em que o mesmo número continua no app WhatsApp Business e no WhatsApp Web para o atendimento 1:1 enquanto a campanha sai pela API. Na coexistência, a documentação da Meta (2026) exige o app WhatsApp Business na versão 2.24.17 ou superior. Se você vem de uma ferramenta não oficial, o roteiro de transição está em migrar para a API oficial do WhatsApp.

A forma de pagamento na Meta. Pela tabela de preços da Meta com vigência em 1º de outubro de 2026, quem não tiver forma de pagamento cadastrada até 30 de setembro de 2026 deixa de ter mensagens de serviço entregues. Empresas com cadastro de faturamento no Brasil (Sold-To Brasil) podem ser cobradas em reais desde julho de 2026.

A verificação da empresa. Não é obrigatória para disparar, mas é um dos dois caminhos para sair do limite inicial de 250 e chegar a 2.000 destinatários por dia, segundo a documentação de limites de mensagens da Meta (atualizada em 2026). Se você planeja uma base grande, comece a verificação antes de escrever o primeiro template.

Passo 1: separar a base que realmente deu opt-in

A Política de Mensagens do WhatsApp Business (atualizada em setembro de 2026) define opt-in em duas partes: a pessoa informou o número e autorizou receber mensagens da sua empresa. As duas precisam existir. Ter o telefone de alguém porque ele comprou na loja física, sem ter autorizado contato pelo WhatsApp, cumpre só a primeira.

Na prática, o opt-in que se sustenta vem de três lugares: formulário com caixa de consentimento explícita para WhatsApp, pedido do próprio cliente (“me avisa quando chegar”) e conversa iniciada por ele, em que você pergunta se pode mandar novidades e ele diz que sim. Registre a origem de cada consentimento num campo do CRM.

O opt-out é parte do mesmo pacote. Quem responder “sair”, “parar” ou equivalente precisa ser marcado e excluído das próximas campanhas. Esse contato, se voltar a receber, tende a virar denúncia, e denúncia é um dos sinais que a Meta usa para medir a qualidade.

Passo 2: segmentar pelo CRM, e não pela agenda

A qualidade do número na API oficial é medida nos últimos 7 dias, com peso maior para o mais recente, a partir de bloqueios, denúncias, silenciamentos, arquivamentos e o motivo do bloqueio, segundo a Central de Ajuda da Meta para empresas. Cada um desses sinais é uma pessoa dizendo “isso não era para mim”.

Segmentar reduz exatamente esse sinal. Na nossa leitura, a mesma oferta de reposição de estoque tem reações opostas em quem comprou o produto há 60 dias e em quem nunca comprou: para o primeiro, é lembrete útil; para o segundo, é propaganda. Um CRM com etapa do funil, etiquetas e campos personalizados deixa você montar o público assim:

  • clientes na etapa “comprou” com etiqueta do produto X e última compra entre 45 e 90 dias;
  • leads na etapa “proposta enviada” há mais de 15 dias, para uma condição especial;
  • contatos com campo “cidade” igual à da loja que vai abrir, para o convite da inauguração.

Cada recorte pede um template diferente, e é esse casamento entre público e texto que mantém a qualidade alta de uma campanha para a outra. Se a sua base hoje vive numa planilha, o primeiro trabalho é levá-la para um CRM para WhatsApp.

Passo 3: escrever o template de marketing na categoria certa

Todo disparo para quem não está conversando com você sai por template. A Meta classifica o template em marketing, utilidade ou autenticação, e a categoria define o preço: no Brasil, marketing custa R$ 0,3217 por mensagem entregue e utilidade custa R$ 0,035, pela tabela da Meta com vigência em 1º de outubro de 2026.

Essa diferença de quase dez vezes cria a tentação de cadastrar oferta como utilidade. Não faça. A política de aplicação da Meta para a plataforma WhatsApp Business (2026) lista template classificado na categoria errada entre os gatilhos de restrição. Utilidade é aviso sobre algo que o cliente já contratou ou pediu: status de pedido, lembrete de agendamento, boleto. Promoção, lançamento, convite e cupom são marketing.

Na nossa leitura, um template de campanha bem montado tem quatro partes. Exemplo ilustrativo:

“Oi, {{1}}! A linha de verão que você perguntou em agosto chegou na loja. Separamos os tamanhos P a GG até sábado. Quer que eu reserve o seu? Se não quiser mais receber novidades, é só responder SAIR.”

Nome do contato como variável, um motivo concreto para a mensagem existir, uma pergunta que convida resposta e a saída explícita. A pergunta no fim tem função prática: resposta abre a janela de atendimento, e dentro dela a conversa segue em texto livre.

Se você quer montar esse fluxo com a base, o template e o relatório no mesmo lugar, dá para ver os planos da Cubo Suite para campanha pela API oficial.

Passo 4: dimensionar o envio pelo limite do portfólio

O limite de mensagens da API oficial conta destinatários únicos em 24 horas móveis, fora da janela de atendimento. Portfólios novos começam em 250. Os degraus seguintes são 2.000, 10.000 e 100.000, e depois o limite deixa de ter teto fixo. Desde 7 de outubro de 2025, segundo a Meta, o limite pertence ao portfólio de negócios e é compartilhado por todos os números dele.

Conheça o CRM white label →

Três consequências práticas para a campanha:

  1. Campanha maior que o limite vira campanha em lotes. Base de 1.200 contatos em portfólio de 250 leva cinco dias. Ordene os lotes pelo segmento mais quente primeiro: ele gera mais respostas e menos bloqueios, o que ajuda na subida de degrau.
  2. Responder quem já está conversando não consome limite. Quem escreveu para você nas últimas 24 horas está dentro da janela e não conta como destinatário novo.
  3. Somar números não soma limite. Três números no mesmo portfólio dividem o mesmo teto.

Como subir de degrau, quanto tempo leva e o que mudou com a regra de 2025 está em limite de mensagens da API oficial do WhatsApp.

Passo 5: fazer a conta antes de apertar o botão

O custo de uma campanha é, basicamente, o número de mensagens entregues multiplicado pelo preço da categoria. Uma campanha de marketing para 2.000 contatos com entrega total custa R$ 643,40 em tarifas da Meta. Depois vêm as respostas: a partir de 1º de outubro de 2026, as mensagens de serviço têm 1.000 grátis por mês por número e custam R$ 0,035 cada depois disso.

A conta útil de verdade é a do ponto de equilíbrio. Divida o custo da campanha pela margem de uma venda e você tem quantas vendas precisa fazer para pagar as mensagens. Com R$ 643,40 de campanha e R$ 50 de margem por venda, são 13 vendas. Se o seu histórico de campanhas não sustenta esse número para esse público, reduza o recorte antes de enviar. A calculadora completa, com a janela grátis de anúncio e o efeito da mudança de outubro, está em custo de disparo em massa pela API oficial.

Passo 6: disparar e ler o relatório como quem mede qualidade

O relatório de uma campanha pela API mostra entregues, lidas e respostas. Cada número responde a uma pergunta diferente:

Métrica O que ela diz Sinal de alerta
Entregues Quantos números da base existem e estão ativos no WhatsApp Entrega baixa indica base velha ou números digitados errado
Lidas Se o início do template chamou atenção na lista de conversas Leitura baixa com entrega alta pede outro gancho na primeira linha
Respostas Se a oferta fez sentido para aquele recorte Muitas respostas “sair” indicam recorte errado, não texto ruim

Olhe também para o que o relatório de vendas não mostra. A política de aplicação da Meta descreve uma escala de restrições: bloqueio de templates por 1 ou 3 dias, bloqueio total de envio por 5, 7 ou 30 dias, trava da conta que só sai por recurso e, no extremo, desativação permanente. Se um template foi bloqueado, trate como aviso sobre aquele público e aquele texto. Na nossa leitura, mandar de novo para o mesmo recorte só com outra redação tende a acelerar a escada. As causas que levam a esses degraus têm paralelo com as do app, explicadas em API oficial vs não oficial do WhatsApp.

Passo 7: responder dentro da janela de 24 horas

Cada resposta ao template abre uma janela de 24 horas em que você conversa com texto livre, sem template. É ali que a campanha vira venda, e é ali que muita operação perde o jogo: a campanha sai às 10h, as respostas chegam ao longo do dia e ninguém está escalado para atender.

Em coexistência, a equipe pode responder pelo app no celular ou pelo WhatsApp Web, e segundo a documentação da Meta sobre coexistência (2026), mensagens enviadas pelo app continuam grátis. As respostas enviadas pela API, como as de uma caixa de entrada integrada ao CRM ou de um agente de IA, seguem o preço da Cloud API. Na nossa leitura, isso não é motivo para responder tudo pelo celular: o que você economiza em tarifa pode sair caro em conversa sem registro no CRM. Mas é uma variável que entra na conta.

Normal ou coexistência: qual modo usar para disparar?

Para o disparo em si, os dois modos funcionam igual: template aprovado, limite do portfólio, cobrança por mensagem. A diferença está no resto da operação.

A coexistência faz sentido quando o número já é conhecido pelos clientes, a equipe atende pelo app ou pelo WhatsApp Web e você não quer mudar esse hábito. Ela tem custos: as listas de transmissão do app ficam somente leitura, o WhatsApp para Windows e o WearOS deixam de funcionar, e o envio pela API tem throughput fixo de 20 mensagens por segundo. O modo normal faz sentido para número novo, dedicado a campanhas e atendimento por sistema, sem ninguém dependendo do app. O detalhe da coexistência para campanha está em disparo em massa com coexistência.

Quando não vale a pena disparar pela API oficial

Se a sua base é pequena, próxima e salvou o seu número, a lista de transmissão do app resolve sem custo por mensagem, com o limite de só chegar a quem tem o seu contato. Se o seu produto tem margem muito baixa e a sua conversão em campanha é pequena, a conta do passo 5 pode mostrar prejuízo antes de qualquer outra despesa. E se a base não tem opt-in, a API oficial vai expor o problema mais rápido do que qualquer outro trilho, porque a qualidade cai e a restrição vem.

Como a Cubo Suite faz esse fluxo

Somos parte interessada: a Cubo Suite dispara campanha por template oficial aprovado, pela API oficial, com o número em modo normal ou em coexistência. A segmentação sai do CRM (etapa do funil, etiqueta, campos), o relatório mostra entregues, lidas e respostas, e CRM, automação e chatbot com agente de IA ficam no mesmo lugar. A conexão é nativa, sem VPS e sem QR code. As regras de opt-in, limite e qualidade da Meta valem igual para quem usa a Cubo.

Se você atende clientes como agência e quer oferecer campanha oficial com a sua marca, veja o Cubo Suite white label.

Para rodar a primeira campanha com um recorte pequeno e medir antes de escalar, compare os planos da Cubo Suite e comece o teste de 3 dias sem cartão.

Perguntas frequentes

Quanto tempo demora para o template ser aprovado?

A revisão da Meta leva até 24 horas, segundo a documentação de templates (2026). Reprovação costuma vir de variável no início ou no fim do texto, variável sem exemplo, template duplicado ou tom ameaçador, e existe recurso. Oferta cadastrada como utilidade tende a ser reclassificada como marketing. Cadastre os templates da campanha com antecedência e tenha uma segunda versão pronta.

Posso disparar pela API oficial para contatos que não salvaram meu número?

Sim. Diferente da lista de transmissão do app, a API oficial entrega para quem não salvou o seu contato. O que a política exige é opt-in: a pessoa precisa ter informado o número e autorizado receber mensagens da empresa.

Posso usar vários números para disparar mais rápido?

Não para aumentar o limite. Desde 7 de outubro de 2025, segundo a Meta, o limite de mensagens é do portfólio de negócios e todos os números dele o compartilham. Vários números só dividem o mesmo teto.

A API oficial pode bloquear meu número?

Ela não bane por automação, que é o uso previsto. Mas restringe por qualidade: denúncias, bloqueios e falta de opt-in levam a bloqueio de templates por 1 ou 3 dias, bloqueio de envio por 5, 7 ou 30 dias e, em casos graves, trava ou desativação da conta.

Deixe um comentário

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *

Conhecer o white label →