Índice

API

Acceso programático a DALIA bajo /api/v1 en el mismo dominio de la app (https://www.dal-ia.com). Las credenciales son API keys (dk_live_…) que un administrador crea en Configuración → Acceso API, con rol Acceso total, Solo lectura o Personalizado por dominios (conversaciones, contactos, CRM, reports, webhooks…). Cada key se muestra una sola vez y se revoca individualmente.

Autenticación

curl https://www.dal-ia.com/api/v1/contacts \
  -H "Authorization: Bearer dk_live_…"

Header Authorization: Bearer con la key. Los permisos del rol de la key aplican por endpoint — el detalle por operación está en la referencia. Límites: 300 req/min por key y 600 req/min por cuenta compartidos entre todas las keys (REST y MCP juntos); al exceder responde 429 con Retry-After.

Recursos

Eventos hacia afuera

Para recibir eventos (contacto nuevo, mensaje entrante, negocio ganado…) suscribe webhooks salientes por la propia API: POST /api/v1/webhooks con firma HMAC y reintentos. Los eventos disponibles están en GET /api/v1/webhooks/events y documentados en la referencia.