Sesiones

Las sesiones son el corazón de Coordinalo. Representan una cita entre un proveedor y un cliente.

Listar sesiones

GET /api/v1/sessions

Parámetros de consulta

Parámetro	Tipo	Descripción
`from`	`string`	Fecha inicio (ISO 8601)
`to`	`string`	Fecha fin (ISO 8601)
`providerId`	`string`	Filtrar por proveedor
`clientId`	`string`	Filtrar por cliente
`status`	`string`	Estado: `scheduled`, `completed`, `cancelled`

Ejemplo de respuesta

{
  "data": [
    {
      "id": "sess_123abc",
      "startTime": "2026-01-15T10:00:00Z",
      "endTime": "2026-01-15T11:00:00Z",
      "status": "scheduled",
      "provider": {
        "id": "prov_456def",
        "name": "María González"
      },
      "client": {
        "id": "cli_789ghi",
        "name": "Juan Pérez"
      },
      "service": {
        "id": "serv_abc123",
        "name": "Sesión de kinesiología"
      }
    }
  ],
  "pagination": {
    "total": 45,
    "page": 1,
    "limit": 20
  }
}

Crear sesión

POST /api/v1/sessions

Cuerpo de la solicitud

{
  "providerId": "prov_456def",
  "clientId": "cli_789ghi",
  "serviceId": "serv_abc123",
  "startTime": "2026-01-15T10:00:00Z",
  "notes": "Primera sesión del paciente"
}

Respuesta exitosa (201)

{
  "id": "sess_new123",
  "startTime": "2026-01-15T10:00:00Z",
  "endTime": "2026-01-15T11:00:00Z",
  "status": "scheduled",
  "createdAt": "2025-12-30T15:30:00Z"
}

Estados de sesión

Coordinalo lleva el seguimiento de las sesiones a través del siguiente flujo:

Proyectado → Programado → Confirmado → Entregado

Estado	Código	Descripción
Proyectado	`projected`	Sesión planificada pero aún no agendada
Programado	`scheduled`	Agendada con fecha y hora
Confirmado	`confirmed`	Confirmada por el cliente (WhatsApp/Email)
En progreso	`in_progress`	Sesión en curso
Entregado	`completed`	Sesión finalizada exitosamente
Cancelada	`cancelled`	Cancelada por cliente o proveedor
No asistió	`no_show`	Cliente no se presentó

Confirmaciones automáticas

Coordinalo envía confirmaciones automáticas por WhatsApp y email. Los clientes pueden confirmar su asistencia directamente desde el mensaje.

Las confirmaciones por WhatsApp requieren integración con la API de WhatsApp Business configurada en tu organización.

Webhooks

Coordinalo puede notificar cambios de estado mediante notificaciones automáticas (webhooks):

{
  "event": "session.completed",
  "data": {
    "sessionId": "sess_123abc",
    "previousStatus": "in_progress",
    "newStatus": "completed",
    "completedAt": "2026-01-15T11:05:00Z"
  }
}

Eventos disponibles

Evento	Descripción
`session.created`	Nueva sesión creada
`session.confirmed`	Cliente confirmó asistencia
`session.completed`	Sesión marcada como entregada
`session.cancelled`	Sesión cancelada
`session.no_show`	Cliente no asistió

Sesiones

On this page