Aller au contenu principal

Recette : Appel de suivi vocal après la sortie de l'hôpital

Objectif : après le retour à domicile du patient, un assistant automatisé l’appelle pour confirmer son identité, lui poser une série de questions prédéfinies sur sa convalescence (douleur, plaie, fièvre, médicaments) et enregistrer ses réponses. En cas d’inquiétude du patient ou de l’assistant, une demande de rappel par un professionnel de santé est automatiquement déclenchée. Si personne ne répond, une nouvelle tentative est effectuée.

Le flux de travail : une entrée fournit le numéro de téléphone, la langue et le patient ; le nœud « Appeler le patient » passe l’appel ; des conditions permettent ensuite de rédiger une note, de créer une tâche de rappel urgent du clinicien ou de créer une tâche de nouvelle tentative ; chaque appel est audité.

Avant de commencer​

Vous avez besoinDétail
Telephony set up by an operatorLa voix transite par un opérateur (Twilio est le seul implémenté). Sa configuration est assurée par votre opérateur Tietai via les paramètres de déploiement, et non par l'application. Si cette option est désactivée, la page « Flux de travail vocaux » ne permet pas de passer d'appels.
A number you may call fromUn identifiant d'appelant au format E.164 (par exemple +34910000000) attribué à votre organisation.
Un moteur vocal basé dans l'UE pour les appels cliniquesUn appel avec le profil clinical est refusé sur un moteur qui traite les requêtes en dehors de l'UE.
An organization-owned agentUn agent basé sur un modèle de base ne peut pas être exécuté. Veuillez d'abord copier voice-clinical-followup dans votre organisation (Créer un agent).
A FHIR server for the TasksDans la définition prédéfinie, les deux nœuds de tâche utilisent les espaces réservés {{FHIR_BASE_URL}} et {{FHIR_BEARER_TOKEN}} pour leur serveur et leur jeton. Vérifiez qu'ils sont correctement résolus dans votre déploiement, sinon aucune tâche ne sera créée.
PermissionsLe chiffre Apps → Voice Workflows n'apparaît que si l'autorisation de filtrage vocal est activée. La modification du flux de travail dans Studio nécessite les autorisations de flux de travail.
The right to call this numberLa plateforme ne vérifie pas le consentement à être appelé. Seul le consentement à l'enregistrement est obligatoire. Veuillez confirmer votre droit d'être appelé avant de passer un appel.

Passez un appel grâce au flux de travail prédéfini​

L'environnement de développement dispose de deux flux de travail prêts à l'emploi : Post-Discharge Voice Follow-Up et Wearables Wellness Check-In (il s'agit de pipelines enregistrés, qui ne font pas partie automatiquement de chaque organisation ; la liste ci-dessous ne montre que les pipelines de votre organisation qui contiennent un nœud voice-call).

  1. Ouvrir Apps → Voice Workflows.
  2. Sous Workflows (Pipelines of your organisation that place a call), choisissez Post-Discharge Voice Follow-Up. Si la liste est vide, la page indique « Aucun flux de travail avec un nœud d'appel vocal pour le moment. Créez-en un dans Studio et il apparaîtra ici. »
  3. Remplissez les champs vides Call details). Il y a un champ par entrée du flux de travail, et les champs obligatoires sont égaux *.
ChampExempleNotes
Patient name *Test Patient AUtilisé dans la salutation
Patient id *l'identifiant patient FHIRAssocie les tâches de suivi au patient. Cette information n'est pas incluse dans le message envoyé au fournisseur de services vocaux.
Phone *+34600000000E.164, avec code pays
Languagees-ESGère la reconnaissance vocale et la voix. Une valeur incorrecte produit une transcription incohérente.
Discharge date2026-09-15Contexte optionnel
  1. Choisissez Place call. Le bouton est désactivé tant que les champs obligatoires ne sont pas remplis.
N’utilisez pas le bouton de lecture sur une carte de flux de travail Studio.

Dans la liste des flux de travail de Studio, le bouton « Lecture » d'une fiche de flux de travail l'exécute sans aucune entrée et utilise les paramètres de démonstration par défaut. Utilisez toujours le formulaire Call details sur cette page ou Run with inputs dans Studio.

Suivez l'appel​

La fiche centrale, intitulée Call to <number>, indique le statut : En attente, Sonnerie, En cours, Terminé, Transféré à un clinicien, Pas de réponse, Occupé, Rejeté, Échec ou Annulé. L’onglet Transcript affiche la conversation sous forme de bulles pour l’assistant et le patient. L’onglet Recent calls (à droite) répertorie les appels de votre organisation ; un triangle signale un appel où l’assistant a demandé à parler à un clinicien.

Examiner le résultat​

Ouvrez l'onglet Outcome Il affiche un avertissement si l'assistant a demandé un clinicien, les réponses Captured during the call et What the workflow did next :

Que s'est-il passé lors de l'appel ?Que fait le flux de travail ?
Le patient a parlé et a confirmé son identité.Un agent rédige une note clinique à partir de la transcription, indiquée par Draft clinical note avec la mention « Rédigé par le flux de travail à partir de la transcription. À réviser avant d'être intégré au dossier. »
Une escalade a été demandée (douleur thoracique, difficulté respiratoire, saignement ou plaie ouverte, question sur un médicament ou « est-ce normal ? », détresse, demande d'intervention humaine, réponses contradictoires)Un FHIR Task : priorité urgente, code clinician-callback, lié au patient. L’assistant transfère également l’appel à votre numéro d’équipe clinique.
Personne n'a répondu (pas de réponse, occupé, message refusé, messagerie vocale)Une routine FHIR Task : priorité, code retry-call
Chaque appelUn enregistrement d'audit (clinical_followup_call) avec le résultat

Lisez les tâches de votre serveur FHIR avec Task?patient=<patient id>.

Construisez ou adaptez le vôtre​

Suivez la méthode générale décrite dans « Créer un flux de travail ». Les parties spécifiques à la voix sont présentées ci-dessous.

Les nœuds​

Identifiant du nœudTaperBut
pipeline-inputinputFormulaire : phone, language, patient_id, patient_name, discharge_date. Champs obligatoires : numéro de téléphone, nom du patient, identifiant du patient
call-patientvoice-callIl passe l'appel et attend qu'il se termine.
should-document puis draft-notecondition, agent-runLorsque l'appel est documentable, rédigez une note.
needs-human, build-task, create-taskcondition, transform, fhir-crudLorsque escalation_requested, créer la tâche urgente
unreached, build-retry, create-retrycondition, transform, fhir-crudLorsque answered est faux, créer la tâche de nouvelle tentative
audit-callauditEnregistrez toujours l'appel.
followup-resultoutputVeuillez renvoyer le résultat de l'audit et le projet de note.

Reliez chaque condition aux ports déclarés du nœud (field, context). Laissez le port d'audit ouvert afin que chaque appel soit enregistré.

Paramètres du nœud voice-call​

Paramètre (étiquette)ExempleSignification
from (Caller ID){{CLINIC_CALLER_ID}}Identification de l'appelant. Elle doit appartenir à votre organisation.
profile (Risk Profile)clinicalApplique les garanties cliniques (un moteur UE est requis)
agent_id (Agent)voice-clinical-followupL'agent appartenant à l'organisation qui effectue l'appel
language (Language)es-ESUn code de langue BCP-47
timezone (Time Zone)Europe/MadridZone IANA de la personne appelée. Détermine le {{GREETING}} (« Buenos días », « Buenas tardes », « Buenas noches ») sur la première ligne. Si cette option est vide, le message d'accueil utilise la valeur par défaut, puis le pays composé s'il n'a qu'un seul fuseau horaire ; si l'heure ne peut être déterminée, le message d'accueil n'indique aucune heure. L'Espagne et le Portugal ne peuvent pas être déterminés à partir de l'indicatif téléphonique (îles Canaries, Açores), il est donc nécessaire de le configurer.
transfer_to (Transfer Destination){{CLINICAL_TEAM_NUMBER}}Lorsqu'un appel escaladé est transféré
max_duration (Max Duration (seconds))600Secondes
machine_detection (Detect Answering Machine)trueValeur par défaut : false. Signale lorsque l’opérateur considère que le message vocal a été pris en charge, afin qu’il soit enregistré comme « pas de réponse ».
wait_for_completion (Wait For Completion)trueMaintenez le flux de travail en pause jusqu'à la fin de l'appel.
record (Record Call)falseL'enregistrement est désactivé par défaut. Pour l'activer, il faut appuyer sur consent_script
first_message (Opening Line)"Hello, this is the automated assistant of {{CLINIC_NAME}}, on behalf of your care team..."La première phrase. Le texte préétabli indique que l'appel est automatisé, et les instructions de l'agent exigent cette mention ; conservez-la donc dans toutes vos phrases.
outcome_schema (Outcome Schema)un schéma JSONLes réponses dont vous avez besoin

Les valeurs de {{...}} telles que {{CLINIC_CALLER_ID}}, {{CLINICAL_TEAM_NUMBER}} et {{CLINIC_NAME}} sont renseignées par votre déploiement, ou vous pouvez saisir la valeur réelle dans le nœud.

Écrivez le scénario​

Un appel comporte quatre parties :

  1. Les questions. Le questionnaire de l'agent : identité, moment opportun pour discuter, douleur, blessure, fièvre, médicaments, etc. Commencez par afficher une invite directement sur le nœud pendant l'itération, puis transférez-la à l'agent une fois le système stabilisé.
  2. Les réponses requises. Le outcome_schema. Définissez-le d'abord. Le modèle lit description de chaque champ ; écrivez-le donc comme une instruction. La version prête à l'emploi requiert identity_confirmed, pain_controlled, wound_concern et taking_medication.
  3. Informations relatives à cet appel. Entrée context : court texte lisible concernant le patient, et non un dossier complet.
  4. La première phrase. first_message.

Pour modifier un agent de modèle de base que vous distribuez en voice-clinical-followup.yaml, augmentez sa valeur version : au démarrage, une version inférieure ou égale est ignorée.

Choisissez comment cela commence​

CommencerComment
ManuellementApps → Voice Workflows → Place call
Par APIExécutez le flux de travail avec {"pipeline_id": "...", "inputs": {"phone": "...", ...}} (voir la référence de l'API).
Sur une minuterieUn nœud scheduler
Lors d'un événement FHIRUn nœud fhir-webhook
Aucun déclencheur « après décharge » prêt à l'emploi

Le flux de travail prédéfini démarre à partir de son formulaire de saisie. Un minuteur (un nœud scheduler, ajouté automatiquement par l'option Schedule du menu Exécuter) lance un flux de travail sans saisie, et une exécution sans saisie compose les numéros par défaut de démonstration du nœud de saisie. Aucun flux de travail fourni ne se déclenche lors de la sortie d'un patient ni n'associe le numéro de téléphone d'un patient issu d'un événement FHIR à l'appel. Si vous en créez un, testez-le soigneusement et assurez-vous qu'une personne soit impliquée dans son suivi.

Testez-le sur vous-même​

  1. Inscrivez votre propre numéro dans le formulaire, dans la langue appropriée.
  2. Passez l'appel et répondez. Vérifiez que le message d'accueil indique qu'il s'agit d'un appel automatisé et qu'il vous demande d'abord votre identité.
  3. Dites « J'ai une douleur à la poitrine » et vérifiez que l'appel est transféré vers un niveau supérieur et qu'une tâche urgente apparaît.
  4. Passez un autre appel et ne répondez pas. Vérifiez qu'une tâche à retry-call tâche apparaît.
  5. N’utilisez pas le Dry run pour éviter les erreurs de numérotation : dans le logiciel Test il est enregistré et fonctionne exactement comme Run (il suit le fonctionnement de la bascule Live). Testez le câblage avec votre propre numéro.

Règles de sécurité que l'assistant suit​

  • Elle se contente de recueillir et de transmettre les informations. Elle n'interprète pas les symptômes, ne donne pas de conseils et n'indique pas le degré d'urgence.
  • L'identité est vérifiée en premier. Aucune information médicale n'est divulguée tant que la personne n'a pas confirmé son identité. Une personne inconnue ne reçoit aucune information. Un message vocal indique uniquement le nom de la clinique et demande d'être rappelée.
  • Tout ce qui est incertain s'aggrave : réponses contradictoires, détresse, ou tout élément extérieur à la liste de questions.
  • Une personne examine la note préliminaire et traite la file d'attente des tâches.
  • Le système lit la transcription, et non l'audio ; par conséquent, les difficultés respiratoires, les troubles de l'élocution ou les pleurs peuvent passer inaperçus, et un simple « Je vais bien » peut masquer une détresse. Une intervention massive est la seule mesure d'atténuation.

Confidentialité : l’identifiant du patient n’est pas inclus dans l’invite envoyée au fournisseur de services vocaux. Les outils s’exécutent dans Tietai environnement sécurisé (isolation des locataires, protection des données de santé protégées et audit). Les enregistrements sont désactivés par défaut et expirent (30 jours, sauf indication contraire dans le déploiement). Les transcriptions sont conservées indéfiniment, sauf si une période de conservation est définie dans le déploiement ; ces deux paramètres relèvent de l’opérateur.

Ce qui n'est pas construit​

ÉcartConséquence
Pas de fenêtre d'appelIl est possible de passer un appel à toute heure, y compris la nuit.
Pas de rappel automatiqueretry-call tâche ne s'accumule et rien ne les traite. Quelqu'un doit gérer la file d'attente.
Aucun consentement ni vérification de non-appelVous devez vérifier le droit d'appeler chaque numéro
Aucun responsable sur les tâchesDéterminez qui surveille clinician-callback et retry-call
Aucun paramètre vocal par organisationLes chiffres et les paramètres du moteur sont déployés à l'échelle du système.
Aucun appel entrantLa plateforme passe des appels ; elle n'y répond pas.

Quand quelque chose tourne mal​

SymptômeCauseRéparer
voice call service is not configured on this deploymentLa téléphonie n'est pas activée.Demandez à votre opérateur de configurer l'opérateur et l'URL de base publique.
to (or phone) input is requiredLe flux de travail s'est exécuté sans aucune entrée.Utilisez la forme Call details ou Run with inputs
La course reste en attente après la fin de l'appelL'avis de fin d'appel de l'opérateur n'est pas arrivé ou sa signature ne correspondait pas.Ouvrez le fichier d'exécution (Monitor et lisez l'erreur enregistrée ; demandez à votre opérateur de vérifier l'URL publique.
engine ... processes in us and cannot carry a clinical callLe profil clinique est basé sur un moteur non européenVotre opérateur doit configurer le moteur européen
caller id ... belongs to another organizationLe chiffre from n'est pas le vôtre.Utilisez un numéro attribué à votre organisation
Une transcription absurdeFaux languageDéfinir le code de langue du patient
Une porte dysfonctionne avec field 'documentable' not found in inputsUne condition est connectée à un port non déclaréRaccordez-le au port field ou context déclaré.

Quelque chose n'est pas clair ? Envoyez vos commentaires sur la documentation par courriel.