Saltar al contenido principal
La API REST está en acceso anticipado y se habilita por cuenta a pedido. Las claves de API no se emiten todavía desde el panel. Para solicitar acceso, contactar al ejecutivo de cuenta.
La API REST de DeltaLead da acceso programático de lectura a los leads de la organización. Sirve para construir integraciones a medida, alimentar reportes propios o sincronizar con sistemas que las integraciones nativas no cubren: un DMS propietario, un data warehouse interno o un CRM hecho a medida. Para que un lead entre a DeltaLead desde un sistema propio se usa el Custom Webhook, no esta API.

​
URL base

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

​
Ejemplo rápido

La siguiente solicitud recupera los leads más recientes con curl. YOUR_API_KEY se reemplaza por la clave de API de la cuenta, que empieza con dl_live_ o dl_sandbox_.

​
Formato de las respuestas

Todas las respuestas usan JSON. La API es de solo lectura en esta etapa: los endpoints disponibles son GET, así que no hace falta enviar Content-Type en ninguna solicitud. Los datos de la persona viajan siempre dentro del objeto anidado contact, nunca en el nivel raíz del lead.

​
Recursos disponibles

Leads

Listar leads y recuperar el detalle de uno. Filtrar por estado, canal y rango de última actividad.

Webhooks

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

​
Límites de tasa

El límite se aplica por clave de API: 5 solicitudes por segundo sostenidas, con una ráfaga de hasta 10. Al superarlo, la API devuelve una respuesta 429 Too Many Requests con la cabecera Retry-After, que indica cuántos segundos esperar antes de reintentar. Retry-After es la única cabecera de recuperación que emite la API; no hay cabeceras de consumo restante. La referencia de errores detalla el manejo completo de 429 y la estrategia de backoff exponencial.

​
Próximos pasos

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