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

# API de Revem

> Integra tu sistema con Revem: sincroniza contactos, gestiona tickets y conecta el chat de tu sitio.

La API de Revem es una API REST sobre HTTPS que responde JSON. Está pensada para integraciones de
**servidor a servidor**: tu backend habla con Revem usando la API key de tu organización.

<CardGroup cols={3}>
  <Card title="Contactos" icon="address-book" href="/guia#contactos">
    Crea y actualiza tu base de clientes, con atributos personalizados, desde tu CRM o tu tienda.
  </Card>

  <Card title="Tickets" icon="ticket" href="/guia#tickets">
    Lee y actualiza los tickets de tu embudo desde tu sistema de gestión.
  </Card>

  <Card title="Webchat" icon="comments" href="/guia#webchat">
    Conecta el chat de tu sitio para que el equipo o el agente de IA atiendan a tus visitantes.
  </Card>
</CardGroup>

## Lo esencial

|               |                                                                                           |
| ------------- | ----------------------------------------------------------------------------------------- |
| URL base      | `https://api.revem.ai`                                                                    |
| Autenticación | `Authorization: Bearer rvm_…` — ver [Autenticación](/guia#autenticación)                  |
| Formato       | JSON en solicitudes y respuestas, UTF-8. Fechas en ISO 8601.                              |
| Límite        | 600 solicitudes por minuto por API key — ver [Errores y límites](/guia#errores-y-límites) |

## Ejemplo de solicitud

```bash theme={"system"}
curl https://api.revem.ai/contacts/public/v1 \
  -H "Authorization: Bearer $REVEM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "+56912345678",
    "first_name": "Camila",
    "last_name": "Rojas",
    "email": "camila@ejemplo.cl"
  }'
```

```json theme={"system"}
{ "ok": true, "id": "3f2b6c1e-8d4a-4f0b-9c2e-7a1d5e6f8b90", "created": true, "warnings": [] }
```

Guarda el `id`: es la llave estable del contacto para el resto de la API.

## Qué puede y qué no puede hacer una API key

Una API key pertenece a **una** organización y sólo puede leer y escribir datos de esa
organización. Alcanza únicamente los endpoints documentados en la pestaña **Referencia**;
cualquier otra ruta de la API responde `403`.

<Note>
  La referencia se genera directamente desde los esquemas de validación de la API, así que lo que
  ves aquí es lo que la API acepta y devuelve. Cada endpoint muestra la solicitud de ejemplo lista
  para copiar; ejecútala desde tu servidor, nunca desde el navegador.
</Note>

## Versionado

Las rutas de contactos y tickets llevan la versión en la URL (`/public/v1`). Dentro de una versión
los cambios son **aditivos**: pueden aparecer campos nuevos en las respuestas, parámetros
opcionales nuevos y rutas nuevas. Tu cliente debe ignorar las claves que no conoce.