Utilisez le SDK Salesforce pour acheminer les emails

Remarque :  Cet article s’applique à Genesys Cloud for Salesforce.

Après avoir configuré le routage des emails Salesforce dans Salesforce, utilisez notre SDK dans le package géré pour acheminer les emails Salesforce via PureCloud pour Salesforce. Le SDK Salesforce utilise le langage de programmation Apex. 

Remarque :  Cet article de personnalisation avancée est destiné aux développeurs familiarisés avec Salesforce.

Conditions préalables

Accédez à notre SDK via la classe Email sous le et purecloud.Email espaces de noms. Utilisez l’espace de noms purecloud.Email pour définir les informations relatives à subject, fromName et fromAddress.

Classe email

Contient des méthodes statiques pour router les emails Salesforce via PureCloud pour Salesforce.

Espace de noms

purecloud.SDK.Email

Utilisation

Utilisez ces méthodes pour créer des objets de messagerie PureCloud qui acheminent les courriers électroniques Salesforce via PureCloud pour Salesforce. Ces objets peuvent contenir des données pour créer des fenêtres contextuelles, modifier les détails de l’interaction ou ajouter des données aux enregistrements d’activité dans Salesforce.

Méthodes de messagerie

Les méthodes suivantes sont disponibles pour la classe Email.

Achemine une interaction par courrier électronique vers une file d’attente spécifiée et un écran ouvre une page Salesforce spécifiée.

Paramètres

Nom Type de données Description Notes
file Chaîne File d'attente dans votre organisation Genesys Cloud vers laquelle vous souhaitez acheminer les e-mails Salesforce. Mappe sur Call.QueueName dans les détails de l’interaction.
sfUrlPopValue Chaîne ID de la page Salesforce que vous souhaitez utiliser pour fenêtre contextuelle lors d’une alerte d’interaction

Exemple

L'exemple suivant montre comment effectuer ces actions :

  • Achemine les courriels Salesforce vers une file d’attente spécifiée.
  • La page contextuelle Salesforce apparaît.

Détails de l’interaction à l’aide du code Apex

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

Salesforce emails Salesforce vers les agents dans une file d’attente spécifiée auxquels sont attribuées des compétences et une langue spécifiées dans votre organisation Genesys Cloud, et utilise le paramètre attributes pour effectuer des actions.

Paramètres

Nom Type de données Description Notes
file Chaîne File d’attente dans votre organisation Genesys Cloud laquelle vous souhaitez que l’intégration achemine les emails Salesforce. Mappe sur Call.QueueName dans les détails de l’interaction.
compétences Liste<String> Liste des compétences de votre organisation Genesys Cloud.  Associé aux agents avec lesquels vous souhaitez recevoir des e-mails Salesforce.
Langue Chaîne compétence linguistique dans votre organisation Genesys Cloud.  Associé aux agents avec lesquels vous souhaitez recevoir des e-mails Salesforce.
attributs Carte<String, Object=""> Voir Carte des attributs.

Onglet attributs

La propriété attributs est une carte d’attributs pouvant inclure une page Salesforce ou un résultat rechercher, ou des données à ajouter aux détails de l’interaction ou aux enregistrements d’activité dans SalesforceYTY.

Paramètres

Clé Type Obligatoire / facultatif Description Notes
SF_URLPop Chaîne Facultatif ID de la page Salesforce que vous souhaitez utiliser pour fenêtre contextuelle lors d’une alerte d’interaction Utilisez soit SF_URLPop ou SF_SearchValue, pas les deux. Pour un traitement plus rapide des sauts d’écran, utilisez SF_URLPop.
SF_SearchValue Chaîne Facultatif ID du résultat Salesforce recherche que vous souhaitez utiliser pour fenêtre contextuelle lors d’une alerte d’interaction Utilisez soit SF_URLPop ou SF_SearchValue, pas les deux. Pour un traitement plus rapide des sauts d’écran, utilisez SF_URLPop.
{attribut} personnalisé chaîne, entier, booléen Facultatif Données ajoutées aux détails de l’interaction ou aux enregistrements d’activité lorsque des alertes d’interaction

Exemple

L'exemple suivant montre comment effectuer ces actions :

  • Acheminez les emails Salesforce aux agents de la file d’attente spécifiés auxquels des compétences et une langue sont affectées.
  • La page contextuelle Salesforce apparaît.
  • Ajoutez un numéro de dossier aux détails de l’interaction.
  • Ajoutez une adresse électronique distante aux enregistrements d’activité dans Salesforce.

Remarque :   Remarque: CaseNumber et contactEmailAddress étant des attributs personnalisés, vous devez d’abord ajouter le participant. {CustomFieldName} dans les sections Personnaliser les détails d’interaction et le mappage de champs d’activité sous Paramètres du client. Pour plus d’informations sur les paramètres du client, voir Paramètres du package géré

