Verwenden Sie das SDK zum Weiterleiten von Salesforce-E-Mails

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

Nachdem Sie das Routing von Salesforce-E-Mails in Salesforce konfiguriert haben, verwenden Sie unser SDK im verwalteten Paket, um Salesforce-E-Mails durch Genesys Cloud for Salesforce zu leiten. Das SDK verwendet die Programmiersprache Salesforce Apex. 

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

Voraussetzungen

Greifen Sie auf unser SDK über die Klasse Email in den Namespaces purecloud.SDK.Email und purecloud.Email zu. Verwenden Sie den Namespace purecloud.Email , um Informationen für Betreff, fromName und fromAddress festzulegen

E-Mail-Klasse

Enthält statische Methoden zur Weiterleitung von Salesforce-E-Mails durch Genesys Cloud for Salesforce.

Namespace

purecloud.SDK.Email

Verwendung

Verwenden Sie diese Methoden, um Genesys Cloud E-Mail-Objekte zu erstellen, die Salesforce-E-Mails durch Genesys Cloud für Salesforce leiten. Diese Objekte können Daten zum Einstellen von Popup-Fenstern, zum Ändern von Interaktionsdetails oder zum Hinzufügen von Daten zu den Aktivitätsdatensätzen in Salesforce enthalten.

E-Mail-Methoden

Die folgenden Methoden sind für die Klasse Email verfügbar.

Leitet eine E-Mail-Interaktion an eine bestimmte Warteschlange weiter und zeigt eine bestimmte Salesforce-Seite an.

Parameter

Name Datentyp Beschreibung Notizen
Warteschleife Zeichenkette Warteschlange in Ihrer Genesys Cloud-Organisation, an die Sie Salesforce-E-Mails weiterleiten möchten. Entspricht Call.QueueName in den Interaktionsdetails.
sfUrlPopValue Zeichenkette Wert in der URL der Salesforce-Seite, die bei einer Interaktionswarnung angezeigt werden soll.

Beispiel

Das folgende Beispiel zeigt, wie Sie diese Aktionen durchführen:

  • Leiten Sie Salesforce-E-Mails an eine bestimmte Warteschlange weiter.
  • Pop-up-Bildschirm einer bestimmten Salesforce-Seite.

Interaktionsdetails mit Apex-Code

purecloud.SDK.Email.create('CustomerService', '500360000015OCJ');

Leitet Salesforce-E-Mails an Agenten in einer bestimmten Warteschlange weiter, denen bestimmte Fähigkeiten und Sprachen in Ihrer Genesys Cloud-Organisation zugewiesen sind, und verwendet den Parameter Attribute, um Aktionen durchzuführen.

Parameter

Name Datentyp Beschreibung Notizen
Warteschleife Zeichenkette Warteschlange in Ihrer Genesys Cloud-Organisation, an die die Integration Salesforce-E-Mails weiterleiten soll. Entspricht Call.QueueName in den Interaktionsdetails.
Skills Liste<String> Liste der Fähigkeiten in Ihrer Genesys Cloud Organisation.  Assoziiert mit Agenten, die Salesforce-E-Mails erhalten sollen.
Sprache Zeichenkette Sprachkenntnisse in Ihrer Genesys Cloud Organisation.  Assoziiert mit Agenten, die Salesforce-E-Mails erhalten sollen.
Attribute Karte<String, Object=""> Siehe Attribute Map.

Attribute Karte

Eine Zuordnung von Attributen, die eine Salesforce-Seite oder ein Suchergebnis enthalten können, oder Daten, die zu den Interaktionsdetails oder Aktivitätsdatensätzen in Salesforce hinzugefügt werden.

Parameter

Schlüssel Art Erforderlich oder optional Beschreibung Notizen
SF_URLPop Zeichenkette Optional ID der Salesforce-Seite, die bei einer Interaktionswarnung angezeigt werden soll Verwenden Sie entweder SF_URLPop oder SF_SearchValue, nicht beide. Für eine schnellere Verarbeitung von Screenpops verwenden Sie SF_URLPop.
SF_SearchValue Zeichenkette Optional ID des Salesforce-Suchergebnisses, das bei einer Interaktionswarnung angezeigt werden soll Verwenden Sie entweder SF_URLPop oder SF_SearchValue, nicht beide. Für eine schnellere Verarbeitung von Screenpops verwenden Sie SF_URLPop.
Benutzerdefiniertes Attribut String, Ganzzahl, Boolescher Wert Optional Daten, die bei Interaktionswarnungen zu Interaktionsdetails oder Aktivitätsaufzeichnungen hinzugefügt werden.

