Obtener un lead por ID — endpoint de la API REST de DeltaLead

Este endpoint devuelve el perfil completo de un lead —datos de contacto, score asignado por IA, intención de compra, estado actual, vehículo de interés y todas las marcas de tiempo— a partir de su identificador único en la ruta de la URL. Sirve para mostrar el detalle de un lead dentro de herramientas propias, sincronizar registros individuales con un CRM externo o consultar el estado de calificación más reciente antes de ejecutar una acción.

Endpoint

GET https://platform-api.deltalead.ai/v1/leads/{id}

Parámetros de ruta

string

requerido

Identificador único del lead a recuperar. Los IDs de lead llevan el prefijo lead_, p. ej. lead_abc123. Se pueden obtener desde el endpoint Listar leads o desde los payloads de webhook.

Ejemplo de solicitud

cURL

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

Respuesta

Una solicitud exitosa devuelve HTTP 200 OK con el objeto lead completo.

200 OK

{
  "id": "lead_abc123",
  "name": "María García",
  "phone": "+5491155551234",
  "email": "maria@example.com",
  "channel": "whatsapp",
  "vehicle_interest": "Toyota Hilux SRX 2024",
  "score": 87,
  "intent": "purchase_30_days",
  "status": "qualified",
  "assigned_to": "user_xyz789",
  "created_at": "2024-03-10T14:22:00Z",
  "updated_at": "2024-03-11T09:05:33Z",
  "last_activity_at": "2024-03-11T09:05:33Z",
  "organization_id": "org_00112233"
}

Campos de la respuesta

string

Identificador único del lead, con el prefijo lead_.

string

Nombre completo del lead tal como se captó desde el canal de origen o como se indicó al crearlo.

string

Número de teléfono del lead en formato E.164, p. ej. +5491155551234.

string | null

Dirección de email del lead. null si no se proporcionó.

string

Canal por el que el lead contactó por primera vez al concesionario. Uno de whatsapp, facebook, instagram, mercadolibre, web_form, email, phone.

string | null

Modelo o descripción del vehículo por el que el lead manifestó interés, según lo identificó el agente de IA. null si todavía no se determinó.

integer

Score de calidad del lead generado por IA, de 0 (frío) a 100 (altamente calificado), calculado a partir de la intención de compra, las señales de presupuesto y los indicadores de urgencia extraídos de la conversación.

string

Categoría de intención de compra asignada por el agente de IA. Una de:

purchase_30_days — urgencia alta, compra probable dentro de los 30 días
purchase_90_days — urgencia moderada, compra dentro del trimestre
browsing — explorando opciones, sin un plazo definido
unknown — señal insuficiente para clasificar

string

Estado actual del lead dentro de su ciclo de vida. Uno de new, in_conversation, qualified, assigned, closed, lost.

string | null

ID de usuario del asesor de ventas al que está asignado el lead. null si el lead no fue asignado.

string

Marca de tiempo ISO 8601 del momento en que el lead se captó en DeltaLead.

string

Marca de tiempo ISO 8601 del cambio más reciente en cualquier campo de este lead.

string

Marca de tiempo ISO 8601 de la interacción más reciente —mensaje, llamada o cambio de estado— registrada para este lead.

string

Identificador único de la organización de DeltaLead (concesionario) propietaria de este registro de lead.

Errores

404 — Lead no encontrado

Se devuelve cuando no existe ningún lead con el id indicado dentro de la organización.

404 Not Found

{
  "error": {
    "code": "lead_not_found",
    "message": "No lead with id 'lead_abc123' was found in your organization.",
    "status": 404
  }
}

Conviene verificar que el valor de id sea correcto y pertenezca a la organización. Los IDs de lead correspondientes a la cuenta de otra organización también devuelven 404.

Introducción

Leads

Conversaciones

Agentes

Webhooks

Obtener un lead por ID — endpoint de la API REST de DeltaLead

Endpoint

Parámetros de ruta

Ejemplo de solicitud

Respuesta

Campos de la respuesta

Errores

​Endpoint

​Parámetros de ruta

​Ejemplo de solicitud

​Respuesta

​Campos de la respuesta

​Errores

Endpoint

Parámetros de ruta

Ejemplo de solicitud

Respuesta

Campos de la respuesta

Errores