Saltar al contenido principal

Requisitos previos

  • Una API key de Telepatia (pídesela a tu gerente de cuenta)
  • La URL base (consulta la descripción general)
Los ejemplos a continuación usan la URL de producción.

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:
Si aún no tienes uno, créalo. El siguiente ejemplo usa dos Secciones Telepatia; consulta el catálogo completo:
Guarda el id que se devuelve (p. ej., mrc_a1b2c3d4e5f6g7h8): lo enviarás a set-consultation-context en el siguiente paso.
Puedes omitir la creación explícita y enviar el JSON completo en línea como medicalRecordConfiguration en set-consultation-context. Telepatia calcula su hash y lo deduplica automáticamente frente a las plantillas existentes. Consulta Smart Templates.

Paso 1: Establece el contexto de la consulta

Antes de la consulta, envía la información del paciente a Telepatia. Incluye un consultationInternalId: 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.
Respuesta:
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 el consultationInternalId para que la sesión quede vinculada al contexto de consulta que estableciste en el paso 1.
Respuesta:
Redirige al usuario a la 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í:
  1. El scribe comienza a grabar la consulta
  2. El médico atiende la consulta como de costumbre
  3. Al terminar, el médico finaliza la sesión en el scribe
En este paso no se necesitan llamadas a la API: todo ocurre en la aplicación de Telepatia.

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

Respuesta:
Sigue consultando (polling) mientras status esté en curso (created, recording, stopped, processing). Los documentos están listos en cuanto status pasa a completed o completedWithErrors. error y cancelled significan que no se generarán documentos. Consulta Ciclo de vida de la sesión para la lista completa.

4b. Obtén los documentos de historia clínica

Cuando la sesión llegue a completed 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:
Respuesta:
Consulta Documentos de historia clínica para ver la estructura completa de la respuesta, incluidos medicalRecordSummaryStructured y los valores disponibles de purpose.