Requisitos previos
- Una API key de Telepatia (pídesela a tu gerente de cuenta)
- La URL base (consulta la descripción general)
Paso 0: Elige (o crea) un Smart Template
Un Smart Template decide qué secciones genera Telepatia y qué forma tiene cada una. Créalo una vez con Prompts Telepatia curados y reutilízalo en todas tus consultas. Lista los Smart Templates ya creados para tu cuenta:id que se devuelve (p. ej., mrc_a1b2c3d4e5f6g7h8): lo enviarás a set-consultation-context en el siguiente paso.
Paso 1: Establece el contexto de la consulta
Antes de la consulta, envía la información del paciente a Telepatia. Incluye unconsultationInternalId: tu propio identificador, que vincula la sesión con tu sistema. Si lo omites, Telepatia genera uno. Asocia el Smart Template del paso 0 con medicalRecordConfigurationId.
Las integraciones heredadas todavía pueden enviar
scribeSessionConfigurationId en su lugar; consulta Plantillas de sesión. Las integraciones nuevas deben usar Smart Templates.Guarda el
consultationInternalId de la respuesta. Lo necesitarás en los siguientes pasos, tanto para generar el enlace de inicio de sesión como para recuperar después los resultados de la sesión.Paso 2: Genera un enlace de inicio de sesión
Genera un código de verificación para abrir el scribe de Telepatia. Envía elconsultationInternalId para que la sesión quede vinculada al contexto de consulta que estableciste en el paso 1.
redirectUrl para abrir el scribe de Telepatia.
Paso 3: Realiza la sesión
Una vez redirigido, el usuario llega a la interfaz del scribe de Telepatia. Desde ahí:- El scribe comienza a grabar la consulta
- El médico atiende la consulta como de costumbre
- Al terminar, el médico finaliza la sesión en el scribe
Paso 4: Recupera la historia clínica completada
El paso 4 tiene dos partes: confirmar que la sesión terminó y luego obtener los documentos de historia clínica (tu Smart Template ya completado).4a. Verifica el estado de la sesión
4b. Obtén los documentos de historia clínica
Cuando la sesión llegue acompleted o completedWithErrors, recupera las historias clínicas completadas. Una sesión puede producir varios documentos (uno por purpose: primary, rpa, emr, …). Filtra con ?purpose=primary para obtener el que ve el médico:
medicalRecordSummaryStructured y los valores disponibles de purpose.