API pública

Con la API tu sistema llama al CRM para leer o escribir. Para que el CRM te avise de lo que pasa, usa los webhooks salientes. Normalmente se usan los dos.

La documentación interactiva de todos los endpoints, con «probar» desde el navegador, está en https://api.driony.com/api/docs.

Conseguir una clave

Ajustes › Claves de API → Nueva clave. Elige solo los permisos que la integración necesite: una landing que crea leads no tiene por qué poder leer tu base de contactos entera.

La clave se muestra una sola vez. Si la pierdes, crea otra y revoca la anterior; se guarda solo su hash.

curl https://tu-empresa.driony.com/api/public/v1/ping \
  -H "Authorization: Bearer crm_a1b2c3d4_…"
# { "ok": true, "key": "n8n-pedidos", "scopes": ["contacts:write"] }

ping comprueba clave y permisos sin escribir nada.

La dirección de tu empresa

Base: https://tu-empresa.driony.com/api/public/v1 (también responde https://api.driony.com/api/public/v1). Autenticación por Authorization: Bearer crm_… (también se acepta x-api-key).

La clave decide de qué empresa son los datos, nunca la dirección. Una clave creada en el panel de Acme solo alcanza los datos de Acme; usada contra la dirección de otra empresa responde 403, para que un error de copia y pega no pase desapercibido.

La versión va en la ruta: cuando exista v2, v1 seguirá funcionando.

Contactos

# Listar, con filtros y paginación por cursor
curl "https://tu-empresa.driony.com/api/public/v1/contacts?limit=50&tag=interesado" \
  -H "Authorization: Bearer $CRM_KEY"

{
  "data": [
    {
      "id": "cmu0…",
      "phone": "+51999888777",
      "name": "Ana",
      "tags": ["interesado"],
      "origin": "ad",
      "fields": { "pais": "Peru" },
      "utm": { "utm_source": "facebook", "utm_campaign": "verano2026" }
    }
  ],
  "nextCursor": "cmu0…",
  "hasMore": true
}

Para la página siguiente pasa nextCursor como cursor. Se usa cursor y no offset porque la lista crece por arriba: con offset se repiten o se saltan registros entre páginas.

# Crear
curl -X POST https://tu-empresa.driony.com/api/public/v1/contacts \
  -H "Authorization: Bearer $CRM_KEY" -H "Content-Type: application/json" \
  -d '{"phone":"51999888777","name":"Ana","tags":["erp"],"fields":{"pais":"Peru"}}'

# Actualizar (los campos se fusionan; `tags` reemplaza el juego entero)
curl -X PATCH https://tu-empresa.driony.com/api/public/v1/contacts/cmu0… \
  -H "Authorization: Bearer $CRM_KEY" -H "Content-Type: application/json" \
  -d '{"name":"Ana Pérez","fields":{"ciudad":"Lima"}}'

El teléfono se normaliza a E.164: da igual 51999888777, +51 999 888 777 o 0051999888777.

Oportunidades

# Crear (si el contacto no existe, se crea)
curl -X POST https://tu-empresa.driony.com/api/public/v1/deals \
  -H "Authorization: Bearer $CRM_KEY" -H "Content-Type: application/json" \
  -d '{"phone":"51999888777","title":"Pedido #4821","value":1250,"currency":"PEN"}'

# Mover de etapa, por NOMBRE
curl -X PATCH https://tu-empresa.driony.com/api/public/v1/deals/cmu0…/stage \
  -H "Authorization: Bearer $CRM_KEY" -H "Content-Type: application/json" \
  -d '{"stage":"Ganado"}'

Se trabaja con el nombre de la etapa, no con su id: tu sistema no tiene por qué conocer identificadores internos. Si el nombre no existe, el error te dice cuáles hay. Con varios embudos, se busca primero en el predeterminado.

Mensajes

curl -X POST https://tu-empresa.driony.com/api/public/v1/messages \
  -H "Authorization: Bearer $CRM_KEY" -H "Content-Type: application/json" \
  -d '{"phone":"51999888777","text":"Tu pedido salió hoy 📦"}'

Limitación de WhatsApp, no del CRM: solo puedes escribir a quien te haya escrito en las últimas 24 h. Fuera de esa ventana hay que usar una plantilla aprobada (desde Difusiones). Si no hay conversación abierta, la API responde 400 explicándolo.

Métricas

curl "https://tu-empresa.driony.com/api/public/v1/stats/summary?days=30" -H "Authorization: Bearer $CRM_KEY"
curl  https://tu-empresa.driony.com/api/public/v1/stats/funnel        -H "Authorization: Bearer $CRM_KEY"
curl  https://tu-empresa.driony.com/api/public/v1/stats/sellers       -H "Authorization: Bearer $CRM_KEY"

Pensados para alimentar un Metabase, un Looker o un panel propio.

Recibir leads: el camino más corto

Si solo quieres meter leads desde una landing o un formulario, basta una clave con leads:write:

curl -X POST https://tu-empresa.driony.com/api/v1/webhooks/lead \
  -H "Authorization: Bearer $CRM_KEY" -H "Content-Type: application/json" \
  -d '{"phone":"51999888777","name":"Ana","source":"Facebook Ads",
       "tags":["nuevo"],"fields":{"ciudad":"Lima"}}'

El nombre de la clave queda registrado como procedencia del contacto, así que sabes qué integración lo creó sin fiarte de lo que declare quien llama.

Errores

Formato uniforme, con el motivo en el idioma de la petición (Accept-Language):

{ "message": "La clave \"solo-metricas\" no tiene permiso para esto (falta: contacts:write)",
  "error": "Forbidden", "statusCode": 403 }