How-to: Fonial Cloud-Telefonie mit tomedo
Mit dieser Konfiguration kann tomedo aus einer Patientenakte heraus einen Fonial-Click2Dial-Anruf starten. Eingehende, angenommene und beendete Gespräche werden vom Tischtelefon an tomedo gemeldet, sodass Anruf-Panel und Patientensuche reagieren können.
Getestet wurde die Konfiguration mit einem Yealink T48U. Bei anderen Telefonen können die Einstellungen anders heißen.
Voraussetzungen
Das IP-Telefon ist bereits als Fonial-Endgerät eingerichtet.
Fonial hat Click2Dial/API für das Kundenkonto freigeschaltet und eine persönliche API-GUID bereitgestellt.
Telefon und tomedo-Arbeitsplatz erreichen sich im Netzwerk.
Das tomedo-Anruf-Panel ist eingeblendet: Tagesliste → Panel → Anrufe.
Das Webinterface des Telefons ist mit einem Passwort geschützt - bei fonial autoprovisioning der yealink Geräte findet sich das Passwort in der cloud-pbx.
Die persönliche GUID bleibt geheim. Sie gehört weder in einen Forumsbeitrag noch in einen Screenshot.
1. Telefonanbindung in tomedo einrichten
Unter Einstellungen → Arbeitsplatz → Telefon bei Anbindung über die Option AppleScript + URL Muster wählen.
Das beigefügte AppleScript bei AppleScript zum Raustelefonieren einsetzen. Nur diese drei Werte durch die eigenen Daten ersetzen:
set fonialID to "FONIAL-KUNDENNUMMER"
set fonialGUID to "PERSOENLICHE-FONIAL-API-GUID"
set ipTarget to "ZIEL-DURCHWAHL-DES-TELEFONS"
ipTarget ist die interne Durchwahl des Fonial-IP-Telefons an diesem Arbeitsplatz.
Die Zeile
set tel to "xxx"
bleibt unverändert. tomedo ersetzt xxx beim Wählen durch die Zielrufnummer.
Im Bereich URL-Muster für externe Telefonie Apps aktivieren:
neue Anrufe: Port 8081, Muster /incoming/
angenommene Anrufe: Port 8081, Muster /connected/
beendete Anrufe: Port 8081, Muster /hangup/
zusätzlich: wenn angenommener Anruf dann immer vorigen Anruf beenden … (Starface-Kompatibilität)
Wie URL-Muster und Aktions-URLs zusammenspielen
Die URL-Muster in tomedo stehen in direkter Verbindung mit den Aktions-URLs des Telefons.
Der tomedo-Arbeitsplatz stellt auf Port 8081 einen lokalen HTTP-Empfänger bereit. Bei einem Anruf sendet das Yealink-Telefon – abhängig vom jeweiligen Ereignis – einen HTTP-Aufruf an diesen Arbeitsplatz.
Beispiel:
Aktions-URL im Yealink:
http://TOMEDO-RECHNER:8081/incoming/$calledNumber
Passendes URL-Muster in tomedo:
/incoming/
$calledNumber wird vom Telefon durch die übermittelte Rufnummer ersetzt. tomedo erkennt anhand des URL-Pfads, welches Ereignis gemeldet wird:
/incoming/ → neuer eingehender Anruf
/connected/ → Gespräch wurde angenommen
/hangup/ → Gespräch wurde beendet
Die Pfade müssen deshalb im Yealink und in tomedo exakt zusammenpassen. Das Telefon löst den HTTP-Aufruf aus; tomedo nimmt ihn entgegen und verarbeitet die angehängte Rufnummer.
Anschließend tomedo neu starten, da die URL-Muster laut Einstellungsdialog erst nach einem Neustart wirksam werden.
2. Aktions-URLs im Yealink-Telefon hinterlegen
Im Webinterface des Telefons den Bereich Aktions-URL öffnen und folgende Werte eintragen:
Eingehender Anruf:
http://TOMEDO-RECHNER:8081/incoming/$calledNumber
Hergestellt:
http://TOMEDO-RECHNER:8081/connected/$calledNumber
Beendet:
http://TOMEDO-RECHNER:8081/hangup/$calledNumber
TOMEDO-RECHNER durch den im Praxisnetz erreichbaren Hostnamen oder die lokale IP-Adresse des betreffenden Macs ersetzen.
Nicht localhost verwenden: Die URL wird vom Telefon aufgerufen und muss deshalb auf den tomedo-Rechner zeigen.
Danach die Einstellungen im Telefon speichern bzw. übernehmen.
3. Funktion testen
Ausgehend: In tomedo eine Telefonnummer anklicken. Zuerst klingelt das eigene Fonial-Telefon. Nach dem Abheben baut Fonial die Verbindung zum gewünschten Ziel auf.
Eingehend: Die Fonial-Rufnummer von extern anrufen. Der Anruf sollte im tomedo-Anruf-Panel erscheinen. Bei bekannter Rufnummer kann tomedo die passende Kartei öffnen.
Angenommen und aufgelegt wird am Telefon. Die Zustandswechsel werden über die Aktions-URLs an tomedo gemeldet.
Wenn es nicht funktioniert
Prüfen, ob das Anruf-Panel sichtbar ist.
Prüfen, ob tomedo nach der Änderung neu gestartet wurde.
Prüfen, ob das Telefon den tomedo-Rechner unter dem eingetragenen Hostnamen bzw. der IP-Adresse erreichen kann.
macOS-Firewall und Netzwerkfreigabe für Port 8081 prüfen.
Bei mehreren Arbeitsplätzen muss jedes Telefon auf den jeweils zugehörigen tomedo-Rechner zeigen.
Wenn ausgehende Anrufe scheitern: Fonial-Freischaltung, Kundennummer, GUID und Ziel-Durchwahl kontrollieren.
Sicherheitshinweis: Die persönliche Fonial-GUID ist ein Zugangsschlüssel. Sie sollte nur lokal im Skript gespeichert und niemals veröffentlicht werden.
-- Die Telefonnummer wird von tomedo übergeben.
-- Diese Zeile unverändert lassen:
set tel to "xxx"
-- Leerzeichen aus der übergebenen Telefonnummer entfernen
set telClean to do shell script "echo " & quoted form of tel & " | sed -e 's/ //g'"
-- Fonial-Konfigurationswerte: lokal anpassen und niemals veröffentlichen
set fonialID to "FONIAL-KUNDENNUMMER"
set fonialGUID to "PERSOENLICHE-FONIAL-API-GUID"
set ipTarget to "ZIEL-DURCHWAHL-DES-TELEFONS"
-- Click2Dial-Aufruf an Fonial senden
set shellCommand to "curl -s -o /dev/null 'https://kundenkonto.fonial.de/api/2.0/call/initiate/direct?id=" & fonialID & "&guid=" & fonialGUID & "&ip-target=" & ipTarget & "&number=" & telClean & "'"
do shell script shellCommand
Wenn Sie noch Fragen haben, schicken Sie mir bitte eine private Nachricht.
Stefan Enzensberger
Enzensberger IT Consulting
