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 | Sí | Nombre completo del paciente |
idCountry | Sí | País del documento de identidad (ISO alfa-2, alfa-3 o nombre completo) |
idType | Sí | Tipo de documento de identidad (ver tabla a continuación) |
idValue | Sí | Número del documento |
scribeSessionConfigurationId | No | ID de plantilla de /v1/scribe-session-configurations. Pre-selecciona la estructura de documentación para la sesión. |
scribeSessionModality | No | IN_PERSON o REMOTE |
notes | No | Notas clínicas en texto libre visibles para el médico |
pastMedicalHistory | No | Historial médico del paciente |
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.
Ejemplo de solicitud
curl -X POST https://synapse.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",
"scribeSessionConfigurationId": "ssc_a1b2c3d4e5f6g7h8"
}'
{
"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.
