Vazante
EntrarComeçar

Métricas e análise

Disparo em massa no WhatsApp pela API: o que pode e o que derruba o número

Disparo em massa pela API oficial do WhatsApp: as travas que a Meta põe no caminho, como montar um envio que passa e os erros que derrubam o número.

Sexta-feira, 9h. A campanha de aniversário da loja está pronta: 8.000 clientes na base, desconto definido, arte aprovada. Alguém sugere mandar pela API, "porque lá não tem bloqueio". Ao meio-dia, poucas centenas de mensagens saíram, parte ficou retida e o template está amarelo.

Ninguém bloqueou a loja. Ela esbarrou em regras. A API oficial permite, sim, mandar a mesma oferta para muita gente, mas com travas que o celular não tem. Cada trava responde a uma pergunta: essa pessoa pediu? Esse texto está sendo bem recebido? Essa empresa já mostrou que envia bem?

Pela API, disparo tem nome: template de marketing

Fora da janela de atendimento de 24 horas, a empresa só pode enviar templates, os modelos de mensagem aprovados pela Meta, e só para quem deu opt-in. Uma promoção é template da categoria marketing, que abrange vendas, promoções, retargeting e relacionamento.

Duas consequências práticas:

  • Cada mensagem entregue é cobrada pela Meta, pela tabela dela, que varia por categoria e pelo país de quem recebe. Com um Tech Provider, a cobrança vai direto para a forma de pagamento da sua conta.
  • Chamar promoção de aviso não funciona. Desde 09/04/2025, se a empresa escolhe a categoria utilidade e a Meta entende que o texto é marketing, o template é aprovado como marketing. Quem insiste em classificar errado pode ter os templates de utilidade restringidos, com o erro 131064.

As cinco travas da Meta no caminho

TravaO que fazComo aparece
Limite de envio do portfólioDefine quantas pessoas diferentes a empresa alcança fora da janela em 24 horas móveis: 250, 2.000, 10.000, 100.000 ou ilimitadoO envio para pessoas novas para no teto daquele período
Ritmo do templateTemplate novo, ou sem nota verde, pode ter parte das mensagens retida até a Meta medir a reaçãoStatus held_for_quality_assessment; se a reação for ruim, o template é pausado e as retidas são descartadas
Ritmo do portfólioPortfólio com menos de 500 mil templates enviados em 365 dias, ou sob suspeita, tem envios grandes liberados em lotesCom sinal de abuso, o restante é descartado (erro 135000)
Limite de marketing por usuárioO WhatsApp limita quantos templates de marketing uma pessoa recebe de todas as empresasErro 131049 para aquela pessoa
Saída do usuárioQuem desligou o marketing da sua empresa não recebeErro 131050

A primeira trava é a mais conhecida. Os níveis, o que conta e como subir estão em limites de envio com Tech Provider. A quarta é a que mais confunde, porque a mensagem falha mesmo com tudo certo do seu lado; ela tem explicação própria em limite de marketing por usuário.

Por trás das travas está a nota de cada template. Quando ela cai, a Meta pausa o template por 3 horas na primeira vez e por 6 horas na segunda. Na terceira, desativa de vez (erros 132015 e 132016), e você precisa criar outro.

Repare que nenhuma trava depende do provedor. São todas da Meta e valem igual para qualquer ferramenta.

Como montar um envio que passa

  1. Comece pela lista, não pelo texto. Só entra quem deu permissão para aquele tipo de mensagem. Como pedir e registrar essa permissão está em opt-in no WhatsApp.
  2. Escreva algo que a pessoa queira receber. A Meta recomenda mensagens personalizadas e úteis e pede para evitar boas-vindas genéricas e excesso de mensagens no mesmo dia.
  3. Ofereça a saída. A Meta recomenda um jeito claro de sair, por tipo de mensagem. Quem sai pelo caminho que você ofereceu não precisa bloquear o número.
  4. Comece por quem mais interage. Clientes recentes e engajados têm menos chance de reagir mal ao primeiro lote.
  5. Mande um lote de teste e espere. Template novo passa pelo ritmo de avaliação. Olhe a nota antes de liberar o resto. Segundo a Meta, mesmo com esse ritmo, a meta dela é entregar a campanha em até 1 hora na grande maioria dos casos.
  6. Divida a base pelo limite. Lotes que caibam no limite do portfólio em 24 horas, combinados entre todos os números do mesmo portfólio.
  7. Trate cada erro pelo código. No 131049, espere pelo menos 24 horas para tentar de novo com aquela pessoa. No 131050, tire da lista de marketing. No 131056, você mandou mensagens demais para a mesma pessoa em pouco tempo.

Sobre o item 7: reenviar várias vezes em menos de 24 horas para quem recebeu o 131049 piora a situação. Desde 30/04/2026, o WhatsApp pode bloquear novas tentativas para esses usuários por até 24 horas.

Por que a lista de transmissão não resolve na coexistência

Quem usa o app WhatsApp Business costuma fazer promoção por lista de transmissão. Na coexistência, quando o número é conectado à API, as listas do app são desativadas e as que já existiam ficam só para leitura. O envio para muitos contatos passa a ser pela API, com template e com as travas acima.

A tentação seguinte é mandar a mesma mensagem, um por um, pelo celular, já que o que a equipe envia pelo app fica fora da cobrança da Cloud API. É justamente o padrão que o WhatsApp pune no app. A Central de Ajuda pede para não fazer envio em massa, mensagem automática nem discagem automática, e a conta pode ser restringida quando a atividade recente mostra sinais de spam ou de mensagens em massa. Restringida, ela não pode iniciar conversa com contatos novos. As outras perdas da coexistência estão em limitações do WhatsApp Coexistence.

O que derruba o número

  • Lista comprada ou montada de fontes públicas. Ninguém ali deu o número a você nem deu permissão, e a Política exige as duas coisas.
  • Base antiga sem registro. O cliente de anos atrás não lembra da sua empresa, e "não me cadastrei" é um dos motivos de bloqueio que pesam na qualidade.
  • Promoção disfarçada de aviso. A Meta recategoriza o template e, se o padrão se repete, restringe os templates de utilidade da empresa.
  • Insistir depois do 131049. Como visto acima, o reenvio em sequência só prolonga o bloqueio daquela pessoa.
  • Espalhar o disparo por vários números. Desde 07/10/2025, o limite é do portfólio e todos os números dele dividem a mesma conta. Mais números no mesmo portfólio não aumentam o alcance.
  • Ferramenta fora da plataforma oficial. A promessa costuma ser envio ilimitado, sem template. A Política diz que quem manda mensagens em escala de forma não autorizada pode perder o acesso ao WhatsApp para empresas. Os riscos estão em API não oficial do WhatsApp.

O que muda em 2027

Em 13/10/2026, a Meta anunciou que a Cloud API vai deixar de enviar mensagens de marketing em 13/10/2027. Contas de mensagens criadas a partir de 13/04/2027 já nascem sem essa opção. O marketing passa para a Marketing Messages API, antes chamada de MM Lite, que segue o mesmo modelo de cobrança e usa os mesmos números e templates. Utilidade, autenticação e mensagens de serviço continuam na Cloud API.

O anúncio é recente, e a própria Meta pode ajustar detalhes. Quem planeja campanhas recorrentes pelo WhatsApp deve perguntar ao fornecedor, desde já, como ele vai tratar essa transição.

O Vazante não é ferramenta de disparo

Dito com todas as letras: o Vazante não é ferramenta de disparo em massa. Com o número conectado, o painel cria e acompanha templates e envia mensagens para um número de cada vez. O foco dele é outro: mostrar qual anúncio gerou cada conversa, com o custo, ao lado das métricas de Meta Ads, Google Ads e TikTok Ads.

Se a sua operação depende de campanhas grandes pelo WhatsApp, use uma ferramenta feita para isso e aplique a ela tudo o que está neste texto. As travas são da Meta e valem para qualquer uma.

O Vazante é Tech Provider (provedor de tecnologia) da Meta, e a Meta cobra as mensagens direto da sua conta, sem margem do Vazante. O que cada plano inclui está nos planos.

Perguntas frequentes

Pode fazer disparo em massa pela API oficial do WhatsApp?

Pode, dentro das regras: só para quem deu opt-in, com template de marketing aprovado pela Meta e respeitando o limite de pessoas por 24 horas do portfólio. O que os Termos do WhatsApp proíbem é o envio em massa automatizado fora da plataforma oficial.

Por que só parte das mensagens do disparo foi entregue?

As causas mais comuns são o limite de envio do portfólio, o ritmo que a Meta aplica a templates novos ou sem nota verde e o limite de marketing por usuário, que aparece como erro 131049. Cada uma pede uma ação diferente.

Na coexistência dá para usar a lista de transmissão do app?

Não. Quando o número é conectado à API, as listas de transmissão do app são desativadas e as que existiam ficam só para leitura. O envio para muitos contatos passa a ser pela API, com template.

O Vazante faz disparo em massa?

Não. O Vazante não é ferramenta de disparo em massa: o envio pelo painel é feito para um número de cada vez. O foco dele é mostrar qual anúncio gerou cada conversa e organizar os templates.

Leia também