Rezept: Telefonat zur Nachsorge nach der Entlassung
Ziel: Nachdem ein Patient nach Hause entlassen wurde, ruft ihn ein automatisierter Assistent an, bestätigt seine Identität, stellt einen festgelegten Fragenkatalog zum Genesungsverlauf (Schmerzen, Wunde, Fieber, Medikamente) und protokolliert die Antworten. Sollte der Patient oder der Assistent Bedenken äußern, wird ein Rückruf durch einen Arzt veranlasst. Meldet sich niemand, wird ein erneuter Anrufversuch gestartet.
Bevor Sie beginnen
| Du brauchst | Detail |
|---|---|
| Telephony set up by an operator | Die Sprachübertragung erfolgt über einen Netzbetreiber (Twilio ist der einzige implementierte Anbieter). Die Konfiguration erfolgt durch Ihren Tietai über die Bereitstellungseinstellungen, nicht in der Anwendung. Wenn die Sprachübertragung deaktiviert ist, können über die Seite „Sprach-Workflows“ keine Anrufe getätigt werden. |
| A number you may call from | Eine Anrufer-ID im E.164-Format (z. B. +34910000000), die Ihrer Organisation zugeordnet ist. |
| Eine in der EU ansässige Sprachmaschine für klinische Anrufe | Ein Anruf mit dem Profil clinical wird von einer Engine abgelehnt, die außerhalb der EU verarbeitet wird. |
| An organization-owned agent | Ein Agent mit Basisvorlage kann nicht ausgeführt werden. Kopieren Sie zuerst voice-clinical-followup in Ihre Organisation (Agent erstellen). |
| A FHIR server for the Tasks | In der vorgefertigten Definition beziehen die beiden Task-Knoten ihren Server und ihr Token aus den Platzhaltern {{FHIR_BASE_URL}} und {{FHIR_BEARER_TOKEN}}. Überprüfen Sie, ob diese in Ihrer Bereitstellung aufgelöst werden können, andernfalls wird kein Task erstellt. |
| Permissions | Apps → Voice Workflows wird nur mit der Berechtigung zur Sprachüberwachung angezeigt. Zum Bearbeiten des Workflows in Studio sind Workflow-Berechtigungen erforderlich. |
| The right to call this number | Die Plattform prüft nicht, ob die Einwilligung zum Anrufen vorliegt. Lediglich die Einwilligung zur Aufzeichnung wird durchgesetzt. Bitte bestätigen Sie Ihr Anrufrecht, bevor Sie anrufen. |
Starten Sie einen Anruf mit dem vorgefertigten Workflow.
Die Entwicklungsumgebung verfügt über zwei vorgefertigte Workflows: Post-Discharge Voice Follow-Up und Wearables Wellness Check-In (es handelt sich um gespeicherte Pipelines, die nicht automatisch zu jeder Organisation gehören; die untenstehende Liste zeigt nur die Pipelines Ihrer Organisation an, die einen voice-call Knoten enthalten).
- Öffnen Apps → Voice Workflows.
- Wählen Sie unter Workflows (
Pipelines of your organisation that place a call) die Post-Discharge Voice Follow-Up. Wenn die Liste leer ist, erscheint die Meldung: „Noch kein Workflow mit einem Sprachanruf-Knoten. Erstellen Sie einen in Studio, dann wird er hier angezeigt.“ - Füllen Sie Call details aus. Es gibt ein Feld pro Eingabe des Workflows, und Pflichtfelder tragen
*:
| Feld | Beispiel | Anmerkungen |
|---|---|---|
Patient name * | Test Patient A | Wird in der Begrüßung verwendet |
Patient id * | die FHIR-Patienten-ID | Verknüpft Folgeaufgaben mit dem Patienten. Es ist nicht in der an den Sprachdienstleister gesendeten Benachrichtigung enthalten. |
Phone * | +34600000000 | E.164, mit Ländercode |
| Language | es-ES | Steuert die Spracherkennung und die Stimmverarbeitung. Ein falscher Wert führt zu einem sinnlosen Transkript. |
| Discharge date | 2026-09-15 | Optionaler Kontext |
- Wählen Sie Place call. Die Schaltfläche ist deaktiviert, bis die Pflichtfelder ausgefüllt sind.
In der Workflow-Liste von Studio startet die Wiedergabetaste auf einer Workflow-Karte den Workflow ohne Eingaben und verwendet die integrierten Demo-Standardeinstellungen. Verwenden Sie auf dieser Seite immer die Form Call details oder in Studio die Run with inputs.
Folgen Sie dem Anruf
Die mittlere Karte trägt die Bezeichnung Call to <number> und zeigt den Status an: In der Warteschlange, Klingeln, In Bearbeitung, Abgeschlossen, An einen Arzt/eine Ärztin weitergeleitet, Keine Antwort, Besetzt, Abgelehnt, Fehlgeschlagen oder Abgebrochen. Auf dem Tab Transcript wird die Konversation als Sprechblasen für Assistent/in und Patient/in angezeigt. Tab Recent calls (rechts) listet die Anrufe Ihrer Organisation auf; ein Dreieck markiert einen Anruf, bei dem der/die Assistent/in nach einem Arzt/einer Ärztin gefragt hat.
Überprüfen Sie das Ergebnis
Öffnen Sie den Reiter Outcome Dort wird eine Warnung angezeigt, wenn der Assistent nach einem Arzt gefragt hat, sowie die Antworten Captured during the call und What the workflow did next:
| Was geschah während des Anrufs? | Was der Arbeitsablauf leistet |
|---|---|
| Der Patient sprach und bestätigte seine Identität | Ein Mitarbeiter erstellt anhand des Transkripts einen klinischen Vermerk, der als Draft clinical note mit dem Hinweis "Vom Workflow aus dem Transkript erstellt. Überprüfen Sie ihn, bevor er in die Akte gelangt." angezeigt wird. |
| Es wurde eine Eskalation angefordert (Brustschmerzen, Atembeschwerden, eine blutende oder sich öffnende Wunde, eine Medikamentenfrage oder die Frage „Ist das normal?“, Notlage, eine Bitte um eine Person, widersprüchliche Antworten). | FHIR Task: Dringender Notfall, Code clinician-callback, Verbindung zum Patienten. Der Assistent leitet den Anruf außerdem an Ihre Klinikteamnummer weiter. |
| Niemand hat geantwortet (keine Antwort, besetzt, abgewiesen, Voicemail) | FHIR Task: Prioritätsroutine, Code retry-call |
| Jeder Anruf | Ein Prüfprotokoll (clinical_followup_call) mit dem Ergebnis |
Lesen Sie die Aufgaben von Ihrem FHIR-Server mit Task?patient=<patient id>.
Bauen oder passen Sie Ihr eigenes an
Folgen Sie der allgemeinen Vorgehensweise unter „Beliebigen Workflow erstellen“. Die sprachspezifischen Abschnitte sind unten aufgeführt.
Die Knoten
| Knoten-ID | Typ | Zweck |
|---|---|---|
pipeline-input | input | Das Formular: phone, language, patient_id, patient_name, discharge_date. Erforderlich: Telefonnummer, Name des Patienten, Patienten-ID |
call-patient | voice-call | Tätigt den Anruf und wartet, bis er beendet ist. |
should-document dann draft-note | condition, agent-run | Wenn der Anruf documentable ist, verfassen Sie eine Notiz. |
needs-human, build-task, create-task | condition, transform, fhir-crud | Wenn escalation_requested, erstelle die dringende Aufgabe |
unreached, build-retry, create-retry | condition, transform, fhir-crud | Wenn answered falsch ist, erstelle die Wiederholungsaufgabe. |
audit-call | audit | Das Gespräch sollte immer aufgezeichnet werden. |
followup-result | output | Senden Sie das Prüfergebnis und den Entwurf des Vermerks zurück. |
Verbinden Sie jede Bedingung mit den deklarierten Ports (field, context) des Knotens. Lassen Sie den Überwachungsanschluss ungegated, damit jeder Anruf protokolliert wird.
Einstellungen des Knotens voice-call
| Einstellung (Bezeichnung) | Beispiel | Bedeutung |
|---|---|---|
from (Caller ID) | {{CLINIC_CALLER_ID}} | Anrufer-ID. Sie muss zu Ihrer Organisation gehören. |
profile (Risk Profile) | clinical | Wendet die klinischen Sicherheitsvorkehrungen an (eine EU-Engine ist erforderlich) |
agent_id (Agent) | voice-clinical-followup | Der vom Unternehmen beauftragte Agent, der den Anruf durchführt |
language (Language) | es-ES | Ein BCP-47-Sprachcode |
timezone (Time Zone) | Europe/Madrid | IANA-Zone des Angerufenen. Legt die {{GREETING}} („Buenos días“, „Buenas tardes“, „Buenas noches“) in der Begrüßung fest. Ist das Feld leer, wird die Standardeinstellung verwendet, ansonsten die des gewählten Landes, falls dieses nur eine Zeitzone hat. Kann die Uhrzeit nicht ermittelt werden, wird keine Uhrzeit angegeben. Spanien und Portugal können nicht über die Vorwahl ermittelt werden (Kanarische Inseln, Azoren), daher muss diese entsprechend eingestellt werden. |
transfer_to (Transfer Destination) | {{CLINICAL_TEAM_NUMBER}} | Wohin ein eskalierter Anruf weitergeleitet wird |
max_duration (Max Duration (seconds)) | 600 | Sekunden |
machine_detection (Detect Answering Machine) | true | Standardwert false. Meldet, wenn der Anbieter davon ausgeht, dass die Voicemail beantwortet wurde, sodass dies als „Keine Antwort“ protokolliert wird. |
wait_for_completion (Wait For Completion) | true | Halten Sie den Workflow an, bis das Gespräch beendet ist. |
record (Record Call) | false | Die Aufnahme ist standardmäßig deaktiviert. Zum Aktivieren ist eine consent_script erforderlich. |
first_message (Opening Line) | "Hello, this is the automated assistant of {{CLINIC_NAME}}, on behalf of your care team..." | Der erste Satz. Die vorgefertigte Formulierung besagt, dass der Anruf automatisiert ist, und die Anweisungen des Agenten erfordern diese Angabe, daher sollte sie in jeder von Ihnen verfassten Zeile enthalten sein. |
outcome_schema (Outcome Schema) | ein JSON-Schema | Die Antworten, die Sie benötigen |
Werte wie {{CLINIC_CALLER_ID}}, {{CLINICAL_TEAM_NUMBER}} und {{CLINIC_NAME}} werden von Ihrer Bereitstellung automatisch auf {{...}} gesetzt. Alternativ können Sie den tatsächlichen Wert in den Knoten eingeben.
Schreibe das Drehbuch
Ein Anruf besteht aus vier Teilen:
- Die Fragen. Der Fragenkatalog des Agenten: Identität, passender Zeitpunkt für ein Gespräch, Schmerzen, Wunde, Fieber, Medikamente, Sonstiges. Beginnen Sie mit einer Inline-Abfrage auf dem Knoten während der Iteration und übertragen Sie diese auf den Agenten, sobald dieser stabil ist.
- Die benötigten Antworten. Die
outcome_schema. Definieren Sie sie zuerst. Jededescriptionin jedem Feld wird vom Modell gelesen, schreiben Sie sie also als Anweisung. Die fertige Version benötigtidentity_confirmed,pain_controlled,wound_concernundtaking_medication. - Fakten zu diesem Anruf. Eingabe
context: Kurzer, lesbarer Text über den Patienten, keine vollständige Datenübermittlung. - Der erste Satz.
first_message.
Um einen mitgelieferten Basis-Template-Agenten in voice-clinical-followup.yaml zu ändern, erhöhen Sie dessen Wert um version: Beim Systemstart wird eine niedrigere oder gleiche Version übersprungen.
Wähle, wie es beginnt
| Start | Wie |
|---|---|
| Von Hand | Apps → Voice Workflows → Place call |
| Per API | Führen Sie den Workflow mit {"pipeline_id": "...", "inputs": {"phone": "...", ...}} aus (siehe API-Referenz). |
| Auf Zeit | Ein scheduler Knoten |
| Bei einem FHIR-Ereignis | Ein fhir-webhook Knoten |
Der vorgefertigte Workflow beginnt mit seinem Eingabeformular. Ein Timer (ein scheduler Knoten, der durch Auswahl Schedule im Menü „Ausführen“ automatisch hinzugefügt wird) führt einen Workflow ohne Eingaben aus. Bei einem Lauf ohne Eingaben werden die Standardeinstellungen des Eingabeknotens verwendet. Kein mitgelieferter Workflow wird bei der Entlassung eines Patienten ausgelöst oder ordnet die Telefonnummer eines Patienten aus einem FHIR-Ereignis dem Anruf zu. Wenn Sie einen Workflow erstellen, testen Sie ihn sorgfältig und halten Sie eine Testperson auf dem Laufenden.
Teste es an dir selbst
- Tragen Sie Ihre eigene Nummer in das Formular ein, und zwar in der richtigen Sprache.
- Tätigen Sie den Anruf und nehmen Sie ihn entgegen. Vergewissern Sie sich, dass die Begrüßung darauf hinweist, dass es sich um einen automatisierten Anruf handelt und dass Sie zunächst nach Ihrer Identität gefragt werden.
- Sagen Sie „Ich habe Brustschmerzen“ und prüfen Sie, ob der Anruf eskaliert wird und eine dringende Aufgabe erscheint.
- Tätigen Sie einen weiteren Anruf, ohne ihn anzunehmen. Prüfen Sie, ob eine Aufgabe mit
retry-callangezeigt wird. - Verlassen Sie sich nicht darauf, dass Dry run das Wählen verhindert: Im Builder wird sie genauso gespeichert und ausgeführt wie Run (sie folgt der Live / Test -Umschaltung). Testen Sie die Verkabelung mit Ihrer eigenen Nummer.
Sicherheitsregeln, die der Assistent befolgt
- Es sammelt lediglich Informationen und leitet diese weiter. Es interpretiert keine Symptome, gibt keine Ratschläge und äußert keine Dringlichkeitsangaben.
- Zuerst die Identität. Es werden keine medizinischen Informationen mitgeteilt, bis die Person ihre Identität bestätigt hat. Fremde erhalten keine Auskunft. Auf dem Anrufbeantworter wird lediglich der Name der Klinik genannt und um einen Rückruf gebeten.
- Alles Unklare eskaliert: widersprüchliche Antworten, Verzweiflung oder alles, was nicht auf der Fragenliste steht.
- Eine Person prüft den Entwurf der Notiz und bearbeitet die Aufgabenliste.
- Es liest das Transkript, nicht die Audioaufnahme, daher können Atemnot, undeutliche Aussprache oder Weinen übersehen werden, und ein „Mir geht es gut“ kann die Verzweiflung verschleiern. Eine Eskalation der Situation ist die einzige Möglichkeit, dies zu mildern.
Datenschutz: Die Patienten-ID wird nicht in die an den Sprachdienstleister gesendete Ansage aufgenommen. Die Tools laufen innerhalb von Tietai mit Mandantenisolierung, PHI-Schutz und Auditierung. Aufzeichnungen sind standardmäßig deaktiviert und verfallen nach 30 Tagen (sofern in der Bereitstellung nicht anders festgelegt). Transkripte werden unbegrenzt aufbewahrt, es sei denn, die Bereitstellung legt eine Aufbewahrungsfrist fest; beide Einstellungen obliegen dem Bediener.
Was nicht gebaut wird
| Lücke | Folge |
|---|---|
| Kein Anruffenster | Ein Anruf kann zu jeder Tages- und Nachtzeit getätigt werden. |
| Keine automatische Wahlwiederholung | Es werden retry-call Aufgaben angesammelt, die nicht abgearbeitet werden. Jemand muss die Warteschlange bearbeiten. |
| Keine Einwilligung oder Überprüfung der Anrufsperre | Sie müssen das Recht zum Anrufen jeder einzelnen Nummer überprüfen. |
| Kein Verantwortlicher für die Aufgaben | Legen Sie fest, wer clinician-callback und retry-call überwacht. |
| Keine organisationsspezifischen Spracheinstellungen | Zahlen und Motoreinstellungen gelten für den gesamten Einsatz. |
| Keine eingehenden Anrufe | Die Plattform tätigt Anrufe; sie nimmt sie aber nicht entgegen. |
Wenn etwas schiefgeht
| Symptom | Ursache | Fix |
|---|---|---|
voice call service is not configured on this deployment | Telefonie ist nicht aktiviert | Bitten Sie Ihren Mobilfunkanbieter, die Carrier- und die öffentliche Basis-URL zu konfigurieren. |
to (or phone) input is required | Der Workflow wurde ohne Eingaben ausgeführt. | Verwenden Sie die Form Call details oder Run with inputs |
| Der Lauf wartet nach dem Ende des Anrufs. | Die Benachrichtigung des Anbieters über das Gesprächsende ist nicht angekommen oder die Unterschrift stimmte nicht überein. | Öffnen Sie den Lauf in Monitor und lesen Sie den aufgezeichneten Fehler; bitten Sie Ihren Operator, die öffentliche URL zu überprüfen. |
engine ... processes in us and cannot carry a clinical call | Das klinische Profil basiert auf einem Nicht-EU-System. | Ihr Betreiber muss die EU-Engine konfigurieren. |
caller id ... belongs to another organization | Die from gehört Ihnen nicht. | Verwenden Sie eine Ihrer Organisation zugewiesene Nummer. |
| Ein sinnloses Protokoll | Falsch language | Stellen Sie den Sprachcode des Patienten ein. |
Ein Gatter schlägt mit field 'documentable' not found in inputs fehl. | Ein Zustand ist an einen nicht deklarierten Port angeschlossen. | Schließen Sie es an den deklarierten Port field oder context. |
Etwas unklar? Senden Sie Feedback zur Dokumentation per E-Mail..