purpose (p. ej., primary para la historia clínica que ve el médico y rpa para la inyección en el EMR). Cada documento es el resultado de las plantillas de sesión ya completadas.
Listar los documentos
Usa el mismoid de sesión que usaste con el endpoint de sesiones de scribe: tu consultationInternalId o el id de la sesión (ss_...) que devuelve la API:
Ediciones del médico
ElmedicalRecord es la historia clínica que el médico tiene en Scribe, incluido el texto que escribió o dictó después de que la IA la generó. Cuando el médico edita una historia clínica terminada, Telepatia envía un webhook scribe_session.updated; vuelve a consultar los documentos para leer el texto nuevo y compara updatedAt para saber si la historia clínica cambió.
Los items no llegan en ningún orden garantizado de purpose. Selecciona la historia clínica que necesitas por su purpose (primary es la historia clínica de la consulta), no por su posición en la lista.
Transcripción
La respuesta incluye latranscript de la sesión junto a items: una transcripción por sesión, la misma para todos los documentos. transcript.text es la transcripción completa de la consulta en texto plano: el texto que Telepatia leyó para completar las historias clínicas. transcript.updatedAt indica cuándo cambió por última vez la transcripción guardada.
transcript es null en estos casos. Una transcript null no cambia los documentos: la respuesta los devuelve igual.
Códigos de selectores
Un campo de la plantilla puede limitar su respuesta a una lista de opciones, como un selector de tu EMR. Cada opción es un par{ label, value } en el enum del campo (consulta Opciones de enum): el label es el texto que lee una persona, y el value es tu código para la opción (por ejemplo, el id de la opción en el catálogo de tu EMR).
- Dónde: el código es el valor del campo en
medicalRecord, enmedicalRecord.<sectionKey>.<fieldKey>. Las claves son las que definiste en la plantilla. - Formato: el string
valueexactamente como lo definiste. Un campo de selección múltiple (unarraycuyositemstienenenum) devuelve una lista de stringsvalue. Un campo sin respuesta en la consulta devuelvenull, o sudefaultsi lo definiste. - Cómo lo selecciona Telepatia: el modelo lee
transcript.text, recibe la lista de pareslabelyvaluedel campo y selecciona las opciones cuyolabelcorresponde a lo que dijeron el médico y el paciente. La historia clínica guarda solo elvalue, así que puedes cambiar o traducir unlabely tu integración sigue recibiendo el mismo código.
Códigos de diagnóstico
Cada documento incluye susdiagnosisCodes: los códigos CIE-10 (ICD-10 / CID-10) de los diagnósticos, tal como quedaron tras la revisión del médico (las sugerencias del modelo más los códigos que el médico agregó, menos los que eliminó). Cada entrada tiene un type primary o secondary. La lista está vacía cuando la sesión no tiene códigos de diagnóstico.
Los antecedentes patológicos traen sus propios códigos resueltos en medicalRecordSummaryStructured.pastMedicalConditionsCoded: cada entrada asocia el content del antecedente con un objeto code que contiene el code de mejor coincidencia y las options con su puntaje. Es null hasta que se ejecute la resolución de códigos para la historia clínica.
Alertas de CDSS
Cuando el soporte a la decisión clínica está habilitado para la sesión, cada documento incluye suscdssAlerts: alertas correctivas que señalan omisiones, dosis incorrectas u órdenes no pertinentes en la historia clínica. Cada alerta tiene un id opaco y estable (úsalo tal cual; no lo parsees), el elementId clínico al que se refiere, un actionCategory (add | remove | replace | modify), una severity (red | orange | yellow) y un status que refleja la decisión del médico (pending | accepted | rejected). Es null cuando CDSS está deshabilitado para la sesión o no se generaron alertas, y [] cuando se ejecutó y no produjo ninguna.
Consulta Soporte a la decisión clínica para ver el modelo completo de la alerta.
Filtrar por purpose
Envía?purpose=primary para obtener solo el documento que ve el médico. Otros valores válidos incluyen rpa (para inyección en el EMR) y emr.
Referencia de campos
La respuesta también tiene estos campos junto a
items: