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

# Conectar un CRM

> Contactos, conversaciones y mensajes entre tu CRM e Impulso.

El patrón que usan la mayoría de integraciones:

**1. Crea una llave para el CRM**

Permisos: `contactos`, `conversaciones`, `mensajes` y, si quieres recibir lo que pasa, `avisos`.

**2. Trae lo que ya existe**

Recorre contactos y conversaciones con [paginación](https://docs.impulsodigital.app/conceptos/paginacion.md):

```bash theme={null}
curl "https://api.impulsodigital.app/v1/contacts?limit=100" -H "Authorization: Bearer $IMPULSO_API_KEY"
```

**3. Mantenlo al día con avisos**

Crea un aviso con `message.received`, `message.sent`, `contact.created` y `conversation.stage_changed`
(ver [Avisos](https://docs.impulsodigital.app/guias/avisos.md)). Así tu CRM se entera al instante sin consultar cada poco.

**4. Escribe desde el CRM**

```bash theme={null}
curl -X POST https://api.impulsodigital.app/v1/messages \
  -H "Authorization: Bearer $IMPULSO_API_KEY" -H "Content-Type: application/json" \
  -d '{ "conversation_id": "cmw…", "type": "text", "text": "Hola, te escribo de parte de ventas 👋" }'
```

Por defecto, al escribir la conversación pasa a manos del equipo y el agente de IA deja de contestarle a ese
cliente (igual que cuando alguien escribe desde el panel). Con `"pause_ai": false` el agente sigue atendiendo.

## Ideas útiles

* **Asignar etapas** desde el CRM: `POST /conversations/{id}/stage` con la etapa del embudo de la cuenta.
* **Pasar a una persona** o **devolver al agente**: `POST /conversations/{id}/transfer` y `/resume-ai`.
* **Seguimientos**: `POST /scheduled` programa un texto o una plantilla; se cancela solo si el cliente responde antes.
* **Un número por equipo**: si tu cuenta tiene varios números, crea llaves limitadas a cada uno.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.