> ## Documentation Index
> Fetch the complete documentation index at: https://help.vistum.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Mover lead no pipeline automaticamente

> Deixe a automação organizar seu funil — aplicar tag, criar card e mover o lead de etapa sem você arrastar nada na mão.

## A ideia

Em vez de você arrastar cada lead pelo funil manualmente, a automação faz isso por você. Quando algo acontece (uma compra, uma resposta, uma palavra-chave), ela **aplica uma tag**, **cria um card** no pipeline e **move o lead** para a etapa certa.

Isso mantém seu funil sempre atualizado e ninguém esquece de mover ninguém.

## Onde isso é configurado

Essas tarefas ficam no bloco **Ação**. Dentro dele você escolhe o que fazer com o lead:

| Ação no CRM              | O que faz                                                                           |
| ------------------------ | ----------------------------------------------------------------------------------- |
| Adicionar tag            | Marca o contato (ex.: `cliente`, `quente`)                                          |
| Remover tag              | Tira uma marcação                                                                   |
| Mover de etapa           | Leva o card para outra etapa do pipeline                                            |
| Criar card               | Cria uma negociação no pipeline                                                     |
| Atribuir atendente       | Define o responsável — **menos ocupado** ou **round-robin** (veja abaixo)           |
| Rotear para departamento | Direciona o card/conversa para a fila de um departamento (ex.: Suporte, Financeiro) |
| Notificar atendente      | Avisa o responsável                                                                 |
| Atualizar contato        | Grava informações no cadastro                                                       |
| Adicionar nota           | Deixa uma anotação no contato                                                       |

## Como a automação escolhe quem recebe o lead

A ação **Atribuir atendente** tem duas formas de decidir automaticamente:

| Modo                               | Como funciona                                                                                                                              | Quando usar                                                                             |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------- |
| **Menos ocupado**                  | O Vistum olha quantas conversas/negócios cada atendente do time já tem em aberto agora e manda para quem está com menos carga.             | Times onde o volume de trabalho varia bastante entre as pessoas.                        |
| **Round-robin (rotação em ordem)** | O Vistum segue uma fila fixa — o 1º lead vai para o atendente A, o 2º para o B, o 3º para o C, e o 4º volta para o A — sempre nessa ordem. | Times parecidos entre si, quando você quer uma divisão estritamente igual e previsível. |

<Note>
  Veja a explicação completa, com exemplos práticos, em [Atribuição e roteamento de atendentes](/automacoes/atribuicao-e-roteamento) — incluindo a diferença entre atribuir dentro de um fluxo (já funciona) e o roteamento automático por departamento (ainda não disponível).
</Note>

## Exemplo: compra aprovada vira cliente no funil

Um fluxo típico de pós-venda que organiza o lead sozinho:

<Steps>
  <Step title="Gatilho: compra aprovada">
    Use o gatilho **Webhook recebido (compra de plataforma)** com a Hotmart (ou outra). Veja [Automação de compra aprovada da Hotmart](/automacoes/hotmart).
  </Step>

  <Step title="Ação: aplicar a tag cliente">
    Adicione um bloco **Ação → Adicionar tag** e escolha `cliente`. Assim você separa facilmente quem já comprou.
  </Step>

  <Step title="Ação: criar o card">
    Adicione **Ação → Criar card** e escolha o pipeline (ex.: "Pós-venda"). O Vistum cria a negociação já com os dados do comprador.
  </Step>

  <Step title="Ação: mover de etapa">
    Adicione **Ação → Mover de etapa** e leve o card para **"Cliente ativo"** (ou a etapa que fizer sentido no seu funil).
  </Step>

  <Step title="Publique">
    Clique em **Publicar**. A partir de agora, cada venda entra, é marcada e parada na etapa certa — sozinha.
  </Step>
</Steps>

> Resumindo o fluxo: **Compra aprovada → aplicar tag `cliente` → criar card → mover para "Cliente ativo"**.

## Outro exemplo: lead quente sobe de etapa

Você pode reagir ao comportamento do lead:

> **Palavra-chave "quero comprar" → aplicar tag `quente` → mover card para "Negociação" → notificar o atendente responsável**

Assim o vendedor recebe o lead já na etapa certa e com aviso na hora.

## Quando "Mover de etapa" aparece como falha

<Warning>
  **Mover de etapa** precisa encontrar um **card já associado ao contato** no pipeline (a busca é feita pelo telefone). Quando não existe esse card, a ação **aparece como falha** na aba **Execuções** — não é bug, é o Vistum avisando que não tinha para onde mover. Se o contato ainda pode não ter card, coloque um **Criar card** antes do **Mover de etapa**.

  **Criar card** funciona diferente: ele **cria** um card novo, então não depende de nenhum card anterior. Ele só falha se a **etapa de destino** não existir (por exemplo, foi renomeada ou apagada). Já ações como adicionar tag ou atualizar contato **pulam em silêncio** quando não encontram o que precisam, sem marcar erro.
</Warning>

<Tip>
  Se você vir uma execução marcada como "falha" por causa de **Mover de etapa**, confira se o contato já tem um card no pipeline antes desse passo. Muitas vezes o fluxo precisa de um bloco **Criar card** antes de um **Mover de etapa** — nessa ordem.
</Tip>

## Dicas

<Tip>
  Combine **mover de etapa** com **atribuir atendente** para que cada lead novo já caia com um responsável definido.
</Tip>

<Warning>
  Antes de **mover de etapa**, confirme que a etapa de destino existe no pipeline escolhido. Se você renomear ou apagar a etapa depois, lembre de atualizar a automação.
</Warning>

## Acompanhe o resultado

Tudo o que a automação fez aparece na linha do tempo de cada contato em **Execuções**: "Tag adicionada", "Card criado", "Movido para Cliente ativo". Veja [Ver histórico e erros](/automacoes/execucoes).

## Próximos passos

* [Atribuição e roteamento de atendentes](/automacoes/atribuicao-e-roteamento)
* [Criar tarefa automática para o atendente](/automacoes/criar-tarefa)
* [Exemplos prontos de automações](/automacoes/exemplos-prontos)