> ## Documentation Index
> Fetch the complete documentation index at: https://docs.leavo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Visão Geral

> Configuração de follow-up automático com IA e templates oficiais

## O que é Follow-up?

Follow-up é um sistema de reengajamento automático que envia mensagens para leads após um período de inatividade. Cada assistente pode ter sua própria configuração de follow-up.

<CardGroup cols={2}>
  <Card title="Follow-up com IA" icon="brain">
    A IA gera a mensagem automaticamente baseada no contexto da conversa e no prompt configurado.
  </Card>

  <Card title="Follow-up com Template" icon="file-lines">
    Para intervalos acima de 24h, utiliza templates oficiais do WhatsApp Business (Meta/Gupshup).
  </Card>
</CardGroup>

## Como funciona

<Steps>
  <Step title="Gatilho por Status">
    O follow-up é ativado quando o lead muda para um dos status configurados em `trigger_status_ids`.
  </Step>

  <Step title="Aguarda Intervalo">
    O sistema aguarda o intervalo definido no step (ex: 30 minutos, 2 horas, 1 dia).
  </Step>

  <Step title="Envia Mensagem">
    Dependendo do intervalo: gera com IA (\< 24h) ou envia template oficial (>= 24h).
  </Step>

  <Step title="Avança Steps">
    Se o lead não responder, avança para o próximo step até completar todos (máx. 3 steps).
  </Step>
</Steps>

## Modelo do Follow-up Config

```json theme={null}
{
  "id": "uuid",
  "tenant_id": "uuid",
  "assistant_id": "uuid",
  "trigger_status_ids": ["uuid-status-1", "uuid-status-2"],
  "steps": [
    {
      "interval": "PT30M",
      "prompt": "Envie uma mensagem amigável perguntando se o lead precisa de ajuda"
    },
    {
      "interval": "PT2H",
      "prompt": "Reforce o valor do produto e ofereça uma demonstração"
    }
  ],
  "official_steps": [
    {
      "channel_id": "uuid",
      "channel_name": "WhatsApp Business",
      "app_id": "gupshup_app_12345",
      "steps": [
        {
          "interval": "P1D",
          "template_name": "reengajamento_v1",
          "template_language": "pt_BR",
          "template_params": ["{{LEAD_FIRSTNAME}}", "Leavo"]
        }
      ]
    }
  ],
  "is_active": true,
  "created_at": "2024-01-15T10:00:00Z"
}
```

## Formato de Intervalo (ISO 8601)

| Intervalo        | Formato   | Descrição               |
| ---------------- | --------- | ----------------------- |
| 30 minutos       | `PT30M`   | Mínimo permitido        |
| 2 horas          | `PT2H`    |                         |
| 1 dia e 12 horas | `P1DT12H` |                         |
| 1 dia            | `P1D`     | Requer template oficial |
| 1 semana         | `P1W`     | Requer template oficial |

<Warning>
  Steps com intervalo >= 24 horas **devem obrigatoriamente** ter `template_name` configurado, pois a janela de conversa do WhatsApp exige templates aprovados.
</Warning>

## Regras

* Máximo de **3 steps** por configuração
* Intervalo mínimo de **30 minutos** por step
* Uma configuração por assistente (único)
* Cada canal oficial pode ter seus próprios steps com templates