> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telepatia.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Inicio rápido
> Integre con el scribe de Telepatia en menos de 5 minutos
## Requisitos previos
* Una clave API de Telepatia (contacte a su gerente de cuenta para obtenerla)
* La URL base (consulte la [descripción general](/es/scribe-api/index))
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](/es/scribe-api/telepatia-nodes) curados, reúselo entre consultas.
Liste los Smart Templates ya creados para su cuenta:
```bash theme={null}
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](/es/scribe-api/telepatia-nodes):
```bash theme={null}
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](/es/scribe-api/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`.
```bash theme={null}
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](/es/scribe-api/session-templates). Las nuevas integraciones deben usar Smart Templates.
**Respuesta:**
```json theme={null}
{
"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.
```bash theme={null}
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:**
```json theme={null}
{
"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í:
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 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
```bash theme={null}
curl https://scribe-api.telepatia.ai/v1/scribe-sessions/CONSULT-12345 \
-H "Authorization: Bearer SU_CLAVE_API"
```
**Respuesta:**
```json theme={null}
{
"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](/es/scribe-api/scribe-sessions#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:
```bash theme={null}
curl "https://scribe-api.telepatia.ai/v1/scribe-sessions/CONSULT-12345/medical-record-documents?purpose=primary" \
-H "Authorization: Bearer SU_CLAVE_API"
```
**Respuesta:**
```json theme={null}
{
"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](/es/scribe-api/medical-record-documents) para la forma completa de la respuesta, incluyendo `medicalRecordSummaryStructured` y los valores de `purpose` disponibles.