Disparo em massa WhatsApp API oficial com templates no Chatwoot

O disparo em massa no WhatsApp pela API oficial usa templates aprovados pela Meta, e no Chatwoot Pro (hoje AstraChat) dá para fazer tudo no mesmo lugar: criar o template na caixa de entrada, escolher os contatos por planilha CSV, etiqueta ou etapa do funil e controlar o ritmo dos envios. A Meta cobra cada mensagem, cerca de R$ 0,32 por mensagem de marketing no Brasil.

Sem isso, fazer disparo em massa com a API oficial costuma ser um processo picado: você cria o template no painel da Meta, espera a aprovação, monta a lista numa planilha, usa uma ferramenta de disparo separada e depois tenta descobrir no Chatwoot quem respondeu. Cada etapa num lugar diferente.

No vídeo eu mostro o disparador que eu coloquei dentro do Chatwoot Pro (hoje AstraChat) e o novo cadastro de templates oficiais direto na caixa de entrada. Aqui você vê como criar o template, como montar a campanha, quais controles de ritmo usar e quanto a Meta cobra por cada mensagem.

Por que a API oficial virou o caminho para disparo

Eu gosto das APIs não oficiais e o disparador funciona com elas também. Mas para quem faz muito disparo, a API oficial está ficando imprescindível. É uma forma mais segura de mandar conteúdo para uma lista grande, porque você está dentro das regras da Meta e paga por mensagem enviada.

Um ponto que muita gente esquece: na API oficial a cobrança é da Meta, não da plataforma. No Brasil, a tabela oficial da Meta cobra cerca de R$ 0,32 por mensagem de marketing e cerca de R$ 0,035 por mensagem de utilidade. Uma campanha promocional para 1.000 contatos sai por volta de R$ 320 só de Meta. Faça essa conta antes de disparar.

Se quiser entender a tabela inteira, escrevi sobre os preços da API oficial do WhatsApp.

Criar template oficial sem sair do Chatwoot

Antes, o template tinha que ser criado no painel da Meta. Agora, ao editar uma caixa de entrada da API oficial em Configurações > Caixas de entrada, aparece uma aba nova chamada Templates.

1. Clique em adicionar novo template e dê um nome.
2. Escolha a categoria, o idioma e o tipo de conteúdo (texto, imagem, vídeo).
3. Preencha o cabeçalho, o corpo e o rodapé. Se quiser, adicione botões.
4. Confira o preview, que mostra como a mensagem vai chegar para o cliente.
5. Clique em criar template. Ele vai para a Meta e fica como pendente.
6. Depois de alguns minutos, se respeitar as diretrizes do WhatsApp, ele aparece como aprovado. Use o botão de sincronizar para ele ficar disponível no Chatwoot.

O processo de aprovação é o mesmo da Meta, só que você não precisa sair do sistema. No vídeo, o template que eu criei demorou alguns minutos e ficou pendente enquanto eu mostrava o resto. Isso é normal. Depois de aprovado, ele aparece também na lista de modelos dentro de qualquer conversa.

De onde vêm os contatos da campanha

O disparador tem três formas de escolher para quem mandar:

• Planilha CSV: existe um modelo pronto. Você monta a lista no Excel e sobe o arquivo. Colunas extras do CSV viram variáveis no texto.
• Etiquetas: manda para todo mundo que está com uma etiqueta específica nas conversas.
• Etapa do funil: escolhe o Kanban e a etapa, e manda para todos os leads que estão nela. No vídeo eu selecionei a etapa inicial do funil principal e o sistema já mostrou quantos leads encontrou.

A opção por etapa do funil é a que mais combina com operação comercial. O artigo sobre Kanban e funis de venda no Chatwoot mostra como organizar essas etapas.

Disparo em massa no WhatsApp API oficial, passo a passo

1. Clique em adicionar novo disparo, dê um nome e escolha a origem dos contatos.
2. Selecione a caixa de entrada ou as conexões. Se for uma caixa da API oficial, o sistema carrega os seus templates aprovados. Se for Evolution, você manda mensagem personalizada, sem template.
3. Configure o ritmo: delay mínimo e máximo, pausa a cada certo número de envios, horário permitido e dias da semana.
4. Escolha se quer spintax, follow-up automático e o formato de rotação.
5. Defina início imediato ou agende um dia e hora.
6. Escolha o template (ou monte a mensagem, com imagem, documento, áudio ou vídeo) e use as variáveis.
7. Confira o resumo e clique em criar disparo.

