Conectar un CRM

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

Crea una llave para el CRM

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

Trae lo que ya existe

Recorre contactos y conversaciones con paginación:

curl "https://api.impulsodigital.app/v1/contacts?limit=100" -H "Authorization: Bearer $IMPULSO_API_KEY"

Mantenlo al día con avisos

Crea un aviso con message.received, message.sent, contact.created y conversation.stage_changed (ver Avisos). Así tu CRM se entera al instante sin consultar cada poco.

Escribe desde el CRM

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.

Empezar

Conceptos

Guías

Ideas útiles