Disparo em massa no WhatsApp pela API oficial, sem bloqueio

Disparo em massa no WhatsApp é permitido, mas só de um jeito: pela API oficial da Meta, para pessoas que deram o número e aceitaram receber mensagens da sua empresa, usando uma mensagem aprovada pela Meta antes do envio. Fora disso, o envio em massa é o que a Meta chama de "bulk messaging não autorizado", e é o motivo mais comum de número banido. A diferença entre os dois caminhos não está na ferramenta que você contrata. Está em quem a Meta enxerga do outro lado: uma empresa identificada, com regras e limites conhecidos, ou um celular automatizado fingindo ser uma pessoa.

Este guia explica o que a Meta proíbe e por quê, as quatro regras do envio oficial, quantas mensagens dá para mandar por dia, quanto custa e o que fazer com as falhas que todo disparo tem.

Resposta curta: é permitido, mas só de um jeito

A Meta mantém dois produtos com o mesmo nome. O app WhatsApp Business, do celular, foi feito para conversa: uma pessoa atendendo de cada vez, com etiquetas, respostas rápidas e catálogo. A WhatsApp Business Platform, que todo mundo chama de API oficial do WhatsApp, foi feita para empresa que precisa de volume, integração e automação. É nela que o envio em massa existe como recurso, com nome, regra e preço.

O que a Meta chama de envio em massa oficial tem quatro ingredientes, e os quatro são obrigatórios:

Repare que nenhuma das quatro regras é do provedor. Um provedor sério, como o Frame Conexa, não inventa limite por cima disso. Ele conecta o seu número à API oficial, organiza o público, manda o texto para aprovação e dispara respeitando o que a Meta permite. Se um envio falha, a recusa vem da Meta, com um código, e a tela precisa dizer isso com todas as letras.

O que a Meta proíbe, e por que as ferramentas de WhatsApp Web bloqueiam

As diretrizes de mensagens do WhatsApp proíbem, em texto corrido, o uso de "clientes não oficiais, envio em massa, mensagens automáticas, discagem automática ou automação para prejudicar o WhatsApp ou seus usuários". A Central de Ajuda do WhatsApp tem uma página só sobre "uso não autorizado de mensagens automáticas ou em massa": a detecção é feita por aprendizado de máquina somado a denúncias de usuários, a punição vai de aviso a suspensão permanente, e a alternativa legítima apontada pela própria Meta é a WhatsApp Business Platform.

A parte que quase ninguém explica é o mecanismo. As ferramentas de disparo baratas funcionam com uma sessão de WhatsApp Web, ou com um app modificado, controlando um número comum como se fosse uma pessoa digitando muito rápido. A Meta não precisa "descobrir" o software. Ela vê o comportamento: um número que manda centenas de mensagens iguais para gente que nunca falou com ele, em ritmo que humano nenhum sustenta, e que começa a receber bloqueios e denúncias. O padrão dispara o bloqueio, primeiro temporário, depois definitivo. O artigo sobre WhatsApp Business bloqueado explica o que fazer quando isso acontece, e a comparação entre API oficial e não oficial detalha por que a sessão de WhatsApp Web é um risco por construção.

Pela API oficial, o cenário inverte. A Meta sabe quem é a empresa, sabe o que está sendo enviado, porque aprovou o texto, e sabe que cada destinatário tem um botão para parar de receber. O número não é banido por enviar em volume. Ele é limitado por capacidade, avisado por qualidade e, se insistir em mandar o que as pessoas não querem, restringido com um código de erro que explica o motivo.

As quatro regras do envio em massa oficial

1. Consentimento (opt-in): como coletar e o que a Meta exige

A política de mensagens comerciais da Meta diz que você só pode contatar uma pessoa no WhatsApp se ela deu o número de celular para a sua empresa e se você recebeu a permissão dela confirmando que quer receber mensagens. As duas condições juntas. Ter o número na agenda não é consentimento. Ter comprado uma lista, muito menos.

