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

> Conecta la API de Bevits con Leme, Claude Code, Codex y otros agentes.

Los agentes pueden usar la API REST de Bevits para responder preguntas sobre
clientes, segmentos, compras, flows y campañas. Cada clave API solo puede
acceder a la organización a la que pertenece.

<Warning>
  Proporciona al agente una clave exclusiva con el permiso `read`. No pegues la
  clave en prompts, archivos versionados o logs; entrégala mediante una variable
  de entorno o el gestor de secretos de la plataforma.
</Warning>

## Leme

Al crear una conexión personalizada en Leme, usa:

| Configuración    | Valor                                                 |
| ---------------- | ----------------------------------------------------- |
| URL base         | `https://api.bevits.com/v1`                           |
| Autenticación    | Clave API / Bearer token                              |
| Header           | `Authorization: Bearer <API_KEY>`                     |
| Identidad        | `GET /me`                                             |
| Discovery        | `GET /segments`, `GET /flows`, `GET /email-campaigns` |
| Tipo de conexión | Compartida por la organización                        |

Primero valida la conexión con `GET /me`. El `organization.id` retornado es la
identidad estable de la conexión.

## Claude Code y Codex

Claude Code y Codex pueden probar la API mediante sus herramientas de terminal.
La API de Bevits es REST; no se presenta directamente como un servidor MCP.

Inicia la herramienta con la variable disponible en el entorno:

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

Luego utiliza una instrucción como:

```text theme={null}
Usa la API de Bevits en https://api.bevits.com/v1.
Autentica con Authorization: Bearer $BEVITS_API_KEY sin imprimir la clave.
Comienza consultando /me. Pagina con starting_after y respeta
X-RateLimit-* y Retry-After. Realiza únicamente operaciones de lectura.
```

## Flujo recomendado para CRM

Para responder “¿quiénes son los mejores clientes del segmento VIP y qué
compraron?”, el agente puede usar solo tres pasos:

1. `GET /segments?q=VIP` para encontrar el segmento.
2. `GET /segments/{segment_id}/customers?sort=total_spent` para ordenar sus clientes.
3. `GET /customers/{customer_id}/purchases` para consultar las compras del cliente elegido.

<Tip>
  Indica al agente que conserve los IDs exactamente como fueron retornados y
  que solicite confirmación humana antes de cualquier acción fuera de los
  endpoints de solo lectura.
</Tip>