Détails de l’interaction à l’aide du code Apex

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);

Instancie les objets purecloud.Email. Voir l’onglet purecloud.Email. 

Classe email

Représente une interaction par e Genesys Cloud mail Genesys Cloud. Contient des méthodes pour acheminer les emails Salesforce via Genesys Cloud for Salesforce.

Espace de noms

purecloud.Email

Utilisation

Utilisez ces méthodes pour créer des objets de messagerie Genesys Cloud. Ces objets peuvent contenir des données pour créer des fenêtres contextuelles, modifier les détails de l’interaction ou ajouter des données aux enregistrements d’activité dans Salesforce. Ces objets peuvent également définir des informations pour subject, fromName et fromAddress.

Méthodes de messagerie

Les méthodes suivantes sont disponibles pour la classe Email.

Crée une interaction Genesys Cloud avec des attributs d’instance définis. 

Propriétés

Nom Type de données Description Notes
file Chaîne File d’attente dans votre organisation Genesys Cloud laquelle vous souhaitez que l’intégration achemine les emails Salesforce. Mappe sur Call.QueueName dans les détails de l’interaction.
compétences Liste<String> Liste des compétences de votre organisation Genesys Cloud.  Associé aux agents avec lesquels vous souhaitez recevoir des e-mails Salesforce.
Langue Chaîne compétence linguistique dans votre organisation Genesys Cloud.  Associé aux agents avec lesquels vous souhaitez recevoir des e-mails Salesforce.
attributs Carte<String, Object=""> Voir Carte des attributs.
objet Chaîne Ligne d'objet de l'e-mail pour l'interaction active. Ajouté aux détails de l'interaction lorsqu'une interaction alerte. Maps to Email.Subject dans les détails de l’interaction.
fromName Chaîne Nom distant pour l’interaction active. Ajouté aux détails de l'interaction lorsqu'une interaction alerte. Mappe sur Call.QueueName dans les détails de l’interaction.
de l’adresse Chaîne L'adresse e-mail distante pour l'interaction active. Ajouté aux détails de l'interaction lorsqu'une interaction alerte. Mappe vers Salesforce.DisplayAddress dans les détails de l’interaction.

Onglet attributs

La propriété attributs est une carte d’attributs pouvant inclure une page Salesforce ou un résultat rechercher, ou des données à ajouter aux détails de l’interaction ou aux enregistrements d’activité dans SalesforceYTY.

Paramètres

Clé Type Obligatoire / facultatif Description Notes
SF_URLPop Chaîne Facultatif ID de la page Salesforce que vous souhaitez utiliser pour fenêtre contextuelle lors d’une alerte d’interaction Utilisez soit SF_URLPop ou SF_SearchValue, pas les deux. Pour un traitement plus rapide des sauts d’écran, utilisez SF_URLPop.
SF_SearchValue Chaîne Facultatif ID du résultat Salesforce recherche que vous souhaitez utiliser pour fenêtre contextuelle lors d’une alerte d’interaction Utilisez soit SF_URLPop ou SF_SearchValue, pas les deux. Pour un traitement plus rapide des sauts d’écran, utilisez SF_URLPop.
{attribut} personnalisé chaîne, entier, booléen Facultatif Données ajoutées aux détails de l’interaction ou aux enregistrements d’activité lorsque des alertes d’interaction

Exemples

Ces exemples montrent comment créer un objet de courrier électronique et utiliser des propriétés pour effectuer les actions suivantes :

  • Acheminez les emails Salesforce aux agents de la file d’attente spécifiés auxquels des compétences et des langues sont attribuées, ou acheminez des emails Salesforce aux agents à l’aide d’un flux de messagerie entrant Architect doté des compétences et des langues attribuées.
  • La page contextuelle Salesforce apparaît.
  • Ajoutez un numéro de dossier aux détails de l’interaction.
  • Ajoutez une adresse électronique distante aux enregistrements d’activité dans Salesforce.
  • Ajoutez les propriétés subject, fromName et fromAddress aux détails de l’interaction.

Remarque :   Remarque: CaseNumber et contactEmailAddress étant des attributs personnalisés, vous devez d’abord ajouter le participant. {CustomFieldName} dans les sections Personnaliser les détails d’interaction et le mappage de champs d’activité sous Paramètres du client. Pour plus d’informations sur les paramètres du client, voir Paramètres du package géré

Détails de l’interaction à l’aide du code Apex

Exemple d’utilisation de la file d’attente pour acheminer des emails Salesforce

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();

Exemple d’utilisation d’un flux de messagerie entrant pour acheminer des emails Salesforce

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();

Pour plus d'informations, voir Configurer le routage des e-mails Salesforce, Utiliser Flow Builder pour router les e-mails Salesforce, et À propos du routage des e-mails Salesforce

Pour plus d’informations sur l’intégration, consultezÀ propos de Genesys Cloud for Salesforce.