## Visão geral

Follow-ups não vivem isolados: eles se conectam **nativamente** ao resto da plataforma. Uma cadência
pode ser **iniciada, pausada, retomada, pulada ou cancelada** por uma regra de **Automação**, por uma
**Macro** que o agente roda na conversa ou por um nó do **Flow Builder**. À medida que a cadência
avança, a plataforma **emite eventos** que disparam outras automações e são entregues aos seus
**webhooks** de integração. E, quando o **Maestro** está ativo, ele pode ler e operar follow-ups por
**ferramentas** próprias.

Em resumo: o follow-up é, ao mesmo tempo, **ação** (algo que outras regras executam) e **fonte de
eventos** (algo a que outras regras e sistemas reagem).

## Pré-requisitos

- Módulo de Follow-ups disponível na conta (recurso `follow_ups` habilitado).
- Para inscrever/operar via automação, macro ou fluxo: o módulo de **Automação/Flow** disponível.
- Para receber notificações em sistemas externos: um **endpoint de webhook** configurado na conta, já
  assinando os eventos desejados.
- Para as ferramentas de IA: o **Maestro** ativo na conta.

## Passo a passo

1. Crie uma **regra de automação** (ou edite uma existente).
2. Defina o **evento gatilho** da regra (por exemplo, uma cobrança que venceu ou um negócio que parou).
3. Em **ações**, escolha **Inscrever em follow-up** (`enroll_in_follow_up`) e selecione a sequência.
4. Opcionalmente, adicione **condições** por `follow_up_status` para agir só sobre quem já está (ou
   ainda não está) em cadência.
5. Salve e ative a regra. A partir daí, cada vez que o evento ocorre, a ação roda automaticamente.

## Configurações & opções

### As cinco ações de follow-up (automação, macro e fluxo)

As mesmas cinco ações estão disponíveis em **Automação**, **Macros** e **Flow Builder** e executam de
forma idêntica nos três lugares:

| Ação | O que faz |
|------|-----------|
| `enroll_in_follow_up` | Inscreve o alvo (contato/conversa) em uma sequência. |
| `cancel_follow_up` | Cancela a inscrição ativa. |
| `pause_follow_up` | Pausa a inscrição (sem enviar os próximos passos). |
| `resume_follow_up` | Retoma uma inscrição pausada. |
| `skip_follow_up_step` | Pula o passo atual e segue para o próximo. |

> Essas ações são **adicionadas** ao conjunto que a automação já tinha — nenhuma regra existente é
> afetada por elas.

### Os três campos de condição

Em uma regra disparada por evento de follow-up, você pode condicionar pelos campos:

| Campo | Para que serve |
|-------|----------------|
| `follow_up_status` | Estado da inscrição (ativa, pausada, concluída, saída, falha). |
| `follow_up_sequence_id` | A sequência específica em que o contato está inscrito. |
| `follow_up_enrolled_via` | Como o contato foi inscrito (manual, automação, evento, inatividade, IA, API). |

### Eventos e webhooks

Conforme a cadência roda, a plataforma emite eventos que servem tanto para **disparar automações**
quanto para **alimentar webhooks** da conta:

| Evento | Quando ocorre |
|--------|---------------|
| `follow_up_enrollment.created` | Uma inscrição foi criada. |
| `follow_up_enrollment.paused` | A inscrição foi pausada. |
| `follow_up_enrollment.resumed` | A inscrição foi retomada. |
| `follow_up_enrollment.exited` | A inscrição saiu por uma regra de saída (ex.: o contato respondeu). |
| `follow_up_enrollment.completed` | A inscrição chegou ao fim da sequência. |
| `follow_up_enrollment.failed` | A inscrição falhou. |
| `follow_up_step.sent` | Um passo foi enviado. |
| `follow_up_step.replied` | O contato respondeu a um passo. |
| `follow_up_step.skipped` | Um passo foi pulado. |
| `follow_up_step.failed` | O envio de um passo falhou. |

Os **payloads** desses webhooks carregam o **mínimo de dados pessoais** (identificadores de conta,
inscrição, sequência e passo, e o estado) — eles servem para sincronizar painéis e sistemas, não para
transportar o conteúdo das mensagens. Quando uma etapa de IA aguarda aprovação humana, há ainda uma
notificação interna de rascunho pendente.

### Ferramentas de follow-up do Maestro

Com o Maestro ativo, o assistente pode **ler e operar** follow-ups por ferramentas próprias, sempre
com um token do usuário e respeitando o recurso habilitado e as permissões:

- **Listar** sequências e inscrições.
- **Inscrever** um contato em uma sequência.
- **Pausar** e **retomar** uma inscrição.
- **Pular** o passo atual.
- **Aprovar** um rascunho de IA (HITL).
- **Cancelar** uma inscrição.

## Casos de uso

- **Negócio ganho no CRM** → uma automação roda `cancel_follow_up` para encerrar qualquer cadência
  ativa daquele contato (ninguém quer ser cobrado depois de fechar).
- **Cobrança vencida** → uma automação roda `enroll_in_follow_up` na sequência de "Cobrança".
- **Dashboards de integrador** → um sistema externo assina `follow_up_enrollment.*` e
  `follow_up_step.*` por webhook e monta seus próprios relatórios em tempo quase real.

## Dicas, limites e boas práticas

- Combine ações de follow-up com o evento certo: `cancel_follow_up` em eventos de conversão, e
  `enroll_in_follow_up` em eventos de risco (cobrança vencida, negócio parado, falta em agendamento).
- Use `follow_up_status` como condição para evitar inscrever duas vezes ou agir sobre quem já saiu.
- Trate os webhooks como **somente leitura de estado**: o conteúdo das mensagens não vem no payload.
- A mesma ação roda igual em automação, macro e fluxo — escolha o ponto de partida pela jornada, não
  pela capacidade.

## Solução de problemas

- **A ação não disparou**: confirme que a regra está **ativa**, que o **evento gatilho** realmente
  ocorreu e que as **condições** (inclusive `follow_up_status`) batem; verifique também se o recurso de
  follow-ups está habilitado na conta.
- **O webhook não chegou**: confira se o **endpoint** está configurado e acessível e se os **eventos**
  de follow-up estão de fato **assinados** naquele webhook.
- **A ferramenta do Maestro foi negada**: verifique se o recurso está habilitado, se o token do
  usuário é válido e se ele tem **permissão** para operar follow-ups.

## Veja também

- [Inscrição: manual, por automação, por evento e por inatividade](/hc/ajuda/articles/follow-ups-inscricao-pt-br)
- [Funil da cadência e regras de saída](/hc/ajuda/articles/follow-ups-funil-e-saida-pt-br)
- [Visão geral de Follow-ups e cadências](/hc/ajuda/articles/follow-ups-overview-pt-br)