> ## 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.
# Consultas
> Configurar el contexto del paciente antes de una sesión de scribe
La llamada de contexto de consulta envía la identidad e información clínica del paciente a Telepatia antes de que comience una sesión. Telepatia utiliza estos datos para pre-cargar el registro del paciente en la interfaz del scribe y vincular la sesión completada de vuelta a su sistema.
Llame a este endpoint **antes** de generar un enlace de inicio de sesión. Si lo omite, la sesión de scribe iniciará sin contexto del paciente.
## Campos principales
| Campo | Requerido | Descripción |
| ------------------------------ | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `consultationInternalId` | No | Su ID interno para esta consulta. Si se omite, Telepatia genera uno. Se utiliza para recuperar la sesión después. |
| `name` | Condicional | Nombre completo del paciente. Requerido a menos que se envíe `patientId`. |
| `idCountry` | Condicional | País del documento de identidad (ISO alfa-2, alfa-3 o nombre completo). Requerido a menos que se envíe `patientId`. |
| `idType` | Condicional | Tipo de documento de identidad (ver tabla a continuación). Requerido a menos que se envíe `patientId`. |
| `idValue` | Condicional | Número del documento. Requerido a menos que se envíe `patientId`. |
| `patientId` | Condicional | ID público de un paciente existente (`sp_...`, de [Pacientes](/es/scribe-api/patients)). Úselo en lugar de los campos de identidad inline. Mutuamente excluyente con `name` / `idCountry` / `idType` / `idValue`. |
| `medicalRecordConfiguration` | No | **Smart Template inline (recomendado).** JSON completo; el servidor deduplica por hash de contenido. Vea [Smart Templates](/es/scribe-api/smart-templates). |
| `medicalRecordConfigurationId` | No | Smart Template por id (de `/v1/medical-record-configurations`). |
| `scribeSessionConfigurationId` | No | ID de Plantilla de Sesión legada (de `/v1/scribe-session-configurations`). |
| `scribeSessionModality` | No | `IN_PERSON` o `TELEMEDICINE` |
| `notes` | No | Notas clínicas en texto libre visibles para el médico |
| `pastMedicalHistory` | No | Historial médico del paciente |
Identifique al paciente **ya sea** con los campos inline (`name`, `idCountry`, `idType`, `idValue`) **o** con `patientId` — nunca ambos. Referenciar a un paciente existente con `patientId` reutiliza su identidad almacenada, así evita reenviarla y nunca crea un duplicado. Enviar ambos, o una identidad inline incompleta sin `patientId`, retorna un error `400`.
## Documentos aceptados por país
| País | `idCountry` | Documento | `idType` | Formato |
| -------------- | ------------------------- | --------------------- | ----------- | ------------------------- |
| Colombia | `CO` / `COL` / `COLOMBIA` | Cédula de Ciudadanía | `CC` | 8–10 dígitos |
| Colombia | | Tarjeta de Identidad | `TI` | 10–11 dígitos |
| Colombia | | Cédula de Extranjería | `CE` | 6–7 dígitos |
| Colombia | | Registro Civil | `RC` | 1–11 dígitos |
| Brasil | `BR` / `BRA` / `BRAZIL` | Registro Geral | `RG` | 7–9 alfanumérico |
| Brasil | | CPF | `CPF` | XXX.XXX.XXX-XX |
| Cualquier país | — | Pasaporte | `PASSPORT` | 6–9 alfanumérico |
| Cualquier país | — | Otro | `OTHER_DOC` | Cualquier cadena no vacía |
El `idType` debe ser válido para el `idCountry` dado. Por ejemplo, enviar `CC` con `idCountry: BR` retorna un error `400`.
## Templates: pase exactamente uno
`medicalRecordConfiguration`, `medicalRecordConfigurationId` y `scribeSessionConfigurationId` son **mutuamente excluyentes** — pase como máximo uno. Recomendamos la forma inline `medicalRecordConfiguration`: es reproducible, le permite versionar el template junto a su código, y el servidor deduplica por hash de contenido para que no acumule duplicados.
## Ejemplo de solicitud — Smart Template inline (recomendado)
```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 '{
"consultationInternalId": "CONSULT-12345",
"name": "John Doe",
"idCountry": "CO",
"idType": "CC",
"idValue": "123456789",
"notes": "Paciente reporta dolor de cabeza recurrente",
"pastMedicalHistory": "Hipertensión diagnosticada en 2020",
"scribeSessionModality": "IN_PERSON",
"medicalRecordConfiguration": {
"chiefComplaint": {
"instructionSet": { "telepatiaPromptId": "CHIEF_COMPLAINT" },
"schema": {
"type": "object",
"instructions": "Chief complaint",
"properties": {
"chiefComplaint": { "type": "string", "instructions": "Patient words" }
}
}
}
}
}'
```
## Ejemplo de solicitud — Smart Template por id
```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 '{
"consultationInternalId": "CONSULT-12345",
"name": "John Doe",
"idCountry": "CO",
"idType": "CC",
"idValue": "123456789",
"scribeSessionModality": "IN_PERSON",
"medicalRecordConfigurationId": "mrc_a1b2c3d4e5f6g7h8"
}'
```
## Ejemplo de solicitud — referenciar un paciente existente
```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 '{
"consultationInternalId": "CONSULT-12345",
"patientId": "sp_a1b2c3d4e5f6g7h8",
"scribeSessionModality": "IN_PERSON"
}'
```
**Respuesta:**
```json theme={null}
{
"success": true,
"consultationInternalId": "CONSULT-12345"
}
```
Guarde el `consultationInternalId` — lo necesitará para generar el enlace de inicio de sesión y recuperar los resultados de la sesión.