Inicio rápido

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 Prompts 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"

Si aún no tiene uno, créelo. El ejemplo de abajo usa dos Secciones Telepatia — vea el catálogo completo:

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" }
          }
        }
      }
    }
  }'

Guarde el 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.

Respuesta:

{
  "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"}'

Respuesta:

{
  "code": "a1b2c3d4e5",
  "expiresAt": "2026-02-20T18:30:00+00:00",
  "expiresIn": 300,
  "redirectUrl": "https://scribe.telepatia.ai/sign-in?code=a1b2c3d4e5&consultationInternalId=CONSULT-12345"
}

Redirija al usuario a la 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"

Respuesta:

{
  "id": "ss_a1b2c3d4e5f6g7h8",
  "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"

Respuesta:

{
  "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
}

Vea Documentos de Registro Médico para la forma completa de la respuesta, incluyendo medicalRecordSummaryStructured y los valores de purpose disponibles.

Primeros Pasos

Consultas

Sesiones de Scribe

Soporte a la Decisión Clínica

Webhooks

Smart Templates

Plantillas de Sesión

Cuentas

Pacientes

Referencia

Requisitos previos

Paso 0: Elegir (o crear) un Smart Template

Paso 1: Establecer contexto de consulta

Paso 2: Generar un enlace de inicio de sesión

Paso 3: Realizar la sesión

Paso 4: Recuperar el registro completo

4a. Verificar el estado de la sesión

4b. Obtener los documentos de registro médico

​Requisitos previos

​Paso 0: Elegir (o crear) un Smart Template

​Paso 1: Establecer contexto de consulta

​Paso 2: Generar un enlace de inicio de sesión

​Paso 3: Realizar la sesión

​Paso 4: Recuperar el registro completo

​4a. Verificar el estado de la sesión

​4b. Obtener los documentos de registro médico

Requisitos previos

Paso 0: Elegir (o crear) un Smart Template

Paso 1: Establecer contexto de consulta

Paso 2: Generar un enlace de inicio de sesión

Paso 3: Realizar la sesión

Paso 4: Recuperar el registro completo

4a. Verificar el estado de la sesión

4b. Obtener los documentos de registro médico