> ## 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

> Sequências automatizadas de mensagens

## O que são Cadências?

Cadências são sequências automatizadas de mensagens enviadas para leads em intervalos definidos. Ideal para follow-up, nutrição de leads e comunicação automatizada.

## Componentes de uma Cadência

<CardGroup cols={2}>
  <Card title="Steps (Etapas)" icon="list-ol">
    Cada step define quando e quais mensagens enviar.
  </Card>

  <Card title="Messages (Mensagens)" icon="message">
    Mensagens podem ser texto, imagem, vídeo, áudio ou documento.
  </Card>

  <Card title="Intervalos" icon="clock">
    Tempo entre steps usando formato ISO 8601 (P1D = 1 dia).
  </Card>

  <Card title="Janelas de Envio" icon="window">
    Horários permitidos para envio por dia da semana.
  </Card>
</CardGroup>

## Tipos de Mensagem

| Tipo       | Descrição                                 |
| ---------- | ----------------------------------------- |
| `text`     | Mensagem de texto com variáveis opcionais |
| `image`    | Imagem com URL e legenda opcional         |
| `video`    | Vídeo com URL                             |
| `audio`    | Áudio com URL                             |
| `document` | Documento/arquivo com URL                 |

## Variáveis em Mensagens

Use variáveis para personalizar mensagens:

```
Olá {{LEAD_FIRSTNAME}}! Tudo bem?
```

Variáveis disponíveis:

* `{{LEAD_NAME}}` - Nome completo
* `{{LEAD_FIRSTNAME}}` - Primeiro nome
* `{{LEAD_NUMBER}}` - Telefone
* `{{COMPANY_NAME}}` - Empresa
* Campos personalizados: `{{LEAD_CHAVE_DO_CAMPO}}`

## Endpoints

| Método   | Endpoint                            | Descrição         |
| -------- | ----------------------------------- | ----------------- |
| `GET`    | `/backend/cadences`                 | Lista cadências   |
| `POST`   | `/backend/cadences`                 | Cria cadência     |
| `GET`    | `/backend/cadences/{id}`            | Obtém cadência    |
| `PUT`    | `/backend/cadences/{id}`            | Atualiza cadência |
| `DELETE` | `/backend/cadences/{id}`            | Remove cadência   |
| `POST`   | `/backend/cadences/{id}/activate`   | Ativa cadência    |
| `POST`   | `/backend/cadences/{id}/deactivate` | Desativa cadência |

## Fluxo de uma Cadência

```mermaid theme={null}
graph TD
    A[Lead entra na cadência] --> B[Step 1: Dia 0]
    B --> C{Aguarda intervalo}
    C --> D[Step 2: Dia 3]
    D --> E{Aguarda intervalo}
    E --> F[Step 3: Dia 7]
    F --> G[Cadência concluída]
```