API REST de DeltaLead: gestionar leads y agentes por código

La API REST de DeltaLead da acceso programático a leads, conversaciones, agentes de IA y configuración de webhooks. Sirve para construir integraciones a medida, automatizar flujos de trabajo o sincronizar con sistemas que las integraciones nativas no cubren: un DMS propietario, un data warehouse interno o un CRM hecho a medida.

URL base

Todas las solicitudes a la API se realizan sobre HTTPS contra la siguiente URL base:

https://platform-api.deltalead.ai/v1

Ejemplo rápido

La siguiente solicitud recupera los leads más recientes con curl. YOUR_API_KEY se reemplaza por la clave generada en el panel.

curl https://platform-api.deltalead.ai/v1/leads \
  -H "X-API-Key: YOUR_API_KEY"

Formato de las solicitudes

Todos los cuerpos de solicitud y respuesta usan JSON. Al enviar datos en solicitudes POST o PATCH, hay que incluir la cabecera Content-Type: application/json para que la API pueda interpretar el cuerpo correctamente.

curl -X POST https://platform-api.deltalead.ai/v1/leads \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Martín Sosa", "phone": "+5491122334455"}'

Las solicitudes GET y DELETE no requieren la cabecera Content-Type.

Recursos disponibles

Leads

Crear, consultar, actualizar y eliminar registros de leads. Filtrar por estado, canal, score y más.

Conversaciones

Acceder al historial completo de mensajes de cualquier lead en todos los canales: WhatsApp, email, llamadas y formularios web.

Agentes

Listar y configurar los agentes de IA, incluidos idioma, tono, reglas de escalamiento y canales activos.

Webhooks

Suscribirse a eventos en tiempo real como nuevos leads, cambios de estado e hitos de una conversación.

Límites de tasa

La API admite hasta 1.000 solicitudes por minuto por clave de API. Al superar ese límite, la API devuelve una respuesta 429 Too Many Requests. Cada respuesta incluye dos cabeceras para seguir el consumo actual:

Cabecera	Descripción
`X-RateLimit-Remaining`	Cantidad de solicitudes restantes en la ventana de un minuto en curso
`X-RateLimit-Reset`	Marca de tiempo Unix (UTC) en la que se reinicia la ventana del límite de tasa

Cuando la integración recibe una respuesta 429, conviene esperar hasta X-RateLimit-Reset antes de reintentar, o aplicar backoff exponencial. La referencia de errores detalla el manejo completo de 429.

Próximos pasos

Autenticación — cómo generar y enviar la clave de API
Errores — códigos de estado, forma de los errores y estrategias de reintento

​URL base

​Ejemplo rápido

​Formato de las solicitudes

​Recursos disponibles