Una sesión de scribe se crea cuando un médico realiza una consulta a través de la interfaz de Telepatia. Una vez finalizada, aquí puede consultar su ciclo de vida y los metadatos de la consulta, y luego obtener el registro completo desde el endpoint de Documentos de Registro Médico.
Ciclo de vida de la sesión
Una sesión pasa por varios estados. Los valores siguientes se devuelven tal cual en el campo status.
| Estado | Fase | Descripción |
|---|
created | en curso | Sesión abierta, la grabación aún no comenzó |
recording | en curso | El médico está grabando activamente la consulta |
stopped | en curso | Grabación terminada; el audio se está subiendo y poniendo en cola para el procesamiento |
processing | en curso | Pipeline de IA (transcripción + generación del registro) en ejecución |
completed | listo | Pipeline finalizado — los documentos están disponibles |
completedWithErrors | listo | Pipeline finalizado con errores no fatales — los documentos siguen disponibles |
reviewed | listo | El médico revisó y finalizó el registro |
error | terminal | Error fatal durante el procesamiento — no se producirán documentos |
cancelled | terminal | El usuario canceló la sesión |
unknown | — | Valor por defecto cuando el estado upstream no es reconocido |
Recuperar una sesión
Use el consultationInternalId que proporcionó (o recibió) al configurar el contexto de consulta:
curl https://scribe-api.telepatia.ai/v1/scribe-sessions/CONSULT-12345 \
-H "Authorization: Bearer SU_CLAVE_API"
{
"id": "session-abc-123",
"status": "completed",
"createdAt": "2026-02-20T10:00:00Z",
"completedAt": "2026-02-20T10:30:00Z",
"patientName": "John Doe",
"scribeSessionModality": "IN_PERSON",
"consultationInternalId": "CONSULT-12345",
"specialty": "Cardiology"
}
Mientras status siga en curso (created, recording, stopped, processing), consulte este endpoint hasta que llegue a un estado listo (completed, completedWithErrors, reviewed) antes de obtener el registro completo. error y cancelled son estados terminales — no se producirán documentos.
Recuperar el registro completo
Este endpoint solo devuelve el ciclo de vida y los metadatos de la consulta. El registro completo —la salida de las plantillas de sesión, con todas las secciones— se obtiene por separado desde el endpoint de documentos de registro médico, usando el mismo consultationInternalId:
curl https://scribe-api.telepatia.ai/v1/scribe-sessions/CONSULT-12345/medical-record-documents \
-H "Authorization: Bearer SU_CLAVE_API"
purpose — p.ej. primary para el registro del médico, rpa para inyección en el EMR). Filtre con ?purpose=primary para obtener solo el principal. Vea Documentos de Registro Médico para la forma completa de la respuesta y la referencia de campos. 
