Tipp 019 Alle Adminrechte nötig

onOffice Tipps und Tricks – 019

Das Mac/Windows-Softphone Zoiper lässt sich mit dem onOffice-Telefonmodul verbinden.

Vorweg: Ich leiste dazu keinen Support und übernehme keine Garantie. Wer es nutzt, tut dies auf eigenes Risiko. Nichts für Computer-Laien.

Erfolgreich getestet z. B. mit Placetel und einem MacBook. Mit der kostenlosen Version von Zoiper kannst du erstmal prüfen, ob dein eigener Telefonprovider grundsätzlich unterstützt wird – für die eigentliche Anbindung ans Telefonmodul brauchst du dann aber die Pro-Version.

Cloud-PBX der Telekom habe ich damit bisher nicht zum Laufen gebracht.

Was noch nicht geht: die Dauer des Telefonats wird nicht erfasst – eventuell liefert onOffice das irgendwann nach.

onOffice-seitig muss beim Benutzer unter „Telefon" die Telefonie als MAC konfiguriert werden, damit Safari die Telefonie an Zoiper übergeben kann.

Einrichtung in Zoiper Pro

In den Zoiper-Einstellungen findest du unter Automation den Punkt Event rules. Dort trägst du die folgenden 7 Regeln jeweils einzeln über Add rule ein.

Zoiper5 Einstellungen: Automation, Event rules, Add rule

Jede Regel öffnet einen Dialog, in dem du festlegst, bei welcher Statusänderung und Anrufrichtung welche Aktion ausgelöst wird. Die meisten Regeln nutzen als Aktion REST API:

Beispiel REST API Regel mit nummerierten Feldern

Eine Regel (Answered / Incoming) nutzt stattdessen Open URL statt REST API:

Beispiel Open URL Regel

Vorher musst du in jeder der URLs unten diese beiden Platzhalter ersetzen:

IHRMANDANTENNAMEODERSCHLÜSSEL – das 1. Feld im Login-Screen bzw. der neue Hash-Wert dazu
DURCHWAHLIHRESTELEFONS – meist eine zwei- bis dreistellige Zahl

Der optionale Teil &systemid=KENNUNGDERANLAGE wird nur bei größeren Systemen mit mehreren Telefonanlagen gebraucht – dort dann durch eine eindeutige Kennung je Anlage ersetzen, da z. B. die Durchwahl „10" sonst an mehr als einem Standort/einer Anlage vorkommen könnte.

Status	Richtung	Aktion	URL
Answered	Incoming	REST API	`https://smart.onoffice.de/smart/setCallInfos.php?STATE=CONN&CALLID={call_id}&TIMDURATION=&OUTBOUND=0&phoneNr={number}&kunde=IHRMANDANTENNAMEODERSCHLÜSSEL&LINENR=DURCHWAHLIHRESTELEFONS&systemid=KENNUNGDERANLAGE`
Answered	Incoming	Open URL	`https://smart.onoffice.de/smart/getPhoneAddress.php?phoneID={number}&state=CONN&connID={number}`
Ringing	Outgoing	REST API	`https://smart.onoffice.de/smart/setCallInfos.php?STATE=RING&CALLID={call_id}&TIMDURATION=&OUTBOUND=1&phoneNr={number}&kunde=IHRMANDANTENNAMEODERSCHLÜSSEL&LINENR=DURCHWAHLIHRESTELEFONS&systemid=KENNUNGDERANLAGE`
Ringing	Incoming	REST API	`https://smart.onoffice.de/smart/setCallInfos.php?STATE=RING&CALLID={call_id}&TIMDURATION=&OUTBOUND=0&phoneNr={number}&kunde=IHRMANDANTENNAMEODERSCHLÜSSEL&LINENR=DURCHWAHLIHRESTELEFONS&systemid=KENNUNGDERANLAGE`
Answered	Outgoing	REST API	`https://smart.onoffice.de/smart/setCallInfos.php?STATE=CONN&CALLID={call_id}&TIMDURATION=&OUTBOUND=1&phoneNr={number}&kunde=IHRMANDANTENNAMEODERSCHLÜSSEL&LINENR=DURCHWAHLIHRESTELEFONS&systemid=KENNUNGDERANLAGE`
Hangup	Outgoing	REST API	`https://smart.onoffice.de/smart/setCallInfos.php?STATE=DISC&CALLID={call_id}&TIMDURATION=&OUTBOUND=1&phoneNr={number}&kunde=IHRMANDANTENNAMEODERSCHLÜSSEL&LINENR=DURCHWAHLIHRESTELEFONS&systemid=KENNUNGDERANLAGE`
Hangup	Incoming	REST API	`https://smart.onoffice.de/smart/setCallInfos.php?STATE=DISC&CALLID={call_id}&TIMDURATION=&OUTBOUND=0&phoneNr={number}&kunde=IHRMANDANTENNAMEODERSCHLÜSSEL&LINENR=DURCHWAHLIHRESTELEFONS&systemid=KENNUNGDERANLAGE`

Der Punkt „KENNUNGDERANLAGE" ist wie erwähnt optional – nur bei mehreren Anlagen/Standorten nötig, sonst einfach den ganzen &systemid=...-Teil weglassen.