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

> Campos personalizados para leads

## O que são Campos Personalizados?

Campos personalizados permitem adicionar informações extras aos leads além dos campos padrão (nome, email, telefone, empresa).

## Tipos de Campo

<CardGroup cols={2}>
  <Card title="text" icon="font">
    Campo de texto livre
  </Card>

  <Card title="number" icon="hashtag">
    Valor numérico
  </Card>

  <Card title="date" icon="calendar">
    Data/hora
  </Card>

  <Card title="boolean" icon="toggle-on">
    Verdadeiro ou falso
  </Card>

  <Card title="select" icon="list">
    Seleção de opções predefinidas
  </Card>
</CardGroup>

## Fluxo de Uso

<Steps>
  <Step title="Criar Definição">
    Defina o campo: nome, tipo, opções (para select), valor padrão.
  </Step>

  <Step title="Aplicar Valores">
    Defina valores do campo para leads específicos.
  </Step>

  <Step title="Usar em Templates">
    Use variáveis como `{{LEAD_NOME_DO_CAMPO}}` em mensagens e prompts.
  </Step>
</Steps>

## Endpoints

| Método   | Endpoint                                    | Descrição          |
| -------- | ------------------------------------------- | ------------------ |
| `GET`    | `/backend/custom-fields`                    | Lista definições   |
| `POST`   | `/backend/custom-fields`                    | Cria definição     |
| `PUT`    | `/backend/custom-fields/{id}`               | Atualiza definição |
| `DELETE` | `/backend/custom-fields/{id}`               | Remove definição   |
| `GET`    | `/backend/custom-fields/variables`          | Lista variáveis    |
| `GET`    | `/backend/lead-fields/{lead_id}`            | Valores de um lead |
| `PUT`    | `/backend/lead-fields/{lead_id}/{field_id}` | Define valor       |

## Variáveis Disponíveis

Variáveis podem ser usadas em mensagens de cadência e prompts da IA:

### Variáveis Padrão

| Variável             | Descrição             |
| -------------------- | --------------------- |
| `{{LEAD_NAME}}`      | Nome completo do lead |
| `{{LEAD_FIRSTNAME}}` | Primeiro nome do lead |
| `{{LEAD_NUMBER}}`    | Telefone do lead      |
| `{{COMPANY_NAME}}`   | Nome da empresa       |

### Variáveis de Campos Personalizados

Campos personalizados são acessados como: `{{LEAD_CHAVE_DO_CAMPO}}`

Exemplo: Se você criar um campo com `field_key: "origem_lead"`, a variável será `{{LEAD_ORIGEM_LEAD}}`