Verwenden Sie die Erweiterungspunkte, um das Speichern von Interaktionsprotokollen anzupassen

Hinweis: Dieser Artikel bezieht sich auf Genesys Cloud für Salesforce.

Sie können die Erweiterungspunkte verwenden, um die Speicherung von Interaktionsprotokollen in Genesys Cloud für Salesforce anzupassen. Die Erweiterungspunkte verwenden die Programmiersprache Salesforce Apex.

Hinweis: Dieser Artikel über erweiterte Anpassungen richtet sich an Entwickler, die mit Salesforce vertraut sind.

Voraussetzungen

  • Eine Version des verwalteten Pakets, die den Abschnitt Erweiterungspunkt-Einstellungen enthält. Weitere Informationen finden Sie unter Erweiterungspunkte konfigurieren.

Erstellen Sie in Salesforce eine einzelne Apex-Datei mit einer Apex-Klasse, die die Schnittstelle purecloud.CTIExtension.SaveLog implementiert Definieren Sie die Apex-Klasse als global, damit der Code von der Integration aufgerufen werden kann.

purecloud.CTIExtension.SaveLog Schnittstelle

Enthält eine Methodensignatur, die Sie definieren können, um die Speicherprotokolle in Genesys Cloud for Salesforce anzupassen.

Verwendung

Verwenden Sie die Methodensignatur in der Schnittstelle purecloud.CTIExtension.SaveLog um zu definieren, wie das Speichern von Protokollen funktioniert

onSaveLog-Methode

Dient zum Speichern von Interaktionsprotokollinformationen.

Diese Methode wird immer dann aufgerufen, wenn die Integration bei bestimmten Interaktions- oder Benutzerereignissen eine Änderung im Interaktionsprotokoll feststellt. Die Methode empfängt ungespeicherte Interaktionsprotokolldaten für einen Aufgabensatz.

Wenn die Methode die Daten erfolgreich speichert, gibt sie die ID des Datensatzes zurück. Wenn die Methode die Daten nicht speichert, wird eine leere Zeichenfolge zurückgegeben.

Hinweis: Die Methode onSaveLog unterstützt nicht die Rückgabe eines Nullwerts.

Eingabe-Eigenschaften

Die folgenden Eigenschaften sind in den JSON-Daten enthalten, die an die Methode übergeben werden.

Name Datentyp Beschreibung Notizen
ereignisName Zeichenkette Stellt den Zustand dar, der onSaveLogausgelöst hat.  Wert: interactionChanged, interactionDisconnected, interactionChangedAfterDisconnect, interactionACWCompleted, interactionRemoved, openCallLog, appDisconnected.
Interaktion Objekt Stellt den Zustand der Interaktion dar. Weitere Informationen finden Sie im Datenobjektformat unter Condensed conversation information.
callLog Objekt Interaktionsprotokolldaten mit geänderten Werten für die in Salesforce definierten Aktivitätsfelder. Liefert nur Teile des Integrationsprotokolls, die sich geändert haben.

Ausgangsparameter

Name Datentyp Beschreibung Notizen
{Rückgabewert} Zeichenkette ID des Interaktionsprotokolls, das gespeichert oder aktualisiert wurde.  

Weitere Informationen finden Sie unter Interaktionsprotokolle und Interaktionsprotokolle ansehen und bearbeiten

Beispiel

Wichtig:
  • Definieren Sie die Apex-Klasse als global, damit der Code von der Integration aufgerufen werden kann.
  • Wenn Sie mehr als einen Erweiterungspunkt (oder eine Schnittstelle) implementieren, legen Sie sie alle in derselben Apex-Datei ab.
global class MyCTIExtensions implements purecloud.CTIExtension.SaveLog {
    public String onSaveLog(String data) {
        // Example: Save interaction log as Task record after interaction is disconnected.
        Map<String, Object> saveLogData = (Map<String, Object>) JSON.deserializeUntyped(data);
        Map<String, Object> interaction = ( Map<String, Object>) saveLogData.get('interaction');
        Map<String, Object> callLog = ( Map<String, Object>) saveLogData.get('callLog');
        Boolean isDisconnected = (Boolean) interaction.get('isDisconnected');
        String callLogId = '';
        if (isDisconnected) {
            Task t = (Task) JSON.deserialize(JSON.serialize(callLog), Task.class);
            upsert t;
            callLogId = t.Id;
        }
        return callLogId; 
    }
}

Weitere Informationen finden Sie unter Erweiterungspunkte in Genesys Cloud für Salesforce.

Weitere Informationen über die Integration finden Sie unter Über Genesys Cloud für Salesforce.