URL-basierte Anrufsteuerung

3.8.5.4 URL-basierte Anrufsteuerung

Diese Funktionen ermöglichen eine URL-basierte Interaktion und erlauben eine nahtlose Integration mit Software von Drittanbietern wie CRM- und ERP-Systemen. Die Anwendung unterstützt zwei sich ergänzende Mechanismen: den Empfang von Befehls-URLs zur Fernsteuerung von Anrufen und das Senden von Webhook-Benachrichtigungen, um Anrufereignisse an externe Dienste weiterzuleiten.

Diese URL-Befehle können auch lokal auf einem Mac mit AppleScript ausgelöst werden. Damit können macOS-Nutzer Anrufe direkt aus kleinen Skripten starten, annehmen oder beenden.

Funktion	Richtung	Zweck
URL-Befehle zulassen	Anwendung eines Drittanbieters (z. B. CRM)  Enreach Contact Desktop Client	Ermöglicht Drittanbieteranwendungen, Anrufaktionen über HTTP-Anfragen zu steuern. Die URL-Befehle müssen genau dem Format entsprechen, das der Enreach Contact Desktop Client erwartet.
URL-Anrufbenachrichtigungen	Enreach Contact Desktop Client  Anwendung eines Drittanbieters (z. B. CRM)	Der Client informiert die anderen Anwendungen automatisch, wenn Anrufe beginnen, aktiv werden oder enden. Die konfigurierten URLs müssen dem vom empfangenden Drittanbieter-System vorgegebenen Format entsprechen, um eine ordnungsgemäße Verarbeitung sicherzustellen.

Dadurch ist es möglich, Anrufe aus anderen Anwendungen zu steuern und die Systeme automatisch zu synchronisieren.

Alle Anwendungen müssen auf demselben Computer (PC oder Mac) laufen.

URL-Befehle zulassen

Mit Accept URL Commands können andere Systeme Anrufe in der Anwendung steuern, indem sie einfache Webanfragen (URLs) senden.

Wenn diese Option aktiviert ist, öffnet die Anwendung einen lokalen HTTP-Listener auf dem angegebenen Port und wartet auf eingehende Befehls-URLs. Diese Befehle können Anrufaktionen aus der Ferne auslösen.

Option	Erläuterung
Listening-Port	Der Port, über den die Anwendung Befehle empfängt. Das externe System muss Anfragen an diesen Port senden.
Anruf tätigen	Dieses Feld definiert das Befehlssegment, das verwendet wird, um einen ausgehenden Anruf über eine URL-Anfrage auszulösen. Um eine Nummer zu wählen, sendet der Drittanbieter eine HTTP-Anfrage an den Listening-Port, die sowohl das Befehlskennwort als auch die Zielrufnummer enthält. Beispiel: http://localhost:5678/make/020123456 Wenn diese URL aufgerufen wird, beginnt die Anwendung sofort mit dem Wählen von 020123456.
Anruf annehmen	Dieses Feld definiert den Befehl, der verwendet wird, um einen ausgehenden Anruf über eine URL-Anfrage auszulösen. Wenn ein Anruf eingeht, kann das Drittsystem diesen Endpunkt aufrufen, um die Anwendung anzuweisen, den Anruf automatisch anzunehmen. Beispiel: http://localhost:5678/answer Bei Ausführung nimmt die Anwendung den aktuell eingehenden Anruf an.
Anruf beenden	URL-Pfad, der zum Beenden des aktuellen Anrufs verwendet wird. Beispiel: http://localhost:5678/end

URL-Anrufbenachrichtigungen

Mit URL-Anrufbenachrichtigungen informiert die Anwendung automatisch andere Systeme, wenn bestimmte Anrufereignisse auftreten.

Wenn diese Funktion aktiviert ist, sendet die Anwendung eine Benachrichtigung (HTTP-Anfrage) an eine vordefinierte URL. Diese Benachrichtigungen können Informationen wie die Nummer des Anrufers enthalten.

Enreach Contact überträgt Telefonnummern standardmäßig ohne ein führendes "+" (z. B. 4923147770).

Wenn ein internationales Format erforderlich ist (z.B. +4923147770), kann das "+" direkt in der konfigurierten URL hinzugefügt werden, zum Beispiel:
http://localhost:9090/incoming/+${callerid}
Beachten Sie: Bei diesem Ansatz wird das "+" auch bei internen Telefonnummern hinzugefügt.

Option	Erläuterung
Eingehender Anruf	Sendet eine Benachrichtigung, wenn ein neuer Anruf eingeht. Eine Anfrage wird an die konfigurierte URL gesendet Beispiel: http://example.com/incoming/${callerid} oder http://localhost:9090/incoming/${callerid}
Aktiver Anruf	Sendet eine Benachrichtigung, wenn ein neuer Anruf angenommen wurde. Beispiel: http://example.com/active/${callerid} oder http://localhost:9090/active/${callerid}
Anruf beendet	Sendet eine Benachrichtigung, wenn ein Anruf endet. Beispiel: http://example.com/end/${callerid} oder http://localhost:9090/end/${callerid}