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.
Avant de commencer
| Vous avez besoin | Détail |
|---|---|
| Telephony set up by an operator | La 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 from | Un identifiant d'appelant au format E.164 (par exemple +34910000000) attribué à votre organisation. |
| Un moteur vocal basé dans l'UE pour les appels cliniques | Un appel avec le profil clinical est refusé sur un moteur qui traite les requêtes en dehors de l'UE. |
| An organization-owned agent | Un 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 Tasks | Dans 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. |
| Permissions | Le 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 number | La 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).
- Ouvrir Apps → Voice Workflows.
- 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. » - Remplissez les champs vides Call details). Il y a un champ par entrée du flux de travail, et les champs obligatoires sont égaux
*.
| Champ | Exemple | Notes |
|---|---|---|
Patient name * | Test Patient A | Utilisé dans la salutation |
Patient id * | l'identifiant patient FHIR | Associe les tâches de suivi au patient. Cette information n'est pas incluse dans le message envoyé au fournisseur de services vocaux. |
Phone * | +34600000000 | E.164, avec code pays |
| Language | es-ES | Gère la reconnaissance vocale et la voix. Une valeur incorrecte produit une transcription incohérente. |
| Discharge date | 2026-09-15 | Contexte optionnel |
- Choisissez Place call. Le bouton est désactivé tant que les champs obligatoires ne sont pas remplis.
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 appel | Un 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œud | Taper | But |
|---|---|---|
pipeline-input | input | Formulaire : phone, language, patient_id, patient_name, discharge_date. Champs obligatoires : numéro de téléphone, nom du patient, identifiant du patient |
call-patient | voice-call | Il passe l'appel et attend qu'il se termine. |
should-document puis draft-note | condition, agent-run | Lorsque l'appel est documentable, rédigez une note. |
needs-human, build-task, create-task | condition, transform, fhir-crud | Lorsque escalation_requested, créer la tâche urgente |
unreached, build-retry, create-retry | condition, transform, fhir-crud | Lorsque answered est faux, créer la tâche de nouvelle tentative |
audit-call | audit | Enregistrez toujours l'appel. |
followup-result | output | Veuillez 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) | Exemple | Signification |
|---|---|---|
from (Caller ID) | {{CLINIC_CALLER_ID}} | Identification de l'appelant. Elle doit appartenir à votre organisation. |
profile (Risk Profile) | clinical | Applique les garanties cliniques (un moteur UE est requis) |
agent_id (Agent) | voice-clinical-followup | L'agent appartenant à l'organisation qui effectue l'appel |
language (Language) | es-ES | Un code de langue BCP-47 |
timezone (Time Zone) | Europe/Madrid | Zone 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)) | 600 | Secondes |
machine_detection (Detect Answering Machine) | true | Valeur 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) | true | Maintenez le flux de travail en pause jusqu'à la fin de l'appel. |
record (Record Call) | false | L'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 JSON | Les 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 :
- 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é.
- Les réponses requises. Le
outcome_schema. Définissez-le d'abord. Le modèle litdescriptionde chaque champ ; écrivez-le donc comme une instruction. La version prête à l'emploi requiertidentity_confirmed,pain_controlled,wound_concernettaking_medication. - Informations relatives à cet appel. Entrée
context: court texte lisible concernant le patient, et non un dossier complet. - 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
| Commencer | Comment |
|---|---|
| Manuellement | Apps → Voice Workflows → Place call |
| Par API | Exécutez le flux de travail avec {"pipeline_id": "...", "inputs": {"phone": "...", ...}} (voir la référence de l'API). |
| Sur une minuterie | Un nœud scheduler |
| Lors d'un événement FHIR | Un nœud fhir-webhook |
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
- Inscrivez votre propre numéro dans le formulaire, dans la langue appropriée.
- 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é.
- 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.
- Passez un autre appel et ne répondez pas. Vérifiez qu'une tâche à
retry-calltâche apparaît. - 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
| Écart | Conséquence |
|---|---|
| Pas de fenêtre d'appel | Il est possible de passer un appel à toute heure, y compris la nuit. |
| Pas de rappel automatique | retry-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-appel | Vous devez vérifier le droit d'appeler chaque numéro |
| Aucun responsable sur les tâches | Déterminez qui surveille clinician-callback et retry-call |
| Aucun paramètre vocal par organisation | Les chiffres et les paramètres du moteur sont déployés à l'échelle du système. |
| Aucun appel entrant | La plateforme passe des appels ; elle n'y répond pas. |
Quand quelque chose tourne mal
| Symptôme | Cause | Réparer |
|---|---|---|
voice call service is not configured on this deployment | La 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 required | Le 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'appel | L'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 call | Le profil clinique est basé sur un moteur non européen | Votre opérateur doit configurer le moteur européen |
caller id ... belongs to another organization | Le chiffre from n'est pas le vôtre. | Utilisez un numéro attribué à votre organisation |
| Une transcription absurde | Faux language | Définir le code de langue du patient |
Une porte dysfonctionne avec field 'documentable' not found in inputs | Une 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.