RECURSO DE LA API

Lead y CRM

Reúna las solicitudes entrantes (leads) en un único repositorio; realice el seguimiento de tareas, llamadas y comunicación con el paciente. Que ningún interés se pierda por el camino.

Acceso anticipado Toda la API

Endpoints

7 endpoint

Endpoints de este recurso. Cada endpoint se limita a los datos de la clínica a la que está vinculada la clave de la API; los endpoints de escritura admiten la cabecera Idempotency-Key.

GET /v1/leads Lista los leads/solicitudes Usuario autorizado

POST /v1/leads Crea un nuevo lead Usuario autorizado

POST /v1/leads/{id}/status Cambia el estado/fase del lead Usuario autorizado

GET /v1/tasks Lista las tareas Usuario autorizado

POST /v1/tasks Crea una tarea Usuario autorizado

GET /v1/messages Lista los mensajes de comunicación del paciente Usuario autorizado

POST /v1/messages Crea un registro de mensaje/comunicación Usuario autorizado

Ejemplo de uso

Actualizar el estado del lead

Solicitud

curl -X POST https://api.udentiva.com/v1/leads/{id}/status \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"status":"qualified"}'

Respuesta

HTTP/1.1 200 OK
{
  "id": "ld-88",
  "status": "qualified"
}

Seguridad en este recurso

La seguridad no es una función, es la propia arquitectura. Las garantías vigentes en este recurso:

Los registros de leads y de comunicación están aislados en su clínica (RLS).

La recepción pública de leads (landing) es un endpoint independiente, sin sesión y con límite de velocidad; el spam se bloquea con el límite de ventana de Redis.

Todo el modelo de seguridad →

Formato de error

Los errores se devuelven con un sobre coherente; el código va dirigido a la máquina, el mensaje al usuario. El error interno o el stack nunca se filtran.

{
  "error": {
    "code": "validation_failed",
    "message": "Campo no válido: correo electrónico"
  }
}

Otros recursos

Pacientes Citas y calendario Odontograma y Tratamiento Cobros y finanzas Inventario Imágenes Laboratorio Turismo de salud Informes y BI Webhooks Transferencia de Datos (Export API)

¿Quiere acceso anticipado?

Sea el primero en enterarse cuando se abra la API.

Contactar