"Disparos: como funciona"
Disparos é o envio em massa de mensagens de modelo (template) pelo WhatsApp — avisos, cobranças, confirmações, pesquisas. Você escolhe para quem (um grupo de contatos ou uma fonte externa), o que sai (um template aprovado pela Meta) e quando (agora, numa data ou repetindo), e a plataforma cuida da fila, do ritmo, dos recibos e das respostas.
O menu Disparos tem quatro telas: Campanhas (criar e acompanhar), Templates (os modelos aprovados do número), Processamento (filas, falhas e avisos para outros sistemas) e Blacklist (quem não pode receber). Os grupos de destinatários ficam em Contatos › Grupos de disparo.
O que precisa existir antes
- Um número de WhatsApp atendendo o tenant. Campanha sai por um número que atende a conta. Quem cuida do número é o BSP › Números: em Quem atende este número escolha o tenant. Se o número já atende outro tenant, a tela pergunta se quer mover — o canal antigo é desligado (o histórico fica) e o novo passa a receber e a disparar.
Um número atende um tenant só; trocar pergunta antes

- Um assistente com fluxo publicado. Quem responder à campanha é atendido por ele. A campanha Completa ainda exige um bloco Início por API no fluxo — é nele que a resposta cai, com as variáveis da campanha no contexto.
- Templates aprovados na Meta para esse número. A tela Templates lista o catálogo; dá para criar e enviar para aprovação por ali.
O caminho de uma campanha
- Grupo — importe a planilha (ou aponte uma fonte via API). Com modelo, a planilha traz uma coluna por variável do template.
- Campanha — Tipo → Identificação → Para quem → Mensagem → Quando → Conferir. Antes de largar dá para mandar um teste para um telefone.
- Acompanhar — situação, enviados, entregues, lidas, responderam; um disparo por telefone, com a linha do tempo de cada um; as respostas por botão.
- Falhas — o que a Meta recusou aparece em português, com o código; dá para reenviar um disparo ou tratar a fila sem saída em Processamento.

Simples ou Completa
- Simples: dispara o modelo e encerra. Quem responder é atendido pelo assistente do número, do começo — como qualquer pessoa que chama.
- Completa: arma a resposta num fluxo. Quem tocar no botão do template continua de onde a mensagem parou, com {{nome}}, {{campanha}}, as variáveis do modelo ({{1}}, {{2}}…) e {{texto}} (o botão tocado) no contexto.
Regras que a plataforma aplica sozinha
- Blacklist no momento do disparo: número bloqueado aparece como Bloqueado e nada sai.
- Variáveis: se o modelo pede variáveis que o grupo não tem, o assistente de campanha avisa antes de deixar seguir — sem isso a Meta recusaria contato por contato depois da largada.
- Ritmo: 20 mensagens por segundo, padrão da plataforma; o fornecedor ainda aplica o teto dele por cima, e o worker reduz sozinho se a fila apertar.
- Marketing: no máximo 2 mensagens de marketing consecutivas por pessoa em 24 h (regra do WhatsApp). Modelos de utilidade não entram nessa conta.
Quem pode o quê
disparos é um recurso da matriz em Administração › Acesso (ver / gerenciar por papel), e só aparece lá quando a instalação tem o módulo ligado.
O que a pessoa faz | Permissão que isso exige |
|---|---|
Ver campanhas, situação, respostas, modelos, blacklist e processamento | disparos › ver |
Criar campanha, agendar, disparar, pausar, arquivar | disparos › gerenciar |
Importar grupo de destinatários, cadastrar fonte via API | disparos › gerenciar |
Editar a blacklist, criar ou submeter modelo, decidir a DLQ | disparos › gerenciar |
Atender quem respondeu à campanha | atendimento — é uma conversa como qualquer outra |
Padrão de fábrica: Admin gerencia, Supervisor só vê, Atendente não vê. O supervisor acompanha a campanha em curso, mas largar uma mensagem para uma lista inteira é decisão de quem responde pela operação — o admin libera Gerenciar na matriz se a operação quiser.
Além da matriz, o módulo precisa estar ligado na instalação (tag DISPAROS_ENABLED, features.disparos no console) e o plano ou a licença trazer o recurso disparos; faltando qualquer um, a resposta é "campanhas não estão liberadas neste plano".