Verwenden Sie die Erweiterungspunkte zum Anpassen von Click-to-Dial

Notiz : Dieser Artikel bezieht sich auf Genesys Cloud für Salesforce. Dieser Artikel zur erweiterten Anpassung richtet sich an Entwickler, die mit Salesforce vertraut sind.

Sie können die Erweiterungspunkte verwenden, um das Click-to-Dial-Verhalten in Genesys Cloud für Salesforce anzupassen. Die Erweiterungspunkte verwenden die Programmiersprache Salesforce Apex.

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.ClickToDial implementiert Definieren Sie die Apex-Klasse als global, damit der Code von der Integration aufgerufen werden kann.

purecloud.CTIExtension.ClickToDial-Schnittstelle

Enthält eine Methodensignatur, die Sie definieren können, um die Click-to-Dial-Funktionalität in Genesys Cloud for Salesforce anzupassen.

Verwendung

Um zu definieren, wie die Click-to-Dial-Funktionalität funktioniert, verwenden Sie die Methodensignatur im purecloud.CTIExtension.ClickToDial Schnittstelle.

onClickToDial-Methode

Löst einen Anruf oder eine SMS-Nachricht aus. 

Wenn Salesforce den Client über ein Click-to-Dial-Ereignis benachrichtigt, führt der Client das Click-to-Dial-Ereignis anhand der Parameter in Ihrem Apex-Code aus. Die Methode kann Daten zurückgeben, die das standardmäßige Click-to-Dial-Verhalten ändern.

Wenn der Apex-Code eine Ausnahme auslöst, führt die Integration das standardmäßige Click-to-Dial-Verhalten aus. Wenn kein Wert zurückgegeben wird, unterdrückt die Integration das Click-to-Dial-Verhalten.

Eingabe-Eigenschaften

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

Name Datentyp Beschreibung Notizen
Nummer Zeichenkette Rufnummer, die von der Integration angerufen wird.
Objekt Zeichenkette Art des Objekts, z. B. ein Kontakt oder ein Konto in Salesforce.
Objekt-ID Zeichenkette ID eines relevanten Objekts, z. B. eines Kontakts oder eines Kontos, das automatisch mit einer Aktivität assoziiert werden soll. objectId gilt nur für einen einzigen Datensatz 
objektname Zeichenkette Name des Datensatzes in Salesforce.

Eigenschaften der Ausgabe

Die folgenden Eigenschaften werden in den von der Methode zurückgegebenen JSON-Daten unterstützt.

Name Datentyp Beschreibung Notizen
Nummer Zeichenkette Siehe Eingabeeigenschaften Tabelle
Objekt Zeichenkette Siehe Eingabeeigenschaften Tabelle
Objekt-ID Zeichenkette Siehe Eingabeeigenschaften Tabelle
objektname Zeichenkette Siehe Eingabeeigenschaften Tabelle
Attribute Objekt Schlüssel-Wert-Paare von Attributen, die der Interaktion hinzugefügt werden sollen.
queueId Zeichenkette ID der Warteschlange, in deren Namen ein Anruf getätigt werden soll.
autoPlace Boolesch Die Integration stellt automatisch einen Anruf her (wahr), oder die Integration füllt das Feld Name oder Nummer mit der Telefonnummer (falsch).
Typ Zeichenkette Art der Interaktion.

Gültige Werte: anrufen, sms. 

Wenn kein Typ angegeben wird, wird standardmäßig call verwendet 

Name des Anrufers Zeichenkette Name, der den Empfängern Ihrer Anrufe angezeigt wird.
callerId Zeichenkette Rufnummer, die den Empfängern Ihrer Anrufe angezeigt wird.
Zuordnungen Array Liste der Salesforce-Datensätze, die dem Feld Name oder Verwandt mit im Client hinzugefügt werden sollen.
utilizationLabelId Zeichenkette Kategorisiert die Konversation. Die Einstellungen für die maximale Auslastung können für jedes Etikett einzeln konfiguriert werden. Damit die Bezeichnung angezeigt wird, muss sich der Agent in der Warteschlange befinden oder das Feld „QueueId“ muss ausgefüllt sein.

Weitere Informationen finden Sie unter Click-to-dial, Konfigurieren von Click-to-dial, und Erstellen von Click-to-dial auf benutzerdefinierten Visualforce-Seiten

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.ClickToDial {
public String onClickToDial(String data) {
// Example: Specify On Behalf of Queue, Caller ID, Utilization Label, and Name for click-to-dial.
Map<String, Object> clickToDialData = (Map<String, Object>) JSON.deserializeUntyped(data);
clickToDialData.put('queueId', '04a183b6-de9e-4c01-9e88-eabxxxxxad0d');
clickToDialData.put('callerIdName', 'John Smith');
clickToDialData.put('callerId', '+13175550123');
clickToDialData.put('utilizationLabelId', '62f1e0d5-cb8e-4cf7-9049-53dfb00d1983');
return JSON.serialize(clickToDialData);
    }
}

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.