No fim, o disparador mostra um relatório com a hora de cada envio e se houve erro, e dá para exportar em CSV.

Os controles de ritmo e quando usar cada um

Na API oficial, mandar tudo de uma vez não é um problema técnico, porque você paga por envio. Mesmo assim eu recomendo um delay pequeno. Já nas APIs não oficiais, o ritmo é o que mais pesa.

Rotação entre números

Se você seleciona mais de uma conexão, o disparador distribui os envios de três jeitos:

• Round robin: segue a sequência, um envio por cada número, na ordem.
• Aleatório: o sistema decide por qual número vai cada envio.
• Por peso: você dá peso 1 para uma conexão e peso 2 para outra, e a de peso maior manda mais.

O peso serve quando um número aguenta mais volume que outro, ou quando você quer concentrar a campanha num número principal.

O lado honesto do disparo em massa

• Template não é garantia de aprovação. A Meta só aprova o que respeita as diretrizes do WhatsApp, e a aprovação pode levar alguns minutos. Crie o template antes de precisar dele.
• API oficial custa por mensagem. O disparador não cobra por envio, mas a Meta cobra. Campanha grande precisa de orçamento.
• API não oficial tem risco de bloqueio. Ela não paga a Meta, mas o número pode ser banido. Para operação séria, a oficial é o caminho. Se quiser ver jeitos de usar a API oficial no dia a dia, tem o artigo de estratégias com a API oficial.
• O módulo precisa estar liberado na conta. No Config extra você escolhe em quais empresas o disparador fica disponível. Se você revende, isso permite liberar só para quem contratou.

Antes de clicar em criar disparo

• Template aprovado e sincronizado
• Lista conferida (número com DDI e DDD, colunas com o nome certo)
• Custo estimado com a tabela da Meta
• Janela de horário e dias da semana definidos
• Teste feito com o seu próprio número antes da lista inteira

Perguntas frequentes

Como fazer disparo em massa no WhatsApp com a API oficial?

No disparador do AstraChat, você cria um disparo, escolhe a origem dos contatos, seleciona a caixa da API oficial, configura o ritmo de envio, escolhe um template aprovado e cria o disparo. No fim, um relatório mostra a hora de cada envio e os erros, com exportação em CSV.

Como criar template do WhatsApp sem entrar no painel da Meta?

No AstraChat, ao editar uma caixa de entrada da API oficial em Configurações > Caixas de entrada, há uma aba Templates. Você preenche nome, categoria, idioma e conteúdo, envia para a Meta e, depois de aprovado, usa o botão de sincronizar.

Quanto a Meta cobra por mensagem de disparo na API oficial?

A cobrança é da Meta, não da plataforma. Pela tabela oficial da Meta citada no artigo, no Brasil a mensagem de marketing custa cerca de R$ 0,32 e a de utilidade cerca de R$ 0,035, então uma campanha promocional para 1.000 contatos sai por volta de R$ 320.

Quanto tempo a Meta demora para aprovar um template?

Normalmente alguns minutos, e nesse período o template fica como pendente. A aprovação não é garantida, porque a Meta só aprova o que respeita as diretrizes do WhatsApp, então crie o template antes de precisar dele.

Dá para disparar mensagens para uma etapa do funil?

Sim. O disparador aceita três origens de contatos: planilha CSV, etiquetas e etapa do funil. Na opção por funil, você escolhe o Kanban e a etapa, e a mensagem vai para todos os leads que estão nela.

Disparador, templates e o resto no seu servidor

O disparador faz parte do AstraChat, a versão do Chatwoot da Astra Online que também traz Kanban, agentes de IA, ligações pelo WhatsApp, flows e chat interno, com white label e atendentes ilimitados, rodando no seu servidor.

Ele vem na Comunidade Astra Online, com código-fonte, atualizações, grupo VIP e a primeira instalação feita pelo especialista em Chatwoot Raphael Popiolek. Se você já tem um Chatwoot rodando e quer esses módulos nele, me chame no WhatsApp e me diga qual versão você usa.