tomedo-Integration – Patientenaufruf per Aktionskette

tomedo® (zollsoft) kann über Aktionsketten eigene Skripte ausführen. Wir nutzen das, um bei jedem Aufruf einen kurzen Web-Befehl an Wartezimmer-Aufruf zu senden. Danach genügt in tomedo ein Klick – oder das Verschieben eines To-dos – und der Patient wird im Wartezimmer angesagt.

Voraussetzungen: tomedo auf dem Mac, Admin-Rechte in tomedo, ein Wartezimmer in Wartezimmer-Aufruf (siehe Erste Schritte) und Internetzugang am tomedo-Arbeitsplatz. Dauer: ca. 15 Minuten.

So funktioniert die Anbindung#

tomedo (Arbeitsplatz)  ──Aktionskette──▶  AppleScript  ──curl (HTTPS)──▶  Wartezimmer-Aufruf  ──▶  Fernseher im Wartezimmer

tomedo ersetzt in der Aktionskette Platzhalter wie $[patientNN]$ durch die Daten des aktuellen Patienten. Das AppleScript schickt Name und Zimmer an unsere API, die Anzeige und Ansage erfolgen sofort.

Schritt 1: API-Token und Wartezimmer-ID holen#

1. In Wartezimmer-Aufruf anmelden → oben rechts Ihr Name → API Tokens → Token „tomedo“ erstellen und kopieren.
2. Wartezimmer → Wartezimmer öffnen → Kasten Aufruf aus der Praxissoftware (API) → Wartezimmer-ID kopieren.

Die API ist in den Tarifen mit API-Zugriff enthalten. Ist sie in Ihrem Tarif nicht freigeschaltet, antwortet der Server mit 403.

Halten Sie beides bereit.

Schritt 2: Skript einmal am Mac testen#

Öffnen Sie auf dem tomedo-Mac das Terminal (Programme → Dienstprogramme) und senden Sie einen Testaufruf (Token und ID einsetzen):

curl -s -X POST 'https://wartezimmer-aufruf.de/api/waitingrooms/WARTEZIMMER-ID/invocations' \
  -H 'Authorization: Bearer IHR-API-TOKEN' -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Wartenummer 42","room":"3"}'

Erscheint der Aufruf auf dem Fernseher, stimmen Netzwerk, Token und ID. Falls nicht: siehe Problemlösung.

Schritt 3: Aktionskette in tomedo anlegen#

1. tomedo → Admin → Aktionsketten (Verwaltung der Aktionsketten).
2. Neue Aktionskette anlegen, z. B. Name „Patientenaufruf Wartezimmer“, Kürzel aufruf.
3. Eine Aktion vom Typ AppleScript ausführen hinzufügen.
4. Folgendes Skript einfügen und Token, Wartezimmer-ID und ggf. das Zimmer anpassen:

-- Wartezimmer-Aufruf: Patient aus tomedo aufrufen
set apiToken to "IHR-API-TOKEN"
set wartezimmerID to "WARTEZIMMER-ID"

-- Was angesagt wird: Anrede + Nachname (z. B. "Frau Müller")
set patientName to "$[patient_bez]$ $[patientNN]$"

-- Zimmer: aus dem aktuellen To-do übernehmen, sonst Standardwert
set zimmer to "$[aktuellerTodoRaum]$"
if zimmer is "" then set zimmer to "1"

-- JSON-Body zusammenbauen (Anführungszeichen im Namen werden maskiert)
set jsonName to my jsonEscape(patientName)
set jsonRoom to my jsonEscape(zimmer)
set jsonBody to "{\"name\":\"" & jsonName & "\",\"room\":\"" & jsonRoom & "\"}"

do shell script "curl -s -m 5 -X POST 'https://wartezimmer-aufruf.de/api/waitingrooms/" & wartezimmerID & "/invocations' " & ¬
    "-H 'Authorization: Bearer " & apiToken & "' -H 'Accept: application/json' " & ¬
    "-H 'Content-Type: application/json' -d " & quoted form of jsonBody

on jsonEscape(t)
    set t to my replaceText(t, "\\", "\\\\")
    set t to my replaceText(t, "\"", "\\\"")
    return t
end jsonEscape

on replaceText(t, s, r)
    set AppleScript's text item delimiters to s
    set parts to text items of t
    set AppleScript's text item delimiters to r
    set t to parts as text
    set AppleScript's text item delimiters to ""
    return t
end replaceText

5. Speichern.

Platzhalter, die tomedo ersetzt (Auswahl):

Platzhalter	Inhalt
$[patient_bez]$	Anrede („Herr“ / „Frau“)
$[patientVN]$	Vorname
$[patientNN]$	Nachname
$[aktuellerTodoRaum]$	Raum des aktuell gesetzten To-dos (sofern in tomedo Räume gepflegt sind)

