## Visão geral

O **Disparo em massa** (aba **Disparos** do Flow Builder) executa **um fluxo publicado** contra uma
audiência inteira, um sujeito de cada vez, respeitando a janela de 24h/HSM do WhatsApp e um controle de
cadência para evitar bloqueio do número.

Enquanto uma execução manual roda o fluxo para **uma** conversa, o disparo em massa:

- resolve **quem** vai receber (5 famílias de público);
- resolve automaticamente a **conversa** de cada contato (reutiliza a existente ou cria uma nova) para
  que **todos os nós funcionem** — mensagens **e** ações;
- **goteja** os envios com throttle anti-bloqueio, horário de silêncio e dias úteis;
- mostra um **funil** por status (iniciado / pendente / ignorado / falhou) e permite **pausar,
  retomar, cancelar e retentar** as falhas.

## Pré-requisitos

- O módulo **Flow Builder** habilitado na conta.
- Um **fluxo publicado** (rascunhos não podem ser disparados).
- Uma **caixa de entrada** de envio (normalmente WhatsApp).
- Perfil de **administrador** para criar e lançar disparos (agentes podem visualizar e acompanhar).

## Passo a passo

1. Publique o fluxo que deseja disparar.
2. Abra o fluxo na lista e clique em **Executar em massa** (ícone de avião) — ou vá à aba **Disparos**
   e clique em **Novo disparo** e escolha o fluxo publicado.
3. **Passo 1 — Público**: escolha a caixa de envio e a família de público:
   - **Contatos**: todos, por **etiqueta** (aplicada ao contato) ou por **segmento salvo**.
   - **Conversas**: todas, por **filtro salvo** (uma Pasta) ou por **etiqueta da conversa** — nos modos
     **todas** e **por etiqueta** ainda dá para escolher a **situação** (todas, abertas, pendentes,
     adiadas, resolvidas). Também é a única família que aceita **um alvo por conversa** (veja abaixo).
   - **Negócios do CRM**: um **funil** e, opcionalmente, uma **etapa**.
   - **Empresas**: um **segmento salvo** de empresas ou **empresas específicas**.
   - **Lista importada**: cole números (um por linha ou vírgula/CSV) e clique em **Importar números**.
4. **Passo 2 — Conversa**: escolha como resolver a conversa (veja *Configurações & opções*).
5. **Passo 3 — Cadência**: ajuste o limite anti-bloqueio, o gotejamento, o horário de silêncio, os dias
   úteis e, se quiser, agende o início.
6. **Passo 4 — Revisão**: confira a **contagem estimada** e confirme. O disparo começa a gotejar e
   você acompanha o funil na aba **Disparos**; clique em um disparo para ver os alvos um a um.

## Configurações & opções

**Público** (passo 1):

- **Etiqueta do contato × etiqueta da conversa**: são dois lugares diferentes. Uma etiqueta aplicada a
  uma **conversa** não fica no **contato** — por isso existe o modo **Por etiqueta** dentro da família
  **Conversas**. Se o público deu **zero** usando etiqueta em **Contatos**, é quase sempre esse o motivo.
- **Situação da conversa**: aplica-se aos modos **todas** e **por etiqueta** da família Conversas — nos
  dois dá para estreitar por situação sem criar um filtro salvo antes. **Todas** é o padrão.
- **CRM — só negócios abertos**: ganhos, perdidos e arquivados não entram no público.
- **Empresas — todo mundo, não só o principal**: inclui o contato principal e os demais vinculados por
  participação na empresa.
- **Onde criar cada lista salva**: segmentos de **contatos** em **Contatos → Filtrar → Salvar
  segmento**; **Pastas** de conversas em **Conversas → Filtrar → salvar**; segmentos de **empresas** em
  **Empresas → filtro → salvar**.
- **União**: entradas diferentes se somam e um contato alcançado por mais de um critério entra **uma
  única vez**.

**Política de conversa** (passo 2):

- **Automática**: reutiliza a conversa mais recente do contato na caixa escolhida ou cria uma nova.
  Nós de **mensagem e de ação** funcionam. É a opção recomendada para a maioria dos casos.
- **Apenas reutilizar**: só dispara para contatos que **já têm** uma conversa aberta; os demais são
  **ignorados** (aparecem como *ignorado* no funil).
- **Apenas ações**: nenhuma conversa é criada. Nós de **mensagem são ignorados** e apenas os **nós de
  ação** rodam (ex.: adicionar contato, etiquetar, chamar uma API).

**Cadência** (passo 3):

- **Limite anti-bloqueio**: teto de envios por segundo e por hora por caixa. Deixe em branco para os
  padrões seguros do provedor (WhatsApp Cloud/Web). Ao estourar o limite, o disparo **adia** e re-tenta
  — nunca perde um alvo.
- **Gotejamento**: N alvos por intervalo (em segundos), para espaçar ainda mais que o limite anti-bloqueio.
- **Horário de silêncio** e **dias úteis**: fora da janela permitida nada é disparado; o próximo tick
  retoma quando a janela reabre.
- **Agendar início**: comece o disparo em uma data/hora futura — ele fica **agendado** e a plataforma o
  materializa e começa a gotejar sozinha no horário marcado.

**Ações em massa na lista** (aba **Disparos**): selecione vários disparos de uma vez e **pause, retome,
cancele, retente as falhas** ou **exclua** em lote — para operar muitos disparos sem abrir um a um.

## Modo de alvo e reaproveitamento de conversa

Duas escolhas do assistente decidem **em que** o fluxo roda. Elas são independentes da política de
conversa do passo 2: a política decide **se** uma conversa é reutilizada ou criada; estas duas decidem
**qual**.

**Modo de alvo** (passo 1, logo abaixo do público):

- **Um alvo por contato** (padrão): cada pessoa recebe o fluxo **uma vez**, na conversa que o disparo
  resolver para ela. É o comportamento de sempre.
- **Um alvo por conversa**: o fluxo roda **em cada conversa que casou com o filtro**. Quem tem três
  conversas correspondentes é atendido nas três, e cada execução age **sobre a conversa que casou** —
  não sobre "a conversa mais recente daquela pessoa". É o que você quer quando o assunto está na
  **conversa** (uma etiqueta de atendimento, uma pasta de pendências) e não na pessoa.

Um alvo por conversa só fica disponível quando **todo** o público vem da família **Conversas**.
Contatos, negócios do CRM, empresas e listas importadas não trazem uma conversa correspondente para
rodar — nesses casos a opção aparece desabilitada, com o motivo ao lado.

**Reaproveitamento de conversa** (passo 2, abaixo da política):

- **Preferir conversa em aberto** (padrão): reutiliza a conversa **aberta ou adiada** mais recente do
  contato naquela caixa. Sem nenhuma, cai para a mais recente de qualquer situação. Evita reabrir um
  assunto já resolvido e enterrar o disparo no fim de um histórico antigo.
- **Sempre a mais recente**: reutiliza a **última** conversa do contato naquela caixa, mesmo que já
  esteja resolvida. É o comportamento anterior, mantido para quem depende dele.

O reaproveitamento só decide qual conversa **existente** é reutilizada. Quando o disparo roda com **um
alvo por conversa**, cada alvo já vem carimbado com a conversa que casou, e a preferência não se
aplica a ele.

**Todas as conversas com situação**: no público **Conversas → Todas** também dá para estreitar por
**situação** (todas, abertas, pendentes, adiadas, resolvidas), sem precisar criar um filtro salvo antes.

As duas escolhas aparecem na **revisão** antes de confirmar e continuam visíveis depois de lançado:
abra o disparo na aba **Disparos** e elas ficam no topo, junto do funil.

## Lançar por regra de automação (run_flow_batch)

Além de lançar manualmente, você pode disparar um **rascunho de disparo já preparado** a partir de uma
**regra de automação** — o análogo em massa da ação "Iniciar fluxo". Toda a configuração pesada (fluxo,
caixa, público, cadência) fica no rascunho; a ação apenas dispara o lançamento.

Como usar:

1. Crie o disparo normalmente (fluxo publicado, público, cadência) mas **deixe como rascunho** — não lance.
2. Em **Automação**, crie uma regra e adicione a ação **Lançar disparo em massa**, escolhendo o rascunho.
3. Quando o gatilho da regra disparar, o rascunho é **lançado** e passa a gotejar como qualquer disparo.

**Proteção anti-loop**: só um disparo **em rascunho** é lançado, e o lançamento é de mão única
(rascunho → agendado). Assim, mesmo que a regra acione a ação várias vezes (ex.: um gatilho por conversa),
o disparo é lançado **exatamente uma vez** — as chamadas seguintes encontram um disparo já lançado e são
ignoradas com segurança.

## Casos de uso

- **Corrigir/atualizar contatos** em massa com um fluxo de ação (ex.: adicionar um contato ao WhatsApp).
- **Reengajar** um segmento salvo ou uma etiqueta com uma mensagem de retorno.
- **Aquecer um funil do CRM**: disparar um fluxo para todos os negócios abertos de uma etapa.
- **Campanha a partir de uma lista** colada (planilha/CSV) sem precisar cadastrar cada contato antes.
- **Retomar quem foi etiquetado no atendimento**: dispare para a etiqueta aplicada às **conversas**,
  opcionalmente só nas **resolvidas**.
- **Falar com um grupo de empresas**: alcance todas as pessoas ligadas às contas escolhidas.

## Dicas, limites e boas práticas

- Mantenha o **limite anti-bloqueio ligado** — o WhatsApp bane números que enviam rápido demais.
- Comece com um disparo **pequeno** em uma caixa de teste antes de rodar para toda a base.
- Um contato **sem telefone** (em caixa WhatsApp) é **ignorado**, não falha o lote.
- O disparo é **retomável e idempotente**: pausar/retomar não duplica; um mesmo contato aparece **uma
  vez** por disparo.
- A audiência tem um teto de segurança; audiências muito grandes são truncadas (registrado no disparo).

## Solução de problemas

- **"Fluxo não publicado"**: publique o fluxo antes de disparar.
- **Muitos "ignorados"**: verifique a política de conversa (*apenas reutilizar* ignora quem não tem
  conversa) e se os contatos têm telefone.
- **Contagem estimada 0 com etiqueta**: você provavelmente escolheu **Contatos → Por etiqueta** para
  uma etiqueta que está nas **conversas**. Troque para **Conversas → Por etiqueta**.
- **Segmento não aparece**: cada família lê a sua própria lista salva — Pastas de conversas não
  aparecem entre os segmentos de contatos, e vice-versa.
- **Muitos "falhou"**: abra o disparo, veja o motivo por alvo e use **Retentar falhas** após corrigir.
- **Disparo parado**: confira se está em **horário de silêncio** ou fora dos **dias úteis** — ele
  retoma sozinho na próxima janela.

## Veja também

- [Flow Builder: construir fluxos conversacionais visualmente](/hc/ajuda/articles/automation-flows-flow-builder-pt-br)
- [Flow Builder na prática: sessões, versões, relatórios e conexões de banco](/hc/ajuda/articles/automation-flows-flow-builder-operacao-pt-br)
- [Follow-ups (cadências de reengajamento)](/hc/ajuda/articles/follow-ups-overview-pt-br)
- [Definir o público da campanha](/hc/ajuda/articles/campaigns-campaign-audience-pt-br)