Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.lina.doolehealth.com/llms.txt

Use this file to discover all available pages before exploring further.

Descripción general

LINA permite enviar formularios clínicos a pacientes a través de múltiples canales. Puedes programar envíos inmediatos o diferidos, y recibir los resultados automáticamente vía webhooks o consultando la API.

Canales disponibles

CanalCoste (créditos)Descripción
email1Correo electrónico con enlace al formulario
sms2SMS con enlace corto
whatsapp3Mensaje de WhatsApp con botón interactivo
app0Notificación push en la app del paciente

Flujo de trabajo

1

Obtener el ID del formulario

Primero, lista los formularios disponibles en tu cuenta para identificar cuál quieres enviar.
curl -X GET https://api.lina.health/v1/forms \
  -H "Authorization: Bearer YOUR_TOKEN"
2

Identificar al paciente

Necesitas el id del paciente. Puedes buscarlo por nombre o email.
curl -X GET "https://api.lina.health/v1/patients?search=maria.garcia@email.com" \
  -H "Authorization: Bearer YOUR_TOKEN"
3

Crear la programación

Programa el envío del formulario al paciente indicando el canal y la fecha/hora deseada.
curl -X POST https://api.lina.health/v1/schedules \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "formId": "form_abc123",
    "patientId": "pat_xyz789",
    "channel": "whatsapp",
    "scheduledAt": "2026-05-15T09:00:00Z",
    "message": "Hola María, te enviamos tu cuestionario de seguimiento semanal."
  }'
4

Verificar el estado

Consulta el estado de la programación para confirmar que se ha enviado correctamente.
curl -X GET https://api.lina.health/v1/schedules?patientId=pat_xyz789&status=pending \
  -H "Authorization: Bearer YOUR_TOKEN"

Envío inmediato

Si omites el campo scheduledAt, el formulario se enviará inmediatamente:
curl -X POST https://api.lina.health/v1/schedules \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "formId": "form_abc123",
    "patientId": "pat_xyz789",
    "channel": "email"
  }'

Cancelar un envío programado

Solo puedes cancelar envíos con estado pending. Los créditos se reembolsan automáticamente.
curl -X POST https://api.lina.health/v1/schedules/sch_def456/cancel \
  -H "Authorization: Bearer YOUR_TOKEN"
Los envíos cancelados devuelven los créditos consumidos a tu balance de forma inmediata.

Recibir respuestas

Configura un webhook para el evento form.completed y recibirás las respuestas del paciente en tiempo real:
{
  "event": "form.completed",
  "data": {
    "formId": "form_abc123",
    "patientId": "pat_xyz789",
    "scheduleId": "sch_def456",
    "responses": [
      { "fieldId": "pain_level", "value": 3 },
      { "fieldId": "mood", "value": "bien" },
      { "fieldId": "notes", "value": "Me siento mejor esta semana" }
    ],
    "completedAt": "2026-05-15T09:12:34Z"
  }
}
Los formularios enviados por SMS o WhatsApp expiran a las 72 horas. Los enviados por email o app no tienen caducidad.