Como criar uma campanha de disparo

Disparo em massa é a forma de mandar uma campanha pra centenas/milhares de leads de uma vez. O Syncro guia você por um wizard de 4 passos que coleta tudo necessário: quem recebe, qual mensagem (com variações pra reduzir risco de banimento), ritmo de envio e quando começar.

Pré-requisitos

• Permissão de admin ou manager.
• Lista de leads criada (estática ou dinâmica). Veja Listas de contatos.
• Pelo menos 1 número WhatsApp conectado (QR Code ou Cloud API).
• Plano com slot de campanha disponível (varia por plano).

Acessar a página

1. Acesse Disparos no menu lateral (rota /disparos).
2. Você vê o painel Disparos em massa com:

• KPIs do dia: Enviadas hoje / Falhas hoje / Em execução / Pendentes.
• Lista de campanhas existentes com status (Rascunho / Agendada / Em execução / Pausada / Concluída / Cancelada).
• Botão Novo disparo no canto superior direito.

3. Clique em Novo disparo pra abrir o wizard.

Passo 1 — Quem vai receber

Define lista de destinatários e número WhatsApp que vai disparar.

Campos:

• Nome da campanha (obrigatório, máx 200 chars): identificador. Ex: Promoção Black Friday 2026, Reaquecimento Q4, Lançamento produto X.
• Lista de leads: dropdown das listas existentes (mostra count de leads em cada).
• Número do WhatsApp: dropdown das instâncias conectadas (status connected).
• Se não há instância conectada, aparece aviso: "Nenhuma instância conectada. Conecte um número em Configurações → Integrações."

💡 Dica: prefira listas estáticas pra disparos pontuais (membros fixos no momento da criação). Listas dinâmicas podem entrar/sair leads no meio da execução.

Passo 2 — Mensagem

Configura a mensagem que será enviada com variações anti-banimento.

Tipo de mensagem

• Somente texto — mensagem simples com formatação WhatsApp.
• Imagem + legenda — envia foto e texto vai como caption abaixo.

Se escolher imagem:

• Drop zone ou clique pra upload.
• Formatos: JPG, PNG, WEBP.
• Tamanho máximo: 5 MB.
• Preview da imagem aparece após upload.

Variações de mensagem

⚠️ Atenção: você precisa de mínimo 3 variações distintas. É regra anti-banimento — disparos com mensagem idêntica são facilmente detectados pela Meta como spam e podem causar bloqueio do número.

Cada variação é um texto que pode usar:

Formatação WhatsApp:

• *texto* → negrito
• _texto_ → itálico
• ~texto~ → tachado
• `texto` → monoespaçado

Variáveis dinâmicas (clica nos chips pra inserir):

• {{name}} — Nome completo do lead
• {{first_name}} — Primeiro nome
• {{company}} — Empresa
• {{email}} — Email
• {{phone}} — Telefone

Exemplo de 3 variações:

1. Oi {{first_name}}! Tudo bem? Aqui é da [Empresa]. Estamos com promoção...

2. Olá {{first_name}}, espero que esteja bem. Da [Empresa] aqui — temos novidades...

3. {{first_name}}, oi! Passando rapidinho da [Empresa] pra te contar de uma oferta...

Veja Variações de mensagem pra detalhes do algoritmo de validação.

Preview iPhone

Painel lateral mostra preview ao vivo estilo WhatsApp:

• Topbar com nome do lead exemplo + status "online".
• Bolha verde com a mensagem renderizada (formatação WhatsApp aplicada visualmente).
• Tabs entre variações — clique numa pra ver como cada uma fica.

💡 Dica: revise cada variação no preview. Use tom natural e diferente entre elas — clientes que receberem podem comparar (em casos raros).

Passo 3 — Ritmo de envio

Define velocidade do disparo e regras de batch.

Presets prontos

Escolha um dos 3 presets pré-configurados (recomendado pra começar):

Veja Presets explicados pra detalhes.

Configuração avançada (opcional)

Se você quer customizar (ex: usar números intermediários):

• Intervalo mínimo (segundos) — mín 10s. "Mínimo 10s por regra anti-banimento."
• Intervalo máximo (segundos) — deve ser ≥ ao mínimo.
• Lote (qtd mensagens) — quantas mensagens antes de pausar.
• Pausa entre lotes (segundos) — 0 ou ≥ 60s.
• Limite diário (opcional) — Ex: "50/dia primeira semana, 150/dia depois" pra números novos.
• Respeitar janela 24h (Cloud API) — leads sem mensagem inbound nas últimas 24h são pulados (Meta bloqueia texto livre fora da janela).

Avisos

⚠️ Atenção: disparo em massa sempre tem risco de banimento do número. Quanto mais conservador o ritmo, menor o risco. Números novos (menos de 7 dias de uso) devem usar Conservador.

Passo 4 — Quando começar

Define se a campanha inicia imediatamente ou em horário agendado.

Opções:

• Começar agora — campanha inicia ao confirmar.
• Agendar início — escolhe data e hora específicas (datetime-local input).

Resumo da campanha

Ao chegar no passo 4, sistema calcula automaticamente:

• Total de leads na lista
• Quantos receberão (com phone válido)
• Quantos serão pulados (telefone inválido ou sem)
• Início estimado (now ou data agendada)
• Término estimado (cálculo baseado em quantidade × intervalo + pausas)

Confirmar e criar

1. Após preencher tudo, clique em Criar campanha.
2. Sistema valida:

• 3+ variações com similaridade <90%.
• Intervalo mínimo ≥ 10s.
• Imagem (se tipo=image) presente.
• Lista, instância e nome obrigatórios.

3. Se OK:

• Cria a campanha com status 'scheduled' (se agendada) ou 'running' (agora).
• Gera recipients pra cada lead (com rendered_body pré-renderizado pra cada variação).
• Enfileira jobs com delay calculado conforme ritmo configurado.

4. Você é redirecionado pro dashboard da campanha pra acompanhar.

Validações comuns

"São necessárias pelo menos 3 variações de mensagem"

Adicione mais variações. Mínimo 3.

"Variações muito similares"

Sistema usa Levenshtein normalizada — duas variações com >90% de similaridade são rejeitadas. Reescreva com mais diferenças.

"Intervalo mínimo deve ser pelo menos 10 segundos"

Não dá pra disparar mais rápido que 10s/mensagem.

"Envie uma imagem quando tipo é imagem + legenda"

Se você marcou tipo=image, upload de imagem é obrigatório.

"Nenhuma instância conectada"

Conecte um WhatsApp em Configurações → Integrações primeiro.

Jobs de envio

Por trás dos panos:

1. Cada recipient ganha um job SendMassMessageJob enfileirado.
2. Jobs vão pra fila mass (worker dedicado syncro_worker-mass).
3. Cada job é delayed pra horário calculado (Redis sorted set).
4. Worker processa conforme delay vence.

Isso permite disparos longos (8h, 24h) rodando consistentemente em background sem você precisar manter algo aberto.

Limites e cuidados

Limite de plano

A quantidade máxima de campanhas pode ser controlada pelo plano. Se atingiu, faça upgrade ou aguarde campanhas existentes terminarem.

Tamanho da lista

Não há limite formal. Mas listas com >10.000 leads podem demorar muitas horas pra processar (depende do ritmo). Considere dividir em sub-listas menores pra acompanhamento mais granular.

Mídia em campanhas

Imagem é mesma pra todos (não há variação de imagem). Apenas o texto varia entre as 3+ variações.

Próximos passos

• Pra entender as regras anti-banimento, veja Regras anti-banimento.
• Pra acompanhar a campanha rodando, veja Acompanhar tempo real.

Artigos relacionados

• Regras anti-banimento
• Variações de mensagem
• Presets explicados
• Listas de contatos