Saltar al contenido principal

​
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: Listar plantillas de sesión (opcional)

Las plantillas de sesión de scribe definen la estructura de la documentación médica generada durante la consulta (ej. “Consulta de Cardiología”, “Medicina General”). Obtener la lista antes de la consulta le permite presentar un selector de plantillas al médico o asignar una automáticamente según la especialidad. 
curl https://synapse.telepatia.ai/v1/scribe-session-configurations \
  -H "Authorization: Bearer SU_CLAVE_API"
Respuesta: 
{
  "items": [
    { "id": "ssc_a1b2c3d4e5f6g7h8", "name": "Consulta de Cardiología" },
    { "id": "ssc_i9j0k1l2m3n4o5p6", "name": "Medicina General" }
  ],
  "total": 2,
  "page": 1,
  "limit": 20,
  "totalPages": 1
}
Guarde el id de la plantilla deseada — lo pasará como scribeSessionConfigurationId en el Paso 1.

​
Paso 1: Establecer contexto de consulta

Antes de la consulta, envíe la información del paciente a Telepatia. Debe incluir un consultationInternalId — este es su propio identificador interno que vincula la sesión con su sistema. Si no lo proporciona, Telepatia generará uno automáticamente. Opcionalmente pase un scribeSessionConfigurationId (del Paso 0) para pre-seleccionar la plantilla de documentación para esta sesión. 
curl -X POST https://synapse.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",
    "scribeSessionConfigurationId": "ssc_a1b2c3d4e5f6g7h8"
  }'
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://synapse.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/#/onboarding/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í:
  1. El scribe comienza a grabar la consulta
  2. El médico realiza la visita como de costumbre
  3. 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 la sesión de scribe

Después de que la sesión haya finalizado, recupere los resultados usando el consultationInternalId: 
curl https://synapse.telepatia.ai/v1/scribe-sessions/CONSULT-12345 \
  -H "Authorization: Bearer SU_CLAVE_API"
Respuesta: 
{
  "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",
  "medicalRecordMutable": {
    "chiefComplaint": {
      "title": "Chief Complaint",
      "type": "text",
      "status": "completed",
      "content": "Patient reports headache"
    }
  }
}
Si la sesión aún está en progreso, el campo status lo reflejará. Puede consultar este endpoint hasta que el estado sea completed.