Requisitos previos
- Una clave API de Telepatia (contacte a su gerente de cuenta para obtenerla)
- La URL base (consulte la descripción general)
Los ejemplos a continuación usan la URL de producción.
Paso 0: Elegir (o crear) un Smart Template
Un Smart Template decide qué secciones genera Telepatia y cómo se forma cada una. Constrúyalo una vez con nodos Telepatia curados, reúselo entre consultas.
Liste los Smart Templates ya creados para su cuenta:
curl https://scribe-api.telepatia.ai/v1/medical-record-configurations \
-H "Authorization: Bearer SU_CLAVE_API"
curl -X POST https://scribe-api.telepatia.ai/v1/medical-record-configurations \
-H "Authorization: Bearer SU_CLAVE_API" \
-H "Content-Type: application/json" \
-d '{
"name": "General Consultation",
"configuration": {
"chiefComplaint": {
"instructionSet": { "telepatiaPromptId": "CHIEF_COMPLAINT" },
"schema": {
"type": "object",
"instructions": "Chief complaint",
"properties": {
"chiefComplaint": { "type": "string", "instructions": "Patient words" }
}
}
},
"historyOfPresentIllness": {
"instructionSet": {
"telepatiaPromptId": "HISTORY_OF_PRESENT_ILLNESS",
"values": { "hpi_length": "long" }
},
"schema": {
"type": "object",
"instructions": "HPI",
"properties": {
"narrative": { "type": "string", "instructions": "Chronological HPI" }
}
}
}
}
}'
id retornado (ej. mrc_a1b2c3d4e5f6g7h8) — lo pasará a set-consultation-context enseguida.
Puede saltar la creación explícita y enviar el JSON completo inline como medicalRecordConfiguration en set-consultation-context. Telepatia hashea y deduplica contra templates existentes automáticamente. Vea Smart Templates. Paso 1: Establecer contexto de consulta
Antes de la consulta, envíe la información del paciente a Telepatia. Incluya un consultationInternalId — su propio identificador que vincula la sesión con su sistema. Si lo omite, Telepatia genera uno. Adjunte el Smart Template del Paso 0 vía medicalRecordConfigurationId.
curl -X POST https://scribe-api.telepatia.ai/v1/set-consultation-context \
-H "Authorization: Bearer SU_CLAVE_API" \
-H "Content-Type: application/json" \
-d '{
"name": "John Doe",
"idCountry": "CO",
"idType": "CC",
"idValue": "123456789",
"notes": "Paciente reporta dolor de cabeza recurrente y mareos",
"pastMedicalHistory": "Hipertensión diagnosticada en 2020. Diabetes Tipo 2 controlada con metformina.",
"consultationInternalId": "CONSULT-12345",
"scribeSessionModality": "IN_PERSON",
"medicalRecordConfigurationId": "mrc_a1b2c3d4e5f6g7h8"
}'
Las integraciones legadas aún pueden pasar scribeSessionConfigurationId — vea Plantillas de Sesión. Las nuevas integraciones deben usar Smart Templates. {
"success": true,
"consultationInternalId": "CONSULT-12345"
}
Guarde el consultationInternalId de la respuesta. Lo necesitará en los siguientes pasos — tanto para generar el enlace de inicio de sesión como para recuperar los resultados de la sesión después.
Paso 2: Generar un enlace de inicio de sesión
Genere un código de verificación para abrir el scribe de Telepatia. Pase el consultationInternalId para que la sesión quede vinculada al contexto de consulta que estableció en el Paso 1.
curl -X POST https://scribe-api.telepatia.ai/v1/auth/login \
-H "Authorization: Bearer SU_CLAVE_API" \
-H "Content-Type: application/json" \
-d '{"consultationInternalId": "CONSULT-12345"}'
{
"code": "a1b2c3d4e5",
"expiresAt": "2026-02-20T18:30:00+00:00",
"expiresIn": 300,
"redirectUrl": "https://scribe-beta.telepatia.ai/sign-in?code=a1b2c3d4e5&consultationInternalId=CONSULT-12345"
}
redirectUrl para abrir el scribe de Telepatia.
Paso 3: Realizar la sesión
Una vez que el usuario es redirigido, llegará a la interfaz del scribe de Telepatia. Desde ahí:
- El scribe comienza a grabar la consulta
- El médico realiza la visita como de costumbre
- Al terminar, el médico finaliza la sesión en el scribe
No se necesitan llamadas a la API durante este paso — todo ocurre en la aplicación Telepatia.
Paso 4: Recuperar el registro completo
El paso 4 tiene dos partes: confirmar que la sesión terminó, y luego obtener los documentos de registro médico (la salida completa de su Smart Template).
4a. Verificar el estado de la sesión
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"
}
Siga consultando mientras status esté en curso (created, recording, stopped, processing). Los documentos están listos cuando status sea completed o completedWithErrors. error y cancelled significan que no se producirán documentos. Vea Ciclo de vida de la sesión para la lista completa. 4b. Obtener los documentos de registro médico
Una vez que la sesión llegue a completed o completedWithErrors, recupere el o los registros completos. Una sesión puede producir varios documentos (uno por purpose — primary, rpa, emr, …). Filtre con ?purpose=primary para obtener el del médico:
curl "https://scribe-api.telepatia.ai/v1/scribe-sessions/CONSULT-12345/medical-record-documents?purpose=primary" \
-H "Authorization: Bearer SU_CLAVE_API"
{
"items": [
{
"id": "mrd-abc-123",
"purpose": "primary",
"specialty": "Cardiology",
"language": "en",
"medicalRecordSummary": "Paciente reporta cefalea recurrente y mareos.",
"createdAt": "2026-02-20T10:30:00Z",
"updatedAt": "2026-02-20T10:35:00Z",
"medicalRecord": {
"sections": []
}
}
],
"total": 1
}
medicalRecordSummaryStructured y los valores de purpose disponibles.
