Inscrever leads numa sequência

Depois de criar e ativar uma sequência, falta inscrever os leads que vão receber. Existem 4 formas de fazer isso no Syncro: manualmente pelo perfil do lead, via automação com gatilho, via formulário público no momento da captura, e em massa pra uma lista inteira.

Cada forma é melhor pra um caso. Esse artigo cobre as 4 e como funciona o comportamento de inscrição idempotente (o que acontece se você inscrever o mesmo lead 2 vezes).

Pré-requisitos

• A sequência precisa estar ativa pra aceitar inscrições.
• O lead precisa existir no CRM (mesmo sem WhatsApp/email).
• Pra envio via WhatsApp, o lead idealmente tem telefone cadastrado.

Forma 1 — Manual, pelo perfil do lead

A forma mais rápida pra casos pontuais.

1. Abra o perfil do lead (clica no nome dele na listagem ou no card do kanban).
2. No painel lateral, role até o card de sequências.
3. Se o lead não está em nenhuma sequência, aparece um botão Inscrever em sequência (com borda azul tracejada).
4. Clique. Abre um popover com:

• Dropdown Escolha uma sequência (mostra só sequências ativas)
• Botões Cancelar / Inscrever

5. Escolha a sequência desejada.
6. Clique em Inscrever.
7. Aparece o feedback Lead inscrito em "{nome da sequência}"..
8. Volta ao perfil do lead e o card mostra um banner verde "Sequência: {nome}" com o progresso "Step 1/N".

Múltiplas sequências no mesmo lead

Um lead pode estar em mais de uma sequência simultaneamente. Cada uma roda independente. Use isso pra:

• Combinar fluxos — sequência de onboarding + sequência de upsell rodando em paralelo
• Testar A/B — lead em duas variações pra comparar resultado (cuidado pra não saturar)

⚠️ Atenção: sequências paralelas mandam mensagens independentes. Se as duas têm passos com 0 minutos de delay, o lead recebe mensagens duplicadas. Cuide pra os horários não colidirem.

Lead já está na sequência

Se você tentar inscrever um lead que já está ativo na mesma sequência, vai aparecer "O lead já está nessa sequência.". O Syncro não duplica.

Se o lead estava na sequência mas saiu (paused / completed / exited), inscrever de novo revive a inscrição: status volta pra active, started_at é resetado, e ele começa do passo 1 de novo. É o comportamento idempotente — não cria registro duplicado, só re-aproveita.

Forma 2 — Via automação (gatilho)

Pra escalar inscrições com base em eventos do CRM, use uma automação com a action Inscrever em sequência.

Exemplos comuns de gatilho → ação:

• Lead criado → inscreve em "Sequência de boas-vindas"
• Tag X adicionada → inscreve em "Sequência de upsell"
• Lead chega em etapa Qualificação → inscreve em "Sequência de educação"
• Lead vira Sale → inscreve em "Sequência de onboarding pós-venda"

Setup:

1. Acesse Configurações → Automações.
2. Crie nova automação ou edite uma existente.
3. Configure o gatilho (lead created, tag added, stage entered, sale closed, etc).
4. Adicione a action Inscrever em sequência.
5. No dropdown, escolha a sequência desejada.
6. Salve a automação e ative-a.

A partir daí, toda vez que o gatilho dispara, o lead vai ser inscrito automaticamente na sequência.

Forma 3 — Via formulário público

Quando o lead preenche um formulário Syncro (clássico, conversacional ou multi-step) e você configurou enroll_sequence como ação pós-envio, o lead novo é automaticamente inscrito depois que o registro de Lead é criado.

Setup:

1. Edite o formulário em Formulários → {seu form} → Configurações.
2. Em Pós-envio, adicione a ação Inscrever em sequência.
3. Escolha a sequência desejada.
4. Salve.

Veja Criar um formulário pra mais detalhes.

Forma 4 — Em massa, via API ou ações em lote

Pra inscrever dezenas ou centenas de leads de uma vez, use uma das opções:

Endpoint de enroll em massa

A rota interna POST /sequences/{sequence}/enroll aceita um array de lead_ids. Cada lead é processado em paralelo.

Hoje a UI não tem um botão de "Inscrever toda essa lista" — você usa via API com seu próprio token, ou pede pra suporte.

Importação manual + automação

Alternativa low-code:

1. Importe os leads via CSV (veja Importar contatos) com uma tag específica (ex: import-set-2026-04).
2. Crie uma automação com gatilho tag adicionada = import-set-2026-04 + action enroll_sequence.
3. Toda vez que importa um lote com essa tag, eles entram na sequência.

O que acontece bem na hora da inscrição

Pra cada lead inscrito:

1. O Syncro cria ou revive uma LeadSequence com:

• status='active'
• current_step_position = posição do primeiro passo da sequência
• next_step_at = now + delay_minutes do primeiro passo
• started_at = now

2. Incrementa o contador stats_enrolled da sequência.
3. O cron sequences:process (que roda a cada minuto) vai pegar esse lead na próxima execução em que next_step_at já tiver passado.
4. Quando o passo é executado, o Syncro:

• Manda a mensagem (se for tipo message)
• Avança pra próximo passo programado
• Ou completa a sequência se era o último passo

Verificando inscrições ativas

No perfil do lead, você sempre vê quais sequências o lead está participando ativamente. Aparecem como banners verdes com:

• Nome da sequência
• Posição atual (Step 2/5)
• Botão Remover da sequência (vermelho)
• Link editar pra abrir a sequência

Se o lead tem múltiplas inscrições ativas, aparecem múltiplos banners empilhados.

Limites de inscrição

Não há limite por sequência — você pode ter milhares de leads ativos na mesma sequência. O cron processa 100 passos por execução (1x por minuto), então sequências com volume muito alto podem ter atraso de alguns minutos no processamento.

Próximo passo

Veja Pausar, retomar e sair pra entender como o lead sai da sequência (manualmente ou automaticamente) e o que acontece com inscrições "fantasmas".

Artigos relacionados

• Criar uma sequência de nurturing
• Passos da sequência (mensagem, espera, ação)
• Pausar, retomar e sair de uma sequência
• Automações
• Criar um formulário