Beispiel

Das folgende Beispiel zeigt, wie Sie diese Aktionen durchführen:

  • Leiten Sie Salesforce-E-Mails an Agenten in einer bestimmten Warteschlange weiter, denen bestimmte Fähigkeiten und Sprachen zugewiesen sind.
  • Pop-up-Bildschirm einer bestimmten Salesforce-Seite.
  • Fügen Sie eine Fallnummer zu den Interaktionsdetails hinzu.
  • Fügen Sie eine Remote-E-Mail-Adresse zu den Aktivitätsdatensätzen in Salesforce hinzu.

Hinweis: Da CaseNumber und contactEmailAddress benutzerdefinierte Attribute sind, müssen Sie zunächst Participant hinzufügen.{CustomFieldName} zu den Abschnitten Interaktionsdetails anpassen und Aktivitätsfeldzuordnung unter Client-Einstellungen. Weitere Informationen zu den Client-Einstellungen finden Sie unter Verwaltete Paketeinstellungen

Interaktionsdetails mit Apex-Code

String[] skills = new List<String>();
skills.add('Warranties');
skills.add('Cellphone repair');

String language = 'English - Spoken';

Map<String, Object> attributes = new Map<String, Object>();
attributes.put('SF_URLPop', '500360000015OCJ');
attributes.put('CaseNumber', 'Case: 000149');
attributes.put('contactEmailAddress', 'john.smith@customer.com');

purecloud.SDK.Email.create('CustomerService', skills, language, attributes);

Instanziiert purecloud.Email Objekte Siehe die Registerkarte purecloud.Email

E-Mail-Klasse

Stellt eine Genesys Cloud E-Mail-Interaktion dar. Enthält Methoden zur Weiterleitung von Salesforce-E-Mails durch Genesys Cloud for Salesforce.

Namespace

purecloud.Email

Verwendung

Verwenden Sie diese Methoden, um Genesys Cloud E-Mail-Objekte zu erstellen. Diese Objekte können Daten zum Einstellen von Popup-Fenstern, zum Ändern von Interaktionsdetails oder zum Hinzufügen von Daten zu den Aktivitätsdatensätzen in Salesforce enthalten. Diese Objekte können auch Informationen über den Betreff, den Absendernamen und die Absenderadresse enthalten.

E-Mail-Methoden

Die folgenden Methoden sind für die Klasse Email verfügbar.

Erzeugt eine Genesys Cloud Interaktion mit definierten Instanzattributen. 

Eigenschaften

Name Datentyp Beschreibung Notizen
Warteschleife Zeichenkette Warteschlange in Ihrer Genesys Cloud-Organisation, an die die Integration Salesforce-E-Mails weiterleiten soll. Entspricht Call.QueueName in den Interaktionsdetails.
Skills Liste<String> Liste der Fähigkeiten in Ihrer Genesys Cloud Organisation.  Assoziiert mit Agenten, die Salesforce-E-Mails erhalten sollen.
Sprache Zeichenkette Sprachkenntnisse in Ihrer Genesys Cloud Organisation.  Assoziiert mit Agenten, die Salesforce-E-Mails erhalten sollen.
Attribute Karte<String, Object=""> Siehe Attribute Map.
Betreff Zeichenkette Betreffzeile der E-Mail für die aktive Interaktion. Wird zu den Interaktionsdetails hinzugefügt, wenn eine Interaktionswarnung vorliegt. Entspricht Email.Subject in den Interaktionsdetails.
Name des Absenders Zeichenkette Remote-Name für die aktive Interaktion. Wird zu den Interaktionsdetails hinzugefügt, wenn eine Interaktionswarnung vorliegt. Entspricht Call.RemoteName in den Interaktionsdetails.
Absenderadresse Zeichenkette Die Remote-E-Mail-Adresse für die aktive Interaktion. Wird zu den Interaktionsdetails hinzugefügt, wenn eine Interaktionswarnung vorliegt. Entspricht Salesforce.DisplayAddress in den Interaktionsdetails.

Attribute Karte

