Dieser Artikel wurde automatisch übersetzt. Siehe die Referenzversion auf Englisch.
Rainbow ermöglicht es Ihnen, Informationen über eingehende Telefonanrufe zurückzuholen. Sie können diese Informationen nutzen, indem Sie sie an eine andere Anwendung weitergeben.
Mit dieser "Computer Telefonie Integration" können Sie von Rainbow Informationen in Kombination mit einer anderen Datenbank profitieren.
Für jede externe Anwendung, die Sie für diese Art der Integration verwenden möchten, ist eine spezifische Konfiguration erforderlich. Die korrekte Syntax für die Übertragung von Variablen finden Sie in der jeweiligen Dokumentation.
Am Ende dieses Artikels finden Sie einige Beispiele für die Integration zwischen Rainbow und dem Testwerkzeug "MicroCRM".
Konfigurieren Sie die Datei custo-manifest.json
Mit dieser neuen Version können Sie direkt aus der Desktop-App heraus eine Vorlage für die neue Datei custo-manifest.j son exportieren (1), einschließlich einer Syntaxhilfe. Sobald Sie die Datei geändert haben, können Sie (2) die Konfiguration auf derselben Einstellungsseite importieren.
Diese Datei enthält eine Liste von Aktionen, die bei einem vordefinierten Ereignis ausgeführt werden sollen.
Ereignisse für eingehende Anrufe:
Es sind 4 Ereignisse verfügbar:
- on-incoming-pbx-call-actions (externe Anwendung wird gestartet, wenn ein neuer eingehender Anruf vorliegt)
- on-incoming-pbx-call-display-actions (CPaaS-Nutzung - Anzeige weiterer Informationen, wenn ein neuer Anruf eingeht, entweder aus einer Datei, über die REST-API oder durch Starten eines Rainbow Bot)
- on-answering-incoming-pbx-call-actions (externe Anwendung, die gestartet wird, wenn ein eingehender Anruf angenommen wird)
- on-releasing-incoming-pbx-call-actions (externe Anwendung, die gestartet wird, wenn ein eingehender Anruf freigegeben wird)
- on-incoming-pbx-call-button-actions (externe Anwendung wird nur bei Klick auf eine Schaltfläche im Popup für eingehende Anrufe gestartet)
Für das ausgewählte Ereignis müssen Sie mindestens den Abschnitt "command" konfigurieren, der aus "url" und "params" besteht. Das Feld "name" muss nur für das Ereignis on-incoming-pbx-call-button-actions ausgefüllt werden, es wird der Name sein, der auf der Schaltfläche im Pop-up für eingehende Anrufe angezeigt wird
"url" - Standort der externen Anwendung
im Feld URL geben Sie entweder die URL oder den Pfad der externen Anwendung an
"params" - Variable, die an die externe Anwendung übermittelt wird
Es sind verschiedene Variablen verfügbar:
Angerufener (Rainbow Benutzer, der sich gerade mit der Desktop-Anwendung verbindet):
- ${localUser.firstName}
- ${lokalerBenutzer.Nachname}
- ${localUser.email}
- ${localUser.canonicalNumber}
- ${localUser.phoneNumber}
- ${localUser.internalNumber}
Anrufende Partei
- ${Anrufer.firstName}
- ${Anrufer.Nachname}
- ${Anrufer.phoneNumber}
Angerufene Telefonnummer (wenn der Anruf umgeleitet wird oder wenn Rainbow die Gruppennummer erhält)
- ${angerufen.phoneNumber}
Anrufkontext (nur für OXE)
- ${call.callId}
- ${call.globalCallId}
Spezifische Optionen für on-answering-incoming-pbx-call-actions
"RaiseChangeCall": false | true | only
Mit dieser Option kann das Verhalten bei der Annahme eines weitergeleiteten Anrufs konfiguriert werden:
- false = nur direkte Anrufe an den Benutzer lösen das Ereignis aus.
- true = das Ereignis wird für direkte Anrufe an den Benutzer und auch für Anrufe, die an diesen Benutzer weitergeleitet wurden, ausgelöst.
- only = nur übertragene Anrufe an den Benutzer lösen das Ereignis aus.
Datei der Vorlage
{ "version": "2", "extension-points": {"on-incoming-pbx-call-actions": [ { "name": " ", "command": { "url": " ", "params": " " } } ],
" on-incoming-pbx-call-display-actions": [
{
"name": " ",
"command": {
"commandType": " ",
"url": " ",
"method": " ",
"params": " ",
"header": [
" "
],
"Jid": ""
},
"responseType": " ",
"jsonField": " "
}
],
"on-answering-incoming-pbx-call-actions": [ { "name": " ", "command": { "url": " ", "params": " "},
" RaiseChangeCall": false } ],"on-releasing-incoming-pbx-call-actions": [ { "name": " ", "command": { "url": " ", "params": " " } } ],"on-incoming-pbx-call-button-actions": [ { "name": " ", "command": { "url": " ", "params": " " }, "AnswerOnClick": false } ]}, "help": [ "Diese Json-Datei enthält die Ereignisanpassung für die Desktop-Anwendung Rainbow ",
" Quellen der Ereignisse: ",
" - on-incoming-pbx-call-actions : wenn ein neuer eingehender Anruf präsentiert wird. ",
" - on-incoming-pbx-call-display-actions : wenn ein neuer eingehender Anruf angezeigt wird. ",
" - on-answering-incoming-pbx-call-actions : wenn ein eingehender Anruf angenommen wird. ",
" - on-releasing-incoming-pbx-call-actions : wenn ein eingehender Anruf freigegeben wird. ",
" - on-incoming-pbx-call-button-actions : bei Klick auf eine Schaltfläche, die im Popup-Fenster für eingehende Anrufe hinzugefügt wurde",
" ",
" name : wird nur für die Aktionsschaltfläche als Bezeichnung der Schaltfläche verwendet. ",
" filter: mit dem Wert NoShortNumber wird kein Befehl aufgerufen, wenn die Anrufernummer eine interne Nummer ist. ",
" AnswerOnClick: nur für `on-incoming-pbx-call-button-button-actions`, wenn auf `true` gesetzt, wird der Klick ",
" auf den Button sowohl den Anruf beantworten als auch den Befehl aufrufen ",
" RaiseChangeCall: nur für `on-answering-incoming-pbx-call-call-actions`, wenn auf `true` oder `only` gesetzt",
" wird das Ereignis bei Transfer/Switch Call auslösen. ",
" responseType: nur für `on-incoming-pbx-call-display-actions` mit commandType `file` oder `rest`",
" und kann `markdown` oder `json` sein. ",
" jsonField: nur für `on-incoming-pbx-call-display-actions` mit responseType `json` ",
" ",
" Verfügbare Befehlsschlüssel: ",
" url: ist der Pfad der ausführbaren Datei oder eine URL ",
" params: ist eine Zeichenkette mit der Variable ${xx}, die durch den Wert ersetzt wird, wenn der Befehl aufgerufen wird ",
" commandType: nur für `on-incoming-pbx-call-display-actions` und kann `file` oder `rest` oder `rainbowBot` sein",
" method: nur für `on-incoming-pbx-call-display-actions` mit commandType `rest` und kann `GET` oder `POST` sein",
" header: nur für `on-incoming-pbx-call-display-actions` mit commandType `rest` ist optional ",
" und wird als Kopfzeile in die REST-Anfrage eingefügt ",
" Jid: nur für `on-incoming-pbx-call-display-actions` mit commandType `rainbowBot` ",
" ",
" Variable für Rainbow Benutzer (ME) ",
" ${localUser.firstName} ${localUser.lastName} ${localUser.email} ",
" ${localUser.canonicalNumber} ${localUser.phoneNumber} ${localUser.internalNumber} ${localUser.phonePbx}",
" ",
" Variable für Anrufer Benutzer ",
" ${caller.firstName} ${caller.lastName} ${caller.phoneNumber} ",
" ",
" Variable für angerufene Nummer - wenn der Anruf umgeleitet wird oder wenn Rainbow die Gruppennummer erhält ",
" ${called.phoneNumber} ",
" ",
" Variable für Anrufkontext ",
" ${call.callId} ",
" ${call.globalCallId} (nur OXE) ",
" ${call.correlatorData} ",
" ${call.hexCorrelatorData} " ] }
- Entfernen Sie alle nicht verwendeten Ereignisse aus der Datei.
- löschen Sie nicht den Raum zwischen den doppelten Anführungszeichen für die nicht verwendeten Parameter ("name": " ", "url": " ", "params": " " sonst wird die importierte Datei nicht berücksichtigt
Beispiele für die Konfiguration mit dem Tool MicroCRM
Um einen Datensatz in der MicroCRM-Datenbank zu öffnen oder zu erstellen, um die Telefonnummer zu übertragen, muss das Tool mit dem Parameter -number ausgeführt werden:
MicroCRM.exe -number Rufnummer
- Für die folgenden Beispiele verwenden wir die Telefonnummer des Anrufers, die die Variable ${caller.phoneNumber} ist
- MicroCRM ist auf dem PC an folgendem Ort installiert: C:\MicroCRM\MicroCRM.exe
Beispiel 1 - Öffnen von MicroCRM bei angenommenen Anrufen
Sie müssen nur den folgenden Teil der Datei ändern:
"on-answering-incoming-pbx-call-actions": [ { "name": " ", "command": { "url": " C:\\MicroCRM\\MicroCRM.exe", "params": " -number${caller.phoneNumber}" } } ],
Hinweis: Vergessen Sie nicht, für den Pfad C zwei \\ zu verwenden:\\MicroCRM\\MicroCRM.exe
Beispiel 2 - Öffnen Sie MicroCRM, wenn Sie einen Anruf über die entsprechende Schaltfläche in der Benachrichtigung über eingehende Anrufe annehmen
Sie müssen nur den folgenden Teil der Datei ändern:
"on-incoming-pbx-call-button-actions": [ { "name": "Open MicroCRM", "command": { "url": " C:\\MicroCRM\\MicroCRM.exe", "params": " -number${caller.phoneNumber}" }, "AnswerOnClick": true} ]
Hinweis: Um die externe Anwendung zu öffnen und gleichzeitig den Anruf zu beantworten, müssen Sie den Parameter "AnswerOnClick" auf true setzen.
Beispiel 3 - Öffnen einer französischen Webseite mit umgekehrtem Verzeichnis bei eingehenden Anrufen
In diesem Beispiel verwenden wir keine auf dem PC installierte Anwendung, sondern wir öffnen eine Webseite und die Variable wird direkt in die "url" eingegeben
"on-incoming-pbx-call-actions": [ { "name": " ", "command": { "url": "https://www.pagesjaunes.fr/annuaireinverse/recherche", "params": "quoiqui=${caller.phoneNumber}&proximite=0" } } ],
Installationsoptionen für die Bereitstellung der Datei custo-manifest.json unter Verwendung eines Software Distribution Tools
Die Manifestdatei muss zunächst auf dem PC bereitgestellt werden, z. B. kann die Datei in einen Benutzerordner C:\Users\username\Rainbow_custom_manifest\ kopiert werden.
Dann muss das Rainbow Desktop App Setup mit dem Parameter /Custom gestartet werden, um die Custom-Manifest Datei für den Benutzer anzuwenden.
MSI-Setups verwenden:
msiexec /i "Rainbow_installer_user.msi" WRAPPED_ARGUMENTS="/Custom=C:\\Users\\username\\Rainbow_custom_manifest\custo-manifest.json"
Exe-Setups verwenden:
Rainbow_Installer.exe /Custom=C:\\Benutzer\Benutzername\\Rainbow_custom_manifest\\custo-manifest.json
Deaktivieren Sie die Funktion
Bei einer Installation über ein Softwareverteilungsprogramm
Um die Verwendung der benutzerdefinierten Datei zu deaktivieren, führen Sie die Installation mit /Custom ohne einen Wert
aus, z. B. Rainbow_Installer .exe /Custom oder deinstallieren und installieren Sie die Desktop-App Rainbow erneut.
Für die manuelle/Benutzer-Installation (Import der custo-manifest Datei)
Gehen Sie zum Ordner C:\Benutzer\Benutzername\AppData\Roaming\Alcatel-Lucent Enterprise\Rainbow
Löschen Sie die Datei custo-manifest.json
Migration Starten externer Anwendungen v1 zu v2
Ein Benutzer, der bereits Version 1 verwendet, kann diese ohne Änderungen weiter nutzen
Der Import/Export wird nicht angezeigt.
Um von Version 1 auf Version 2 zu migrieren, müssen Sie:
- Speichern Sie die Datei "Custom manifest v1".
- Ändern Sie die Datei Rainbow Einstellungen und setzen Sie die Zeile "customizationDirectory": true
- Dateispeicherort C:\Benutzer\Benutzername\AppData\Roaming\Alcatel-Lucent Enterprise\Rainbow
- Beachten Sie, dass Sie Rainbow vor dem Ändern der Datei beenden müssen.
- Jetzt wird unter Einstellungen->Telefonie->Anpassung der Abschnitt sichtbar
- Exportieren Sie die Vorlage, fügen Sie in dieser Datei die benutzerdefinierten Befehle aus Ihrer in Schritt 1 gespeicherten Datei hinzu und importieren Sie sie dann wieder.
Kommentare
0 Kommentare
Zu diesem Beitrag können keine Kommentare hinterlassen werden.