Receta: Llamada de seguimiento telefónico posterior al alta
Objetivo: tras el alta del paciente, un asistente automatizado lo llama por teléfono, confirma su identidad, le formula una serie de preguntas predefinidas sobre su recuperación (dolor, herida, fiebre, medicación) y registra las respuestas. Si algo preocupa al paciente o al asistente, se crea una tarea para que el médico vuelva a llamarlo. Si nadie contesta, se crea una tarea para reintentar la llamada.
Antes de empezar
| Necesitas | Detalle |
|---|---|
| Telephony set up by an operator | Las llamadas de voz se realizan a través de un operador (Twilio es el único implementado). Su operador Tietai lo configura mediante los ajustes de implementación, no en la aplicación. Si está desactivado, la página de Flujos de trabajo de voz no podrá realizar llamadas. |
| A number you may call from | Un identificador de llamada en formato E.164 (por ejemplo, +34910000000) asignado a su organización. |
| Un motor de voz residente en la UE para llamadas clínicas | Una llamada con el perfil clinical es rechazada en un motor que procesa fuera de la UE. |
| An organization-owned agent | Un agente de plantilla base no se ejecutará. Copie primero voice-clinical-followup en su organización (Crear un agente). |
| A FHIR server for the Tasks | En la definición predefinida, los dos nodos Task toman su servidor y token de los marcadores de posición {{FHIR_BASE_URL}} y {{FHIR_BEARER_TOKEN}}. Verifique que se resuelvan en su implementación; de lo contrario, no se escribirá ninguna tarea. |
| Permissions | Apps → Voice Workflows solo aparece con el permiso de filtrado por voz. Para editar el flujo de trabajo en Studio se necesitan permisos de flujo de trabajo. |
| The right to call this number | La plataforma no verifica el consentimiento para recibir llamadas. Solo se exige el consentimiento para grabar. Confirme su derecho a llamar antes de realizar una llamada. |
Realiza una llamada con el flujo de trabajo predefinido.
El entorno de desarrollo cuenta con dos flujos de trabajo predefinidos: Post-Discharge Voice Follow-Up y Wearables Wellness Check-In (son flujos de trabajo guardados, no forman parte de todas las organizaciones automáticamente; la lista que aparece a continuación muestra solo los flujos de trabajo de su organización que contienen un nodo voice-call).
- Abrir Apps → Voice Workflows.
- Debajo de Workflows (
Pipelines of your organisation that place a call), elija Post-Discharge Voice Follow-Up. Si la lista está vacía, la página dice "Aún no hay ningún flujo de trabajo con un nodo de llamada de voz. Cree uno en Studio y aparecerá aquí". - Rellene Call details. Hay un campo por cada entrada del flujo de trabajo, y los campos obligatorios valen
*:
| Campo | Ejemplo | Notas |
|---|---|---|
Patient name * | Test Patient A | Se utiliza en el saludo |
Patient id * | el ID de paciente FHIR | Vincula las tareas de seguimiento con el paciente. No se incluye en el mensaje enviado al proveedor de voz. |
Phone * | +34600000000 | E.164, con código de país |
| Language | es-ES | Controla el reconocimiento de voz. Un valor incorrecto produce una transcripción sin sentido. |
| Discharge date | 2026-09-15 | Contexto opcional |
- Seleccione Place call. El botón permanecerá desactivado hasta que se completen los campos obligatorios.
En la lista de flujos de trabajo de Studio, el botón de reproducción de una tarjeta de flujo de trabajo la ejecuta sin introducir datos y aplica los valores predeterminados de la demostración. Utilice siempre el formato Call details en esta página o el Run with inputs en Studio.
Sigue la llamada
La tarjeta central se titula Call to <number> y muestra un estado: En cola, Sonando, En curso, Completado, Transferido a un médico, Sin respuesta, Ocupado, Rechazado, Fallido o Cancelado. La pestaña Transcript muestra la conversación como burbujas de Asistente y Paciente. La pestaña Recent calls (derecha) muestra las llamadas de su organización; un triángulo marca una llamada en la que el asistente solicitó un médico.
Revisar el resultado
Abra la pestaña Outcome Muestra una advertencia si el asistente solicitó un médico, las respuestas Captured during the call y What the workflow did next:
| ¿Qué pasó en la llamada? | Qué hace el flujo de trabajo |
|---|---|
| El paciente habló y confirmó su identidad. | Un agente redacta una nota clínica a partir de la transcripción, que se muestra como Draft clinical note con el mensaje "Escrito por el flujo de trabajo a partir de la transcripción. Revisar antes de que llegue al registro". |
| Se solicitó una escalada (dolor en el pecho, dificultad para respirar, sangrado o herida abierta, medicación o pregunta "¿esto es normal?", angustia, solicitud de una persona, respuestas contradictorias). | FHIR Task: prioridad urgente, código clinician-callback, vinculado al paciente. El asistente también transfiere la llamada a su número de equipo clínico. |
| Nadie respondió (sin respuesta, ocupado, rechazado, buzón de voz) | A FHIR Task: rutina de prioridad, código retry-call |
| Cada llamada | Un registro de auditoría (clinical_followup_call) con el resultado |
Lee las tareas de tu servidor FHIR con Task?patient=<patient id>.
Construye o adapta el tuyo propio.
Siga el método general en Crear cualquier flujo de trabajo. Las partes específicas para cada voz se encuentran a continuación.
Los nodos
| ID del nodo | Tipo | Objetivo |
|---|---|---|
pipeline-input | input | El formulario: phone, language, patient_id, patient_name, discharge_date. Obligatorio: teléfono, nombre del paciente, ID del paciente. |
call-patient | voice-call | Realiza la llamada y espera a que termine. |
should-document y luego draft-note | condition, agent-run | Cuando la llamada sea documentable, redacte una nota. |
needs-human, build-task, create-task | condition, transform, fhir-crud | Cuando escalation_requested, crea la tarea urgente |
unreached, build-retry, create-retry | condition, transform, fhir-crud | Cuando answered es falso, crea la tarea de reintento. |
audit-call | audit | Siempre graba la llamada |
followup-result | output | Devuelva el resultado de la auditoría y la nota redactada. |
Conecte cada condición a los puertos declarados del nodo (field, context). Mantenga el borde de auditoría abierto para que se registre cada llamada.
Configuración del nodo voice-call
| Configuración (etiqueta) | Ejemplo | Significado |
|---|---|---|
from (Caller ID) | {{CLINIC_CALLER_ID}} | Identificador de llamadas. Debe pertenecer a su organización. |
profile (Risk Profile) | clinical | Aplica las garantías clínicas (se requiere un motor de la UE). |
agent_id (Agent) | voice-clinical-followup | El agente propiedad de la organización que realiza la llamada |
language (Language) | es-ES | Un código de idioma BCP-47 |
timezone (Time Zone) | Europe/Madrid | Zona IANA de la persona llamada. Decide el {{GREETING}} ("Buenos días", "Buenas tardes", "Buenas noches") en la línea inicial. Si está vacío, se vuelve a la configuración predeterminada de despliegue, y luego al país marcado si tiene una sola zona horaria; si no se puede establecer la hora, el saludo no indica ninguna hora del día. España y Portugal no se pueden resolver a partir del código de marcación (Islas Canarias, Azores), así que configúrelo. |
transfer_to (Transfer Destination) | {{CLINICAL_TEAM_NUMBER}} | Cuando se transfiere una llamada escalada |
max_duration (Max Duration (seconds)) | 600 | Artículos de segunda clase |
machine_detection (Detect Answering Machine) | true | Valor predeterminado false. Informar cuando el operador cree que se respondió el mensaje de voz, por lo que se registra como no contestado. |
wait_for_completion (Wait For Completion) | true | Mantenga el flujo de trabajo hasta que finalice la llamada. |
record (Record Call) | false | La grabación está desactivada por defecto. Para activarla se requiere un consent_script |
first_message (Opening Line) | "Hello, this is the automated assistant of {{CLINIC_NAME}}, on behalf of your care team..." | La primera frase. La línea predefinida indica que la llamada es automática, y las propias instrucciones del agente exigen esa divulgación, así que manténgala en cualquier línea que escriba. |
outcome_schema (Outcome Schema) | un esquema JSON | Las respuestas que necesitas |
Los valores en {{...}}, como {{CLINIC_CALLER_ID}}, {{CLINICAL_TEAM_NUMBER}} y {{CLINIC_NAME}} se rellenan automáticamente por su implementación, o puede escribir el valor real en el nodo.
Escribe el guion
Una llamada tiene cuatro partes:
- Las preguntas. El conjunto de preguntas del agente: identidad, un buen momento para hablar, dolor, herida, fiebre, medicación, cualquier otra cosa. Empiece con una solicitud en línea en el nodo mientras itera y trasládela al agente cuando esté estable.
- Las respuestas requeridas. El
outcome_schema. Defínalo primero. El modelo leedescriptionde cada campo, así que escríbalo como una instrucción. La versión prefabricada requiereidentity_confirmed,pain_controlled,wound_concernytaking_medication. - Información relevante para esta llamada. Entrada
context: texto breve y legible sobre el paciente, no un volcado de historial clínico. - La primera frase.
first_message.
Para cambiar un agente de plantilla base que distribuya en voice-clinical-followup.yaml, aumente su version: al arrancar se omite una versión inferior o igual.
Elige cómo empieza
| Comenzar | Cómo |
|---|---|
| A mano | Apps → Voice Workflows → Place call |
| Mediante API | Ejecuta el flujo de trabajo con {"pipeline_id": "...", "inputs": {"phone": "...", ...}} (consulta la referencia de la API). |
| Con temporizador | Un nodo scheduler |
| En un evento FHIR | Un nodo fhir-webhook |
El flujo de trabajo predefinido comienza con su formulario de entrada. Un temporizador (un nodo scheduler, que se agrega automáticamente con el nodo Schedule del menú Ejecutar) ejecuta un flujo de trabajo sin entradas, y una ejecución sin entradas utiliza los valores predeterminados de demostración del nodo de entrada. Ningún flujo de trabajo incluido se activa cuando un paciente recibe el alta ni asigna el número de teléfono de un paciente de un evento FHIR a la llamada. Si crea uno, pruébelo cuidadosamente y mantenga a una persona al tanto.
Pruébalo tú mismo
- Introduce tu número de teléfono en el formulario, en el idioma correcto.
- Realiza la llamada y contesta. Comprueba que el mensaje indique que es automático y que te pida tu identificación primero.
- Diga "Tengo dolor en el pecho" y compruebe que la llamada se escala y aparece una tarea urgente.
- Realiza otra llamada y no contestes. Comprueba que aparezca
retry-calltareas. - No cuentes con el Dry run para evitar la marcación: en el Builder se guarda y funciona exactamente igual que Run (sigue el Test Live). Prueba el cableado con tu propio número.
Normas de seguridad que sigue el asistente
- Solo recopila información y la gestiona de forma inmediata. No interpreta síntomas, no ofrece consejos ni indica urgencia.
- La identidad es lo primero. No se proporciona información clínica hasta que la persona confirme su identidad. Un desconocido no recibe ninguna información. El mensaje de voz solo indica el nombre de la clínica y solicita que se le devuelva la llamada.
- Cualquier incertidumbre agrava la situación: respuestas contradictorias, angustia o cualquier cosa que no esté incluida en la lista de preguntas.
- Una persona revisa el borrador de la nota y trabaja en la cola de tareas.
- Lee la transcripción, no el audio, por lo que la falta de aliento, el habla arrastrada o el llanto pueden pasar desapercibidos, y un simple "Estoy bien" puede enmascarar la angustia. La escalada generalizada es la atenuante.
Privacidad: el ID del paciente no se incluye en el mensaje enviado al proveedor de voz, y las herramientas se ejecutan Tietai con aislamiento de inquilino, protección de información de salud protegida (PHI) y auditoría. Las grabaciones están desactivadas por defecto y caducan (a los 30 días, a menos que la implementación establezca lo contrario). Las transcripciones se conservan indefinidamente, a menos que la implementación establezca un período de retención; ambas configuraciones dependen del operador.
Lo que no está construido
| Brecha | Consecuencia |
|---|---|
| No hay ventana de llamadas | Se puede llamar a cualquier hora, incluso por la noche. |
| Sin rellamada automática | retry-call Las tareas se acumulan y nada las consume. Alguien debe trabajar en la cola. |
| Sin consentimiento o verificación de no llamar | Debes verificar el derecho a llamar a cada número. |
| No hay propietario en las tareas | Decida quién supervisa clinician-callback y retry-call |
| No hay configuración de voz por organización. | Los números y la configuración del motor son aplicables a toda la implementación. |
| No se aceptan llamadas entrantes | La plataforma realiza las llamadas; no las contesta. |
Cuando algo sale mal
| Síntoma | Causa | Arreglar |
|---|---|---|
voice call service is not configured on this deployment | La telefonía no está habilitada. | Solicite a su operador que configure el operador y la URL base pública. |
to (or phone) input is required | El flujo de trabajo se ejecutó sin entradas. | Utilice la forma Call details o Run with inputs |
| La ejecución permanece en espera después de que finaliza la llamada. | El aviso de finalización de llamada del operador no llegó o su firma no coincidía. | Abra la ejecución en Monitor y lea el error registrado; pídale a su operador que verifique la URL pública. |
engine ... processes in us and cannot carry a clinical call | El perfil clínico se basa en un motor de búsqueda no perteneciente a la UE. | Su operador debe configurar el motor de la UE. |
caller id ... belongs to another organization | El número from no es tuyo. | Utilice un número asignado a su organización. |
| Una transcripción sin sentido | Incorrecto language | Establecer el código de idioma del paciente |
Una puerta falla con field 'documentable' not found in inputs | Una condición está conectada a un puerto no declarado. | Conéctalo al puerto field o context declarado. |
¿Algo no está claro? Envíe sus comentarios sobre la documentación por correo electrónico..