---
title: "Disparos: como funciona"
slug: aura/disparos-como-funciona
createdAt: 2026-11-19T14:33:14.557Z
---

**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

1. **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.
   :inlineImage[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/xU-XbY4nr_jUe2tlctFdu_3fd6d8510a84e4afd4904b5869701de9.jpg" alt="Um número atende um tenant só; trocar pergunta antes" caption size="160" width="1600" height="1000"} *Um número atende um tenant só; trocar pergunta antes*
2. **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.
3. **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

1. **Grupo** — importe a planilha (ou aponte uma fonte via API). Com modelo, a planilha traz uma coluna por variável do template.
2. **Campanha** — Tipo → Identificação → Para quem → Mensagem → Quando → Conferir. Antes de largar dá para **mandar um teste** para um telefone.
3. **Acompanhar** — situação, enviados, entregues, lidas, responderam; um disparo por telefone, com a linha do tempo de cada um; as respostas por botão.
4. **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.

:inlineImage[]{src="https://api.archbee.com/api/optimize/pu5VMc-2TW3GQX4ly5Xp7/M6kG2crymtMvr1qovZTtQ_3133f9b0b5120c1b8739eff724e6ac1f.jpg" alt="Campanhas: indicadores, recortes por situação e a lista" caption size="160" width="1600" height="1000"} *Campanhas: indicadores, recortes por situação e a lista*

## 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"*.
