Utilisez le SDK Salesforce pour acheminer les emails
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.
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.
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.
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.
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.
