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

# Agentes de IA

> Conecte a API da Bevits à Leme, Claude Code, Codex e outros agentes.

Agentes podem usar a API REST da Bevits para responder perguntas sobre clientes,
segmentos, compras, flows e campanhas. Cada API key acessa somente os dados da
organização à qual pertence.

<Warning>
  Dê ao agente uma chave exclusiva com escopo `read`. Não cole a chave no
  prompt, em arquivos versionados ou em logs; disponibilize-a por uma variável
  de ambiente ou pelo gerenciador de segredos da plataforma.
</Warning>

## Leme

Ao criar uma conexão personalizada na Leme, use:

| Configuração    | Valor                                                 |
| --------------- | ----------------------------------------------------- |
| URL base        | `https://api.bevits.com/v1`                           |
| Autenticação    | API key / Bearer token                                |
| Header          | `Authorization: Bearer <API_KEY>`                     |
| Identidade      | `GET /me`                                             |
| Discovery       | `GET /segments`, `GET /flows`, `GET /email-campaigns` |
| Tipo da conexão | Compartilhada pela organização                        |

Valide primeiro a conexão em `GET /me`. O `organization.id` retornado é a
identidade estável da conexão.

## Claude Code e Codex

Claude Code e Codex conseguem testar a API usando suas ferramentas de terminal.
A API da Bevits é REST; ela não se apresenta diretamente como um servidor MCP.

Inicie a ferramenta com a variável disponível no ambiente:

```bash theme={null}
export BEVITS_API_KEY="bvt_live_..."
```

Em seguida, use uma instrução como:

```text theme={null}
Use a API Bevits em https://api.bevits.com/v1.
Autentique com Authorization: Bearer $BEVITS_API_KEY sem imprimir a chave.
Comece consultando /me. Use paginação por starting_after e respeite
X-RateLimit-* e Retry-After. Faça apenas operações de leitura.
```

## Fluxo recomendado para CRM

Para responder “quem são os melhores clientes do segmento VIP e o que eles
compraram?”, o agente pode usar apenas três etapas:

1. `GET /segments?q=VIP` para localizar o segmento.
2. `GET /segments/{segment_id}/customers?sort=total_spent` para ordenar seus clientes.
3. `GET /customers/{customer_id}/purchases` para consultar as compras do cliente escolhido.

<Tip>
  Oriente o agente a conservar IDs exatamente como foram retornados e a pedir
  confirmação humana antes de qualquer ação fora dos endpoints de leitura.
</Tip>