Action-URL

Action URLs sind Links oder Befehle, die während eines bestimmten Telefonzustands aufgerufen werden.

Sie können mit Action-URL's beispielsweise Rufnummern an Drittanbieter-Software übergeben und dort Kontakte anzeigen lassen oder andere angebotene Funktionen ausführen.

Wir unterscheiden in zwei Action-URL Arten, zum einen der Einsatz mit Webbrowsern, zum anderen CLI API Operationen für die Parameterübergabe an Windows Applikationen und die Erzeugung eigener Textdateien.

In den nachfolgend aufgelisteten Telefonzuständen kann durch das Telefon eine beliebige Action-URL gesendet werden.

Eine Action-URL wird immer dann versendet, wenn ein Action-URL Eintrag in den Einstellungen angelegt ist.

Für den Aufbau der Action URL lesen Sie gegebenenfalls bitte auch die Hilfe des jeweiligen Drittanbieters (z.B. sugar CRM, tecart oder salesforce)

	Action URL möglich im Telefonzustand
	Eingehender Anruf
	Ausgehender Anruf
	Bei Anrufannahme
	Anruf Halten
	Anruf Beenden

Nachfolgende Telefonwerte können in Form eines Platzhaltes in Action-URL's eingebunden werden:

	Variablen		Beschreibung
	$Account		SIP Account Bezeichnung
	$LineID		Verwendete Telefonleitung (1-6)
	$LocalParty		Lokaler SIP Benutzer Name
	$RemoteParty		Rufnummer der Gegenstelle
	$RemoteAlias		Displayname der lokalen Gegenstelle
	$LocalAlias		Displayname der lokalen Gegenstelle
	$CallDurationSeconds		Anzahl Sekunden des Vorgangs
	$CallCreatedTime		Uhrzeit des Rufaufbaus
	$CallConnectedTime		Dauer des Anrufs
	$CallDisconnectedTime		Uhrzeit des Rufabbaus
	$CallOrigin		Rufrichtung Eingehend\|Ausgehend (INBOUND\|UTBOUND)
	$CallOriginInt		Zahlenwert der Rufrichtung Eingehend\|Ausgehend (0\|1)
	$CallGUID		Rufkennung GUID
	$DND		Rückgabewert 0 wenn DND inaktiv \| 1 wenn aktiv

Action URL im Standardeinsatz per HTTP Request (Webbrowser)

Beispiele:

	Beispiele Action-URL		Beschreibung
	Was ist die Anforderung?		Sie wollen bei einem eingehenden Anruf ihre webbrowser basierte Kundenverwaltung öffnen. Die Web CRM soll den zugehörigen Kontakt und die Rufrichtung anzeigen (Eingehend/Ausgehend).

	Action-URL mit eingesetzten Variablen		http://mycrm.php?value1=<;$RemoteParty>&value2=<$CallOrigin>

	Mit eingesetzten Variablen als BASE64 Parameterausgabe		http://mycrm.php?value1=<;base64($RemoteParty)>&value2=<base64($CallOrigin)>

Zeige Browser / Use API

Mit der Option "Zeige Browser / Use API" können Sie entscheiden, ob ein Standardaufruf (vorgenanntes Beispiel) als unsichtbarer Aufruf erfolgen soll oder ob explizit ein SICHTBARER mit dem Aufruf der Webbrowser geöffnet wird. Ist ein "http:" Link hinterlegt, dann wird dieser immer ausgeführt!

Action URL mit CLI API Operationen (Programmaufruf mit Parametern)

Starten Sie beliebige Programme (z.B.: Kontakt-, Mandanten-, Patientenverwaltung) auf und ergänzen den Aufruf mit Telefonparametern (Shell Execute).

Das aufgerufene, externes Programm kann mittels der übermittelten Parameter eine Aktion ausführen (softwareabhängig). Zum Beispiel kann damit das Anzeigen eines Kontaktes zu einer Rufnummer oder eine Kundenhistorie etc. ausgelöst werden. Für Entwickler bietet diese Vorgehensweise eine hervorragende und einfache Option eigene CTI Schnittstellen zu erzeugen.

Beispiele:

	Beispiele Action-URL\|CLI API Operation		Beschreibung
	Firefox Webbrowser öffnen		firefox http://mycrm.php?value1=<;$RemoteParty>&...

	Firfox Webbrowser über die direkte Pfadangabe mit 400 x 400 Pixel Fenstergröße öffnen		"%programfiles(x86)%\Mozilla Firefox\firefox.exe" http://mycrm.php?Value1=<;$RemoteParty> -height 400 -width 400

	Parameterausgabe an CRM EXE		"%appdata%\crm.exe" <$RemoteParty> <$LineID> -kiosk

Im Browser anzeigen

Bei Verwendung von externen Programmaufrufen und CLI API Operationen gilt, dass die Funktion explizit nur dann ausgeführt wird, wenn "Use API" aktiviert ist. Unsichtbare Programmaufrufe sind unter Verwendung der CLI API nicht möglich. Nutzen Sie hierzu bereitgestellte Parameter der verwendeten Software des Drittherstellers.

Action URL mit CLI API Operationen (Textdatei erzeugen)

Beispiel zur Anzeige eines Kontakts anhand der Software Solution Charly für Zahnärzte :

Die zu erzeugende Datei wird von der "Charly" Kontaktverwaltung gepollt und zeigt den gewünschten Kontakt mit dem Kommando "select 069123456"an. Danach löscht "Charly" die Datei automatisch und erwartet einen neuen Vorgang.

	Beispiele Action-URL		Beschreibung
	Anlegen einer Datei teleinfo.asc bei Rufeingang. Die Datei soll eine Textzeile "select <Rufnummer> beinhalten und mit jedem neuen Vorgang überschrieben werden.		"xproxy.exe" file:"%appdata%\teleinfo.asc" overwrite:"Select <$RemoteParty>"

Anlegen einer beliebigen Textdatei, z.B. als Gesprächsverlaufshistorie :

	Beispiele Action-URL		Beschreibung
	Anlegen einer Datei history.csv im Telefon Programmpfad die alle verfügbaren Programmvariablen beinhaltet. Sämtliche Statusänderungen sollen am Ende der Datei hinzugefügt werden (Beispiel für Rufeingang).		"xproxy.exe" file:"history.csv" write:"Incoming;<$CallOrigin>;<$CallOriginInt>;<$Account>;<$LineID>;<$LocalParty>;<$LocalAlias>;<$RemoteParty>;<$RemoteAlias>;<$CallDurationSeconds>;<$CallCreatedTime>;<$CallConnectedTime>;<$CallDisconnectedTime>;<$CallGUID>"

Parameter zur Dateierzeugung:

	Variablen		Beschreibung
	"xproxy.exe"		"xproxy.exe" ist immer aufzurufen wenn eine Textdatei erzeugt werden soll!
	file:"<Pfad>"		Pfadangabe an der die Datei erzeugt werden soll
	overwrite:		Überschreibt die Datei mit jeder neuen Aktion
	write:		Fügt eine neue Textzeile an das Dateiende hinzu
	%appdata%		Windows Umgebungsvariable für das "Roaming-Verzeichnis". Sie können beliebige Umgebungsvariablen nutzen. Es ist möglich, dass einige Umgebungsvariablen keine Auswirkungen zeigen.
	%programdata(x86%)%		Windows Umgebungsvariable für das x86 Programverzeichnis Umgebungsvariablen: http://de.wikipedia.org/wiki/Umgebungsvariable