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

# Recetas de integración

> Patrones comunes: notificaciones transaccionales, sincronización de CRM, campañas automatizadas y escalado a humano.

## 1. Notificación transaccional desde tu ERP

Evento en tu sistema (póliza emitida) → `POST /v1/messages` con `type: "template"` → guarda `data.id` → consulta `GET /v1/messages/:id` a los 30 s para registrar `delivered`/`failed` en tu ERP.

## 2. Sincronizar tu CRM con el de Sofia Chat

Cada hora: `GET /v1/chat-users?dateFrom=<última sync>&limit=100` paginando hasta agotar; por cada uno, crea o actualiza en tu CRM. En sentido inverso, `PATCH /v1/chat-users/:id` con `customFields` para que los agentes vean datos de tu sistema en la ficha.

## 3. Campaña de renovaciones automatizada

Diario: calcula pólizas que vencen en 30 días → `POST /v1/contacts` (o `import`) con `custom_fields` → `POST /v1/contact-groups/:id/contacts` → `POST /v1/campaigns` con `scheduledAt` a las 9:00 → al día siguiente `GET /v1/campaigns/:id/recipients?status=failed` para reintentar por otro canal.

## 4. Escalar a humano desde tu sistema

Si tu backend detecta un caso que la IA no debe manejar (reclamo, fraude), envía `POST /v1/messages` con `assignToHuman: true`: el mensaje llega al cliente y la conversación queda en la cola de agentes con la IA en pausa.