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
- Publique o fluxo que deseja disparar.
- 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.
- 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.
- Passo 2 — Conversa: escolha como resolver a conversa (veja Configurações & opções).
- 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.
- 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:
- Crie o disparo normalmente (fluxo publicado, público, cadência) mas deixe como rascunho — não lance.
- Em Automação, crie uma regra e adicione a ação Lançar disparo em massa, escolhendo o rascunho.
- 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.