A documentação oficial de opt-in é flexível quanto ao canal: o consentimento pode ser coletado por SMS, no site, numa URA de telefone, presencialmente ou em papel. O que ela exige em qualquer canal é clareza: o texto precisa dizer que a pessoa está aceitando receber comunicação da empresa, e o nome da empresa precisa aparecer. "Aceito receber novidades da Clínica Tal pelo WhatsApp", com uma caixa para marcar, cumpre a regra. Uma caixa já marcada escondida no rodapé, não.

Três boas práticas que a própria Meta recomenda, e que valem dinheiro depois:

• Separar o opt-in por tipo de mensagem. Quem aceitou receber a confirmação do pedido não necessariamente aceitou receber promoção. Pedir os dois separados evita denúncia mais adiante.
• Deixar claro o valor. "Avisos de promoção, no máximo uma vez por semana" converte mais e gera menos bloqueio do que "receber mensagens".
• Guardar o registro. Data, canal e texto que a pessoa viu. A LGPD pede base legal para tratar dado pessoal, e o consentimento que a Meta já exige é o registro natural disso. Se um dia alguém questionar, é o que você mostra.

2. Mensagem aprovada pela Meta (template) para começar a conversa

Na API oficial existem dois tipos de mensagem. A mensagem livre, qualquer texto, foto ou áudio, só pode ser enviada dentro da janela de 24 horas que abre quando a pessoa escreve para você. Fora dessa janela, a empresa só pode começar conversa com um template: um modelo de mensagem enviado à Meta com antecedência, classificado numa categoria (marketing, utilidade ou autenticação) e aprovado antes de sair.

É por isso que envio em massa é, na prática, envio de template. Você não manda o texto que quiser para uma lista. Você monta o modelo, com variáveis para o nome e a oferta, envia para aprovação e só depois dispara. O artigo sobre como ter um template aprovado explica as categorias e os motivos de reprovação mais comuns. Se a mensagem livre tentar sair fora da janela, a Meta recusa com o erro 131047, e nenhuma ferramenta oficial consegue contornar isso.

A aprovação é uma decisão da Meta, e não há prazo oficial para ela. Planejar uma campanha para amanhã com um template criado hoje é correr risco à toa: crie o modelo com folga.

3. Respeitar o "sair" (opt-out), inclusive fora do WhatsApp

A mesma política que exige o opt-in exige o inverso: a empresa deve "bloquear, descontinuar ou cessar" o envio para quem pedir, e o pedido vale por qualquer canal. Se a pessoa mandou um e-mail dizendo que não quer mais receber WhatsApp, ela sai da lista, mesmo que nunca tenha tocado no botão do WhatsApp.

No WhatsApp existem dois caminhos automáticos. O usuário pode desativar o recebimento de marketing da sua empresa direto no app, e nesse caso qualquer template de marketing seguinte falha com o código 131050. E ele pode simplesmente responder "sair" ou "parar". Um provedor que leva isso a sério trata os dois: no Frame Conexa, o 131050 e as palavras de saída tiram o contato do público sozinhos, e a Meta ainda avisa por um evento próprio quando alguém muda a preferência. O que a ferramenta não faz por você é o pedido que chegou por e-mail ou por telefone: esse vai para a lista de supressão à mão.

4. Número de marketing e a capacidade que a Meta dá ao número

Dois detalhes que costumam pegar de surpresa. O primeiro é de produto: o Frame Conexa vende dois tipos de número, e só o número de marketing dispara campanha e cria template de marketing. O número de atendimento responde na janela de 24 horas e envia templates de utilidade e autenticação, que é o que uma clínica precisa para confirmar consulta, mas não faz envio em massa promocional. É uma separação comercial nossa, explicada na página de planos, e existe para não cobrar por uma capacidade que a pessoa não vai usar.

O segundo é da Meta, e é o assunto da próxima seção: cada negócio tem uma capacidade de envio, medida em pessoas diferentes alcançadas em 24 horas, e ela começa pequena.

Importante: um número conectado e saudável ainda pode não disparar nada se a conta do WhatsApp Business dele não tiver um meio de pagamento cadastrado na Meta. Como Tech Provider, o Frame Conexa não cadastra o cartão pelo cliente. Isso se faz no próprio Business Manager, e o painel mostra o link quando detecta o bloqueio.

Quantas mensagens posso enviar por dia?

A pergunta mais feita tem uma resposta que muda com o tempo. Não existe um teto fixo por dia. Existe uma capacidade definida pela Meta, que cresce conforme o uso, e um limite adicional por pessoa que ninguém controla.

O limite é da Meta, não do provedor: 250, 2.000, 10.000, 100.000, ilimitado

A documentação de limites de envio define a capacidade como o número máximo de telefones diferentes para os quais a empresa pode entregar mensagens fora de uma janela de atendimento, numa janela móvel de 24 horas. Os degraus são 250, 2.000, 10.000, 100.000 e ilimitado. Desde outubro de 2025 esse limite é calculado por portfólio de negócios e compartilhado por todos os números dele; o degrau antigo de 1.000 deixou de existir.

Três consequências práticas:

1. Todo número novo começa em 250. Uma campanha de 1.000 pessoas no primeiro dia não sai inteira. Para sair do primeiro degrau, o caminho é verificar a empresa no Business Manager, ou entregar 2.000 mensagens fora de janela para 2.000 números diferentes em 30 dias, com templates de boa qualidade.
2. Subir é automático, e rápido. Com mensagens de alta qualidade em todos os números e pelo menos metade da capacidade atual usada nos últimos 7 dias, a Meta sobe um degrau em até 6 horas.
3. Cair por qualidade não acontece mais. A regra antiga, de que qualidade vermelha derrubava o limite depois de 7 dias, foi eliminada pela Meta em outubro de 2025 junto com o estado "sinalizado". Hoje a qualidade conta para a subida e para restrições de spam, não para o rebaixamento. Muito artigo por aí ainda repete a regra velha.

O detalhe da unidade importa: a capacidade conta pessoas, não mensagens. Mandar três templates para a mesma pessoa consome uma unidade. E conta só mensagem fora de janela: responder quem escreveu para você não gasta capacidade. O artigo sobre o limite de mensagens da API desce nos detalhes, inclusive no ritmo por segundo, que para número em coexistência fica fixo em 20 mensagens por segundo.

No painel do Frame Conexa, a aba "Capacidade do número" em Disparos mostra quanto foi usado nas últimas 24 horas e avisa a partir de 80%. A criação de campanha maior que a capacidade disponível é recusada antes de começar, para o disparo não parar no meio.

Limite por pessoa: o erro 131049

Além da capacidade da empresa, a Meta limita quantos templates de marketing uma mesma pessoa pode receber, somando todas as empresas que falam com ela. O número não é divulgado: a página oficial o descreve como dinâmico, baseado em quanto aquela pessoa lê as mensagens de marketing que recebe. Quem lê pouco recebe menos.

Quando o limite bate, o envio falha com o código 131049, e a orientação da Meta é esperar pelo menos 24 horas antes de tentar de novo. Insistir antes prolonga o bloqueio. Templates de utilidade, de autenticação e respostas dentro da janela não são afetados.

Isso significa que uma parte do seu público está indisponível em qualquer dia, e você não sabe qual. É a falha mais comum numa lista fria, e não tem nada a ver com o seu número.

Quanto custa um envio em massa

Há dois custos separados, de dois cobradores diferentes.

A Meta cobra por mensagem de template entregue, com tarifa que depende da categoria e do país do destinatário. Pela tabela publicada pela Meta em setembro de 2026, marketing para destinatário no Brasil custa US$ 0,0625 por mensagem entregue; confira o rate card oficial antes de fazer conta, porque a Meta atualiza a tabela e, desde julho de 2026, passou a permitir faturamento em reais para contas novas no Brasil. Provedores brasileiros citam algo em torno de R$ 0,32 por mensagem de marketing, mas esse valor é de terceiros, não da página oficial. Dois pontos que aliviam: a Meta só cobra mensagem entregue, então as falhas não custam nada; e resposta livre dentro da janela de 24 horas é gratuita hoje, embora a Meta tenha anunciado que passa a cobrar mensagens de serviço e templates de utilidade dentro da janela a partir de 1º de outubro de 2026.

O provedor cobra pela plataforma. No Frame Conexa a cobrança é por número, mensal, trimestral ou anual, e não há tarifa nossa por mensagem nem franquia de envios: o único limite de volume é o da Meta. O pagamento das mensagens é feito pelo cliente direto para a Meta, com o cartão cadastrado no Business Manager dele. Não existe intermediação, markup ou linha de crédito, o que é uma limitação do modelo de Tech Provider, mas também uma garantia de que a fatura da Meta é a fatura da Meta. O artigo sobre o preço da WhatsApp Business API junta as duas contas com exemplos.

Nota: quem chega por um anúncio Click-to-WhatsApp e é respondido em até 24 horas abre uma janela de 72 horas em que qualquer mensagem, inclusive template de marketing, é gratuita. É a regra documentada da Meta para o "ponto de entrada gratuito", e o painel a sinaliza nas conversas de anúncio. Veja o guia sobre anúncios Click-to-WhatsApp.

Passo a passo no Frame Conexa

O fluxo inteiro cabe em três etapas, e a mais demorada é a do meio, porque depende da Meta.

Importar o público e criar segmentos

Em Público, os contatos entram por cadastro manual, pela API ou por importação de CSV, com pré-visualização antes de confirmar e um arquivo de erros para as linhas que não passaram. O telefone é normalizado, então "(85) 9 9999-0000" e "5585999990000" são o mesmo contato.

A partir daí você monta segmentos. Um segmento estático é uma lista fixa: quem veio da importação de setembro, quem comprou tal produto. Um segmento dinâmico é uma regra recalculada a cada leitura: quem respondeu a campanha anterior, quem não escreveu há mais de 30 dias, quem tem determinado campo preenchido. A campanha congela a lista no momento da criação, então um segmento dinâmico não muda o público de um disparo que já começou.

Quem pediu para sair não entra em segmento nenhum. A supressão vale sobre o público inteiro, e uma campanha nova para "todos os contatos" já nasce sem eles.

Criar a mensagem e esperar a aprovação

Em Templates, com um número de marketing selecionado, você cria o modelo: nome, idioma, categoria, texto com variáveis e, opcionalmente, botões. Dois botões merecem atenção especial num envio em massa: o de resposta rápida, que gera um clique mensurável, e o de link, que abre uma página. O template vai para a Meta e o painel acompanha o status pelo aviso que ela envia a cada mudança. Enquanto não estiver aprovado, ele não aparece para escolher na campanha.

Templates de marketing têm qualidade própria, avaliada pela Meta com base em bloqueios, denúncias e taxa de leitura. Um template que chega à qualidade baixa é pausado automaticamente: 3 horas na primeira vez, 6 na segunda, e desativado na terceira. Um bom texto, para o público certo, é o que evita isso.

Disparar, acompanhar entregas e cliques nos botões

Em Disparos, a campanha nasce de um segmento, um template e um ritmo. Antes de gravar qualquer coisa, o painel roda uma verificação: o template existe e está aprovado, o público tem contatos válidos, a capacidade do número comporta o tamanho da lista, a conta do WhatsApp Business não está bloqueada por pagamento. Se algo falha, a campanha não é criada e a tela diz o motivo. Dá para agendar para uma data e hora, e o ritmo vai de 1 a 20 mensagens por segundo, sempre limitado ao que a Meta permite para aquele número.

Quem integra por sistema tem a mesma verificação na API pública, com o mesmo corpo da criação:

curl -X POST https://frameconexa.com/api/v1/campaigns/preflight \
  -H "Authorization: Bearer fc_SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "clientId": "6ed76b84-4d65-4f3d-88c1-8d4174bdce73",
    "segmentId": "1",
    "name": "Oferta de setembro",
    "template": { "name": "oferta_setembro", "language": "pt_BR" },
    "bindings": [],
    "sendIntervalMs": 200
  }'

Durante o envio, a página da campanha mostra enviadas, entregues, lidas e falhas em tempo real, e cada destinatário aparece com o resultado e o motivo, se falhou. Terminou, você baixa o relatório completo em CSV, ou só o arquivo de erros.

Se o template tinha botão de resposta rápida, a campanha mostra quem clicou, em qual botão e quantas vezes. A atribuição é feita pela mensagem que a pessoa respondeu, nunca pelo telefone, porque no Brasil o número volta da Meta sem o nono dígito com frequência e o cruzamento por telefone perderia metade dos cliques. Com um clique, quem clicou vira um público novo, para a próxima campanha partir de quem demonstrou interesse.

Dica: comece pequeno. Uma primeira campanha de 50 pessoas para um público que já conversou com você ensina mais sobre o seu template e o seu público do que uma de 2.000 para uma lista fria, e sobe a capacidade do número do jeito que a Meta gosta: com qualidade.

Erros normais de um disparo e o que fazer com cada um

Todo disparo tem falhas, e a maioria delas é o comportamento esperado da Meta, não um defeito. Um dado de campo: em setembro de 2026, uma campanha real de 250 contatos frios enviada pelo Frame Conexa terminou com 36 falhas. Todas as 36 vieram da Meta, com três códigos. Nenhuma foi limite ou erro do provedor. A tabela abaixo é o que o painel mostra ao lado de cada destinatário, no mesmo vocabulário.

O que a tabela não resolve sozinha é a proporção. Uma lista com 10% de 131026 é uma lista velha: números que trocaram de dono ou nunca tiveram WhatsApp. Uma lista com muito 131049 é uma lista de gente que já recebe marketing demais de todo mundo. Nos dois casos a resposta é o público, não a ferramenta. O dicionário de erros da API explica cada código em profundidade.

Sobre as falhas há uma boa notícia que vale repetir: a Meta cobra só mensagem entregue. Falha não é dinheiro perdido.

Como manter a qualidade do número alta

A qualidade do número é a nota que a Meta dá com base no que os destinatários fizeram nos últimos 7 dias: bloquearam, denunciaram, informaram um motivo. Verde é alta, amarelo é média, vermelho é baixa. Desde outubro de 2025 ela não derruba mais a capacidade do número, mas continua decidindo se você sobe de degrau e é o gatilho das restrições de spam. Manter a qualidade alta é o que faz o envio em massa continuar sendo permitido para o seu número.

O que funciona, na ordem de impacto:

• Público que pediu. É a regra do opt-in, aplicada. Lista comprada é a forma mais rápida de ficar vermelho.
• Frequência anunciada e cumprida. Se você prometeu uma mensagem por semana, mande uma por semana.
• Um jeito fácil de sair. Um botão de resposta rápida "Não quero receber" no próprio template reduz denúncia: a pessoa sai em vez de bloquear.
• Ritmo. Mandar 2.000 mensagens em dois minutos e 2.000 mensagens em uma hora chega ao mesmo lugar, mas o segundo caso dá tempo de perceber um problema e pausar.
• Não insistir. Quem falhou com 131049 espera 24 horas. Quem falhou com 130472 ou 131050 não recebe de novo.

O Frame Conexa tem três freios automáticos que existem para proteger a nota do número enquanto você olha o resto. A campanha pausa sozinha quando a qualidade do número cai para vermelho, quando a Meta responde com 131048 e quando a taxa de falhas passa de um limiar com amostra suficiente. A pausa é para você revisar, e retomar é um clique. Não é castigo. É o que impede uma lista ruim de queimar um número bom em uma tarde.

Próximo passo

Se o seu número já está no WhatsApp Business do celular, ele pode ser conectado à API oficial sem sair do app, em coexistência, e o número de marketing passa a disparar campanhas pelo painel ou pela API. Veja os planos por número e, se for integrar por sistema, comece pelo guia rápido da API.