Saltar al contenido principal

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.

El flujo de trabajo: se introducen datos como el teléfono, el idioma y el paciente; el nodo Llamar al paciente realiza la llamada; según las condiciones, se redacta una nota, se crea una tarea urgente para que el médico devuelva la llamada o se crea una tarea de reintento; cada llamada se audita.

Antes de empezar​

NecesitasDetalle
Telephony set up by an operatorLas 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 fromUn 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ínicasUna llamada con el perfil clinical es rechazada en un motor que procesa fuera de la UE.
An organization-owned agentUn agente de plantilla base no se ejecutará. Copie primero voice-clinical-followup en su organización (Crear un agente).
A FHIR server for the TasksEn 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.
PermissionsApps → 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 numberLa 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).

  1. Abrir Apps → Voice Workflows.
  2. 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í".
  3. Rellene Call details. Hay un campo por cada entrada del flujo de trabajo, y los campos obligatorios valen *:
CampoEjemploNotas
Patient name *Test Patient ASe utiliza en el saludo
Patient id *el ID de paciente FHIRVincula las tareas de seguimiento con el paciente. No se incluye en el mensaje enviado al proveedor de voz.
Phone *+34600000000E.164, con código de país
Languagees-ESControla el reconocimiento de voz. Un valor incorrecto produce una transcripción sin sentido.
Discharge date2026-09-15Contexto opcional
  1. Seleccione Place call. El botón permanecerá desactivado hasta que se completen los campos obligatorios.
No utilice el botón de reproducción en una tarjeta de flujo de trabajo de Studio.

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 llamadaUn 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 nodoTipoObjetivo
pipeline-inputinputEl formulario: phone, language, patient_id, patient_name, discharge_date. Obligatorio: teléfono, nombre del paciente, ID del paciente.
call-patientvoice-callRealiza la llamada y espera a que termine.
should-document y luego draft-notecondition, agent-runCuando la llamada sea documentable, redacte una nota.
needs-human, build-task, create-taskcondition, transform, fhir-crudCuando escalation_requested, crea la tarea urgente
unreached, build-retry, create-retrycondition, transform, fhir-crudCuando answered es falso, crea la tarea de reintento.
audit-callauditSiempre graba la llamada
followup-resultoutputDevuelva 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)EjemploSignificado
from (Caller ID){{CLINIC_CALLER_ID}}Identificador de llamadas. Debe pertenecer a su organización.
profile (Risk Profile)clinicalAplica las garantías clínicas (se requiere un motor de la UE).
agent_id (Agent)voice-clinical-followupEl agente propiedad de la organización que realiza la llamada
language (Language)es-ESUn código de idioma BCP-47
timezone (Time Zone)Europe/MadridZona 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))600Artículos de segunda clase
machine_detection (Detect Answering Machine)trueValor 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)trueMantenga el flujo de trabajo hasta que finalice la llamada.
record (Record Call)falseLa 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 JSONLas 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:

  1. 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.
  2. Las respuestas requeridas. El outcome_schema. Defínalo primero. El modelo lee description de cada campo, así que escríbalo como una instrucción. La versión prefabricada requiere identity_confirmed, pain_controlled, wound_concern y taking_medication.
  3. Información relevante para esta llamada. Entrada context: texto breve y legible sobre el paciente, no un volcado de historial clínico.
  4. 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​

ComenzarCómo
A manoApps → Voice Workflows → Place call
Mediante APIEjecuta el flujo de trabajo con {"pipeline_id": "...", "inputs": {"phone": "...", ...}} (consulta la referencia de la API).
Con temporizadorUn nodo scheduler
En un evento FHIRUn nodo fhir-webhook
No hay ningún disparador "posterior a la descarga" prefabricado

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​

  1. Introduce tu número de teléfono en el formulario, en el idioma correcto.
  2. Realiza la llamada y contesta. Comprueba que el mensaje indique que es automático y que te pida tu identificación primero.
  3. Diga "Tengo dolor en el pecho" y compruebe que la llamada se escala y aparece una tarea urgente.
  4. Realiza otra llamada y no contestes. Comprueba que aparezca retry-call tareas.
  5. 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​

BrechaConsecuencia
No hay ventana de llamadasSe puede llamar a cualquier hora, incluso por la noche.
Sin rellamada automáticaretry-call Las tareas se acumulan y nada las consume. Alguien debe trabajar en la cola.
Sin consentimiento o verificación de no llamarDebes verificar el derecho a llamar a cada número.
No hay propietario en las tareasDecida 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 entrantesLa plataforma realiza las llamadas; no las contesta.

Cuando algo sale mal​

SíntomaCausaArreglar
voice call service is not configured on this deploymentLa telefonía no está habilitada.Solicite a su operador que configure el operador y la URL base pública.
to (or phone) input is requiredEl 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 callEl 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 organizationEl número from no es tuyo.Utilice un número asignado a su organización.
Una transcripción sin sentidoIncorrecto languageEstablecer el código de idioma del paciente
Una puerta falla con field 'documentable' not found in inputsUna 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..