Administration

Bis Version 1.3

Der Voicebot Connector wird über die appsettings.json Datei, welche sich direkt im Installationsverzeichnis befindet, konfiguriert.

Hier gibt es den Abschnitt ConnectorConfig, indem die einzelnen Werte konfiguriert werden können. Eine Übersicht der Werten finden Sie hier.

Ab Version 1.4

Der Voicebot Connector wird über das anyContact.Central konfiguriert. Zum Konfigurieren einer Anwendung muss eine App Deployment Datei (.appdpl) hochgeladen werden. Diese liegt dem Installationspaket bei.

Öffnen sie die Website des anyContact.Central und navigieren sie auf die Seite “App-Konfiguration”.

Durch das Klicken auf „Neue Konfiguration hochladen“ in der Konfigurationsübersicht öffnet sich ein neues Fenster, welches das Hochladen neuer Konfigurationen ermöglicht. Das Hochladen von Dateien erfolgt entweder durch das ziehen und ablegen der Datei im gekennzeichneten Bereich, oder alternativ durch den Windows-Explorer, der sich beim Klick auf denselben Bereich öffnet.

Wählen sie hier die zuvor im anyContact.Identity erstelle Voicebot Anwendung aus und laden sie die .appdpl Datei aus dem Installationspaket hoch.

Nachdem die Konfiguration erstellt wurde, öffnet sich auf der rechten Seite der Website ein Bereich in dem die Werte der Voicebot Connector Konfiguration angepasst werden können.

Mit einem Klick auf “Speichern” werden die Änderungen übernommen.
Der Button “Wiederherstellen” setzt die Konfiguration auf die Standartwerte zurück.
Mit dem Button “Aktualisieren” kann eine neuere Version der .appdpl Datei hochgeladen werden, die mit einem evtl. Update mitgeliefert wird. Die bisher konfigurierten Werte werden dadurch nicht überschrieben, es kann dadurch allerdings neue Standardwerte und neue Einstellungsmöglichkeiten geben.
Um eine Konfiguration zu löschen, klicken sie unten rechts auf das Löschsymbol.

Konfigurationswerte

Eigenschaft	Beschreibung
UseAuthenticationHeaderForIvr	Legt fest, ob für die IVR WebApi ein Token verwendet werden muss.
UseAuthenticationHeaderForParloa	Legt fest, ob für die Parloa WebApi ein Token verwendet werden muss.
UseAuthenticationHeaderForBotfriends	Legt fest, ob für die Botfriends WebApi ein Token verwendet werden muss.
UseAuthenticationHeaderForAristech	Legt fest, ob für die Aristech WebApi ein Token verwendet werden muss.
UseAuthenticationHeaderForAgPhilipp	Legt fest ob für die Agentur Philipp WebApi ein Token verwendet werden muss.
UseAuthenticationHeaderForReporting	Legt fest, ob für die Reporting WebApi ein Token verwendet werden muss.
AuthenticationHeaderName	Der Name des Header, welcher den Token für die WebApi enthält.
CleanupDuration	Legt den Intervall in Minuten fest, in dem der Connector alte Anfragen aus dem Cache entfernt.
Tokens	Diese Liste beinhaltet alle gültigen Tokens, welche über die Header Authentifizierung gültig sind. Beispiel: JSON `"Tokens": [ { "Alias": "TokenFürProjekt XYZ", "Token": "Frei definierbarer Token" }`
DbContext	Die Verbindungszeichenfolge, um sich an der anyContact Voicebot Datenbank anzumelden. Die Verbindungszeichenfolge lautet wie folgt: Data Source=SERVER;Initial Catalog=anyContact_Voicebot;Persist Security Info=True;User ID=USERID;Password=PASSWORD;MultipleActiveResultSets=True;Connection Timeout=5;Encrypt=True;TrustServerCertificate=True;Application Name=anyContactVoicebot
ParloaApiUrl	Die Basis Url für die Kommunikation mit der Parloa ConversatioHistory Api
ParloaToken	Der Token für die Kommuniaktion mit der Parloa ConversationHistory Api

Der Alias in der Token-Konfiguration wird lediglich für die Anzeige in der Logdatei benutzt!

Sollte die Agent View Webseite zum Einsatz kommen und die Header Authentifizierung für das Reporting aktiv sein, muss folgendes in der agent.js Datei angepasst werden:

JS

const propertySessionName = "vbSessionId";

const requestHeader = {
    'Accept': 'application/json',
    'Content-Type': 'application/json',
    'x-sncom-key': 'avToken'
}

Die propertySessionName Variable beinhaltet der Namen der Kontakteigenschaft über welche die SessionId ausgelesen werden muss.

Über den requestHeader wird die Authentifizierung an der Reporting WebApi durchgeführt.
Der Schlüssel ‘x-sncom-key' und der Wert 'avToken’ müssen durch den in der appsettings.json hinterlegten Token und den AuthenticationHeaderName ersetzt werden.