Eine Zuordnung von Attributen, die eine Salesforce-Seite oder ein Suchergebnis enthalten können, oder Daten, die zu den Interaktionsdetails oder Aktivitätsdatensätzen in Salesforce hinzugefügt werden.

Parameter

Schlüssel Art Erforderlich oder optional Beschreibung Notizen
SF_URLPop Zeichenkette Optional ID der Salesforce-Seite, die bei einer Interaktionswarnung angezeigt werden soll. Verwenden Sie entweder SF_URLPop oder SF_SearchValue, nicht beide. Für eine schnellere Verarbeitung von Screenpops verwenden Sie SF_URLPop.
SF_SearchValue Zeichenkette Optional ID des Salesforce-Suchergebnisses, das bei einer Interaktionswarnung angezeigt werden soll. Verwenden Sie entweder SF_URLPop oder SF_SearchValue, nicht beide. Für eine schnellere Verarbeitung von Screenpops verwenden Sie SF_URLPop.
Benutzerdefiniertes Attribut String, Ganzzahl, Boolescher Wert Optional Daten, die zu Interaktionsdetails oder Aktivitätsaufzeichnungen hinzugefügt werden, wenn Interaktionswarnungen

Beispiele

Die folgenden Beispiele zeigen, wie ein E-Mail-Objekt erstellt wird und wie Eigenschaften verwendet werden, um diese Aktionen durchzuführen:

  • Leiten Sie Salesforce-E-Mails an Agenten in einer bestimmten Warteschlange weiter, denen Fähigkeiten und Sprachen zugewiesen sind, oder leiten Sie Salesforce-E-Mails an Agenten weiter, die einen eingehenden Architect-E-Mail-Fluss mit zugewiesenen Fähigkeiten und Sprachen verwenden.
  • Pop-up-Bildschirm einer bestimmten Salesforce-Seite.
  • Fügen Sie eine Fallnummer zu den Interaktionsdetails hinzu.
  • Fügen Sie eine Remote-E-Mail-Adresse zu den Aktivitätsdatensätzen in Salesforce hinzu.
  • Fügen Sie die Eigenschaften subject, fromName und fromAddress zu den Interaktionsdetails hinzu.

Hinweis: Da CaseNumber und contactEmailAddress benutzerdefinierte Attribute sind, müssen Sie zunächst Participant hinzufügen.{CustomFieldName} zu den Abschnitten Interaktionsdetails anpassen und Aktivitätsfeldzuordnung unter Client-Einstellungen. Weitere Informationen zu den Client-Einstellungen finden Sie unter Verwaltete Paketeinstellungen

Interaktionsdetails mit Apex-Code

Beispiel für die Verwendung einer Warteschlange zur Weiterleitung von Salesforce-E-Mails

String[] skills = new List<String>();
skills.add('Warranties');
skills.add('Cellphone repair');

Map<String, Object> attributes = new Map<String, Object>();
attributes.put('SF_URLPop', '500360000015OCJ');
attributes.put('CaseNumber', 'Case: 000149');
attributes.put('contactEmailAddress', 'john.smith@customer.com');

purecloud.Email email = purecloud.SDK.Email.create();
email.queue = 'CustomerService';
email.skills = skills;
email.language = 'English - Spoken';
email.attributes = attributes;
email.subject = 'Warranty Question'; 
email.fromName = 'John Smith'; 
email.fromAddress = 'john.smith@customer.com'; 
email.create();

Beispiel für die Verwendung eines eingehenden E-Mail-Flusses zur Weiterleitung von Salesforce-E-Mails

Map<String, Object> attributes = new Map<String, Object>();
attributes.put('SF_URLPop', '500360000015OCJ');
attributes.put('CaseNumber', 'Case: 000149');
attributes.put('contactEmailAddress', 'john.smith@customer.com');

purecloud.Email email = purecloud.SDK.Email.create();
email.flow = 'RouteEmails';
email.attributes = attributes;
email.subject = 'Warranty Question'; 
email.fromName = 'John Smith'; 
email.fromAddress = 'john.smith@customer.com'; 
email.create();

Weitere Informationen finden Sie unter Konfigurieren Sie die Weiterleitung von Salesforce-E-Mails, Verwenden Sie Flow Builder, um Salesforce-E-Mails weiterzuleiten, und Über die Weiterleitung von Salesforce-E-Mails

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