Zum Hauptinhalt springen

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.

Der Arbeitsablauf: Ein Eingabefeld gibt Telefonnummer, Sprache und Patientendaten an; der Knoten „Patient anrufen“ stellt den Anruf her; anschließend wird eine Notiz erstellt, ein dringender Rückruf durch einen Arzt veranlasst oder ein Wiederholungsversuch gestartet; jeder Anruf wird protokolliert.

Bevor Sie beginnen​

Du brauchstDetail
Telephony set up by an operatorDie 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 fromEine Anrufer-ID im E.164-Format (z. B. +34910000000), die Ihrer Organisation zugeordnet ist.
Eine in der EU ansässige Sprachmaschine für klinische AnrufeEin Anruf mit dem Profil clinical wird von einer Engine abgelehnt, die außerhalb der EU verarbeitet wird.
An organization-owned agentEin Agent mit Basisvorlage kann nicht ausgeführt werden. Kopieren Sie zuerst voice-clinical-followup in Ihre Organisation (Agent erstellen).
A FHIR server for the TasksIn 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.
PermissionsApps → 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 numberDie 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).

  1. Öffnen Apps → Voice Workflows.
  2. 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.“
  3. Füllen Sie Call details aus. Es gibt ein Feld pro Eingabe des Workflows, und Pflichtfelder tragen *:
FeldBeispielAnmerkungen
Patient name *Test Patient AWird in der Begrüßung verwendet
Patient id *die FHIR-Patienten-IDVerknüpft Folgeaufgaben mit dem Patienten. Es ist nicht in der an den Sprachdienstleister gesendeten Benachrichtigung enthalten.
Phone *+34600000000E.164, mit Ländercode
Languagees-ESSteuert die Spracherkennung und die Stimmverarbeitung. Ein falscher Wert führt zu einem sinnlosen Transkript.
Discharge date2026-09-15Optionaler Kontext
  1. Wählen Sie Place call. Die Schaltfläche ist deaktiviert, bis die Pflichtfelder ausgefüllt sind.
Verwenden Sie nicht die Wiedergabetaste auf einer Studio-Workflowkarte.

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ätEin 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 AnrufEin 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-IDTypZweck
pipeline-inputinputDas Formular: phone, language, patient_id, patient_name, discharge_date. Erforderlich: Telefonnummer, Name des Patienten, Patienten-ID
call-patientvoice-callTätigt den Anruf und wartet, bis er beendet ist.
should-document dann draft-notecondition, agent-runWenn der Anruf documentable ist, verfassen Sie eine Notiz.
needs-human, build-task, create-taskcondition, transform, fhir-crudWenn escalation_requested, erstelle die dringende Aufgabe
unreached, build-retry, create-retrycondition, transform, fhir-crudWenn answered falsch ist, erstelle die Wiederholungsaufgabe.
audit-callauditDas Gespräch sollte immer aufgezeichnet werden.
followup-resultoutputSenden 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)BeispielBedeutung
from (Caller ID){{CLINIC_CALLER_ID}}Anrufer-ID. Sie muss zu Ihrer Organisation gehören.
profile (Risk Profile)clinicalWendet die klinischen Sicherheitsvorkehrungen an (eine EU-Engine ist erforderlich)
agent_id (Agent)voice-clinical-followupDer vom Unternehmen beauftragte Agent, der den Anruf durchführt
language (Language)es-ESEin BCP-47-Sprachcode
timezone (Time Zone)Europe/MadridIANA-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))600Sekunden
machine_detection (Detect Answering Machine)trueStandardwert 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)trueHalten Sie den Workflow an, bis das Gespräch beendet ist.
record (Record Call)falseDie 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-SchemaDie 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:

  1. 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.
  2. Die benötigten Antworten. Die outcome_schema. Definieren Sie sie zuerst. Jede description in jedem Feld wird vom Modell gelesen, schreiben Sie sie also als Anweisung. Die fertige Version benötigt identity_confirmed, pain_controlled, wound_concern und taking_medication.
  3. Fakten zu diesem Anruf. Eingabe context: Kurzer, lesbarer Text über den Patienten, keine vollständige Datenübermittlung.
  4. 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​

StartWie
Von HandApps → Voice Workflows → Place call
Per APIFühren Sie den Workflow mit {"pipeline_id": "...", "inputs": {"phone": "...", ...}} aus (siehe API-Referenz).
Auf ZeitEin scheduler Knoten
Bei einem FHIR-EreignisEin fhir-webhook Knoten
Kein vorgefertigter Auslöser für „nach dem Entladen“.

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​

  1. Tragen Sie Ihre eigene Nummer in das Formular ein, und zwar in der richtigen Sprache.
  2. 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.
  3. Sagen Sie „Ich habe Brustschmerzen“ und prüfen Sie, ob der Anruf eskaliert wird und eine dringende Aufgabe erscheint.
  4. Tätigen Sie einen weiteren Anruf, ohne ihn anzunehmen. Prüfen Sie, ob eine Aufgabe mit retry-call angezeigt wird.
  5. 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ückeFolge
Kein AnruffensterEin Anruf kann zu jeder Tages- und Nachtzeit getätigt werden.
Keine automatische WahlwiederholungEs werden retry-call Aufgaben angesammelt, die nicht abgearbeitet werden. Jemand muss die Warteschlange bearbeiten.
Keine Einwilligung oder Überprüfung der AnrufsperreSie müssen das Recht zum Anrufen jeder einzelnen Nummer überprüfen.
Kein Verantwortlicher für die AufgabenLegen Sie fest, wer clinician-callback und retry-call überwacht.
Keine organisationsspezifischen SpracheinstellungenZahlen und Motoreinstellungen gelten für den gesamten Einsatz.
Keine eingehenden AnrufeDie Plattform tätigt Anrufe; sie nimmt sie aber nicht entgegen.

Wenn etwas schiefgeht​

SymptomUrsacheFix
voice call service is not configured on this deploymentTelefonie ist nicht aktiviertBitten Sie Ihren Mobilfunkanbieter, die Carrier- und die öffentliche Basis-URL zu konfigurieren.
to (or phone) input is requiredDer 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 callDas klinische Profil basiert auf einem Nicht-EU-System.Ihr Betreiber muss die EU-Engine konfigurieren.
caller id ... belongs to another organizationDie from gehört Ihnen nicht.Verwenden Sie eine Ihrer Organisation zugewiesene Nummer.
Ein sinnloses ProtokollFalsch languageStellen 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..