Die vollständige Liste finden Sie in tomedo über den Platzhalter-Editor bzw. im tomedo-Handbuch.

Varianten für das Zimmer#

• Ein Sprechzimmer = eine Aktionskette: Legen Sie pro Zimmer eine Aktionskette an („Aufruf Zimmer 1“, „Aufruf Zimmer 2“ …) und setzen Sie set zimmer to "1" fest. Einfach und robust, wenn To-do-Räume nicht gepflegt werden.
• Zimmer aus dem Rechnernamen: Wenn jeder Behandlungsraum einen eigenen Mac hat, kann das Skript das Zimmer aus dem Rechnernamen ableiten:

set rechner to do shell script "hostname -s"
if rechner is "mac-zimmer1" then
    set zimmer to "1"
else if rechner is "mac-zimmer2" then
    set zimmer to "2"
else
    set zimmer to "1"
end if

Variante: Wartenummer statt Name#

Wenn Sie in tomedo Wartenummern vergeben (z. B. über das Selbstanmeldeterminal oder ein eigenes Feld), tragen Sie den entsprechenden Platzhalter in patientName ein. Reine Zahlen werden automatisch als „Wartenummer …“ angesagt. Ohne Wartenummern empfehlen wir aus Datenschutzgründen Anrede + Nachname statt des vollen Namens.

Schritt 4: Auslöser festlegen#

Es gibt zwei bewährte Wege, die Aktionskette zu starten:

A) Knopf in der Kartei / Tagesliste (einfachster Weg)#

Legen Sie die Aktionskette auf einen Symbolleisten-Knopf in der Kartei oder der Tagesliste (Rechtsklick auf die Symbolleiste → anpassen → Aktionskette hinzufügen). Ein Klick bei geöffnetem Patienten ruft ihn auf. Alternativ tippen Sie das Kürzel aufruf in die Kommandozeile der Kartei.

B) Automatisch beim Setzen eines To-dos auf „aktuell“#

So läuft der Aufruf ganz ohne Extra-Klick mit Ihrem bestehenden Ablauf:

1. Admin → Auslöser Aktionsketten → mit + einen neuen Auslöser hinzufügen.
2. Objekt: das To-do, mit dem Sie Patienten ins Zimmer holen (z. B. „Arzt“ oder „Sprechzimmer 1“).
3. Aktion: „auf aktuell“ (das To-do wird in der Tagesliste aktiv gesetzt bzw. auf „aktuelles To-do“ gezogen).
4. Auszulösende Aktionskette: „Patientenaufruf Wartezimmer“.
5. Falls tomedo danach fragt: für die gewünschten Nutzer-/Arbeitsplatz-Kombinationen aktivieren.

Hinweis aus der tomedo-Praxis: Der Auslöser „To-do auf aktuell“ wird nur an dem Arbeitsplatz ausgeführt, an dem das To-do verschoben wurde („Aktion lokal“). Die Aktionskette muss also an jedem Arbeitsplatz erlaubt sein, von dem aus aufgerufen wird.

Schritt 5: Testen#

1. Patienten in der Kartei öffnen und den Knopf drücken bzw. das To-do aktiv setzen.
2. Beim ersten Ausführen fragt macOS oder tomedo eventuell einmalig, ob das Skript ausgeführt werden darf – bestätigen und in den tomedo-Einstellungen auf „immer erlauben“ stellen.
3. Auf dem Fernseher erscheint der Aufruf, die Ansage läuft.

Häufige Fragen#

Nichts passiert, keine Fehlermeldung. Testen Sie das curl-Kommando aus Schritt 2 im Terminal desselben Macs. Funktioniert es dort, prüfen Sie in tomedo die Anführungszeichen im Skript (gerade Anführungszeichen " und ', keine typografischen „“).

Fehler 401 / 403. Token falsch oder der tomedo-Nutzer, dessen Token verwendet wird, ist nicht Mitglied des Teams, zu dem das Wartezimmer gehört.

Der Name wird falsch ausgesprochen. Sie können im Skript den Text frei gestalten, z. B. nur $[patientNN]$ oder eine Wartenummer. Die Anzeige auf dem Bildschirm zeigt immer genau den gesendeten Text.

Mehrere Wartezimmer (z. B. EG und OG). Legen Sie pro Wartezimmer eine Aktionskette mit der jeweiligen Wartezimmer-ID an, oder wählen Sie die ID im Skript anhand des Rechnernamens (siehe oben).

Wir nutzen bereits die tomedo-Sprachausgabe per say. Das AppleScript kann beides – behalten Sie Ihre say-Zeile für den Flur und ergänzen Sie den curl-Aufruf für das Wartezimmer.

Wenn Sie beim Einrichten Unterstützung wünschen, schreiben Sie uns über Kontakt – gern per kurzer Bildschirmfreigabe.