Verwenden Sie die Erweiterungspunkte zum Anpassen von Click-to-Dial
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
- 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.
