Événements à Salesforce

Pour plus d’informations, consultez Événements par type d’abonnement ( Genesys Cloud Developer Center) dans la documentation Genesys Cloud Embeddable Framework.

Les administrateurs configurent les paramètres du centre d’appels pour que l’intégration soit déclenchée et à l’écoute des événements.

1. Dans Salesforce, cliquez sur Installer.
2. Rechercher Paquets installés.
3. Sous Construire, cliquez sur Paquets installés.
4. Sur le Packages installés page, cliquez surConfigurer à côté du package Genesys Cloud for Salesforce.
5. Sous Paramètres d'événement client, configurez les éléments suivants pour Messages d'événement client:
6. Pour Type de message d'événement client, sélectionnez API Window.postMessage.

   Ce paramètre force l’intégration à déclencher un événement de prise de contact à chaque chargement du client. 

7. (Facultatif) Sous Types d’événement client, sélectionnez d’autres événements (Interaction, Notification et UserAction) auxquels vous souhaitez vous abonner. Cliquez sur flèche  pour les ajouter sous Choisi.
8. (Facultatif) Sélectionnez Développer Notification de chat pour recevoir une charge utile étendue pour les événements de notification de discussion.
9. Cliquez sur sauvegarder. 

Pour plus d’informations, voir Configurer les paramètres du centre d’appels.

Le client Genesys Cloud for Salesforce expose les actions suivantes déclenchées via les API Web postMessage.

• addAssociation
• Interaction.addCustomAttributes
• Interaction.createConference
• Interaction.updateState
• User.updateStatus
• s'abonner

addAssociation

Ajoute un nouveau contact ou une nouvelle association de relations aux journaux d'interactions.

Paramètres

objet de données

Définit l'action.

Paramètres

Exemples

Dans cet exemple, l'intégration ajoute une nouvelle association de contact avec l'ID 1234 et le nom affiché John Smith à une interaction.

{ 
  "type": "PureCloud.addAssociation",  
  "data": { 
      "type": "contact", 
      "id": "1234", 
      "text": "John Smith"
   } 
}

Interaction.addCustomAttributes

Ajoute des attributs personnalisés aux interactions.

Paramètres

objet de données

Définit l'action.

Paramètres

Exemple

{
    "type": "PureCloud.Interaction.addCustomAttributes", 
    "data": {
        "id": "1234-1234-1234-1234",
        "attributes": {
            "record_url": "/0000413456"
        }
    }
}

Interaction.createConference

Crée une conférence à partir de plusieurs interactions.

Paramètres

objet de données

Définit l'action.

Paramètres

Exemple

{
    "type": "PureCloud.Interaction.createConference", 
    "data": {
        "interactionIds": [
            "9641cedc-4cc2-48e1-84f7-fc4xxxx513e8",
            "5eafbfc4-6ff4-40e4-a2d7-dxxxxxxxx809", 
            "363ba2ca-xxxx-405e-bebe-fc59b1ae517b"
         ]
    }
}

Interaction.updateState

Met à jour l'état d'une interaction.

Paramètres

objet de données

Définit l'action.

Paramètres

objet participantContext

Définit l'entité recevant le transfert.

Paramètres

Objet secureSessionContext

Définit l'entité recevant le transfert.

Paramètres

Exemples

L'exemple suivant montre une interaction transférée à un agent ou à une file d'attente sans consultation.

{
    "type": "PureCloud.Interaction.updateState", 
    "data": {
        "action": "blindTransfer",
        "id": "1234-1234-1234-1234",
        "participantContext": {
            "transferTarget": "3175550123",
            "transferTargetType": "address"
        }
    }
}

L'exemple suivant montre une interaction transférée vers un flux IVR sécurisé.

{
    "type": "PureCloud.Interaction.updateState", 
    "data": {
        "action": "secureSession",
        "id": "1234-1234-1234-1234",
        "secureSessionContext": {
            "flowId": "741f4f39-7a94-470d-a1dd-dd68d01e0dd8",
            "userData": "hello",
            "disconnect": false,
        }
    }
}

User.updateStatus

Mises à jour utilisateur statut.

Paramètres

objet de données

Définit l'action.

Paramètres

Exemple

{
    "type": "PureCloud.User.updateStatus", 
    "data": {
        "id": "1234-1234-1234-1234"
    }
} 

s'abonner

S'abonner aux événements des clients.

Paramètres

objet de données

Définit l'action.

Paramètres

Événements par type d'abonnement

Exemple

{
 "type": "PureCloud.subscribe",
 "data": {
     "type": "Notification",
     "categories": ["interactionSelection", "chatUpdate", "interactionWindow", "conversationTranscription"]
  }
}

Créez un composant d’éclairage afin que Salesforce puisse écouter et déclencher les événements sélectionnés dans les paramètres du centre d’appels. 

1. Ajoutez des fichiers Apex, de composant et JavaScript à la console développeur dans Salesforce.

   Vous pouvez télécharger des exemples de fichiers à partir du PureCloud pour Salesforce Einstein Exemple référentiel dans GitHub.

   Pour plus d’informations, voir Menu Fichier de la console développeur dans la documentation Salesforce.

2. Met le type et identifiant pour la source dans le fichier JavaScript.

   Ce paramètre vous permet de modifier les statuts du client.

   source.postMessage({
       type: 'PureCloud.User.updateStatus',
       data: { id: status },
   }

3. Si votre administrateur a configuré l’intégration pour déclencher des événements Interaction, Notification ou UserActions, abonnez-vous à ces événements dans le fichier JavaScript.

   Pour plus d’informations, consultez le souscrire méthode dans le Framework intégrable dans le Genesys Cloud documentation ( Genesys Cloud Developer Center).

Pour plus d’informations, consultez Événements par type d’abonnement ( Genesys Cloud Developer Center) dans la documentation Genesys Cloud Embeddable Framework.

Les administrateurs configurent les paramètres du centre d’appels pour que l’intégration soit déclenchée et à l’écoute des événements.

1. Dans Salesforce, cliquez sur Installer.
2. Rechercher Paquets installés.
3. Sous Construire, cliquez sur Paquets installés.
4. Sur le Packages installés page, cliquez surConfigurer à côté du package Genesys Cloud for Salesforce.
5. Sous Paramètres d'événement client, configurez les éléments suivants pour Messages d'événement client:
6. Pour Type de message d'événement client, sélectionnez Canal de message éclair. 
   

   Ce paramètre permet à l'intégration d'envoyer des messages sur le canal de message. 

7. (Facultatif) Sous Types d’événement client, sélectionnez d’autres événements (Interaction, Notification et UserAction) auxquels vous souhaitez vous abonner. Cliquez sur flèche  pour les ajouter sous Choisi.
8. (Facultatif) Sélectionnez Développer Notification de chat pour recevoir une charge utile étendue pour les événements de notification de discussion.
9. Cliquez sur sauvegarder. 

Pour plus d’informations, voir Configurer les paramètres du centre d’appels.

Le client Genesys Cloud for Salesforce expose les actions suivantes déclenchées via Lightning Message Service.

• addAssociation
• Interaction.addCustomAttributes
• Interaction.createConference
• Interaction.updateState
• User.updateStatus
• s'abonner

addAssociation

Ajoute un nouveau contact ou une nouvelle association de relations aux journaux d'interactions.

Paramètres

objet de données

Définit l'action.

Paramètres

Exemples

Dans cet exemple, l'intégration ajoute une nouvelle association de contact avec l'ID 1234 et le nom affiché John Smith à une interaction.

{ 
  "type": "PureCloud.addAssociation",  
  "data": { 
      "type": "contact", 
      "id": "1234", 
      "text": "John Smith"
   } 
}

Interaction.addCustomAttributes

Ajoute des attributs personnalisés aux interactions.

Paramètres

objet de données

Définit l'action.

Paramètres

Exemple

{
    "type": "PureCloud.Interaction.addCustomAttributes",
    "data": {
        "id": "1234-1234-1234-1234",
        "attributes": {
            "record_url": "/0000413456"
        }
    }
}

Interaction.createConference

Crée une conférence à partir de plusieurs interactions.

Paramètres

objet de données

Définit l'action.

Paramètres

Exemple

{
    "type": "PureCloud.Interaction.createConference", 
    "data": {
        "interactionIds": [
            "9641xxxx-4bb2-xxxx-84f7-xxxxxx8513e8",
            "5eafbfc4-6ff4-xxxx-a2d7-d23c1abbd809", 
            "363ba2ca-xxxx-405e-bebe-fc59xxxxx17b"
         ]
    }
}

Interaction.updateState

Met à jour l'état d'une interaction.

Paramètres

objet de données

Définit l'action.

Paramètres

objet participantContext

Définit l'entité recevant le transfert.

Paramètres

Objet secureSessionContext

Définit l'entité recevant le transfert.

Paramètres

Exemples

L'exemple suivant montre une interaction transférée à un agent ou à une file d'attente sans consultation.

{
    "type": "PureCloud.Interaction.updateState", 
    "data": {
        "action": "blindTransfer",
        "id": "1234-1234-1234-1234",
        "participantContext": {
            "transferTarget": "3175550123",
            "transferTargetType": "address"
        }
    }
}

L'exemple suivant montre une interaction transférée vers un flux IVR sécurisé.

{
    "type": "PureCloud.interaction.updateState", 
    "data": {
        "action": "secureSession",
        "id": "1234-1234-1234-1234",
        "secureSessionContext": {
            "flowId": "741f4f39-7a94-470d-a1dd-dd68d01e0dd8",
            "userData": "hello",
            "disconnect": false,
        }
    }
}

User.updateStatus

Mises à jour utilisateur statut.

Paramètres

objet de données

Définit l'action.

Paramètres

Exemple

{
    "type": "PureCloud.User.updateStatus",
    "data": {
        "id": "1234-1234-1234-1234"
    }
} 

s'abonner

S'abonner aux événements des clients.

Paramètres

objet de données

Définit l'action.

Paramètres

Événements par type d'abonnement

Exemple

{
 "type": "PureCloud.subscribe",
 "data": {
     "type": "Notification",
     "categories": ["interactionSelection", "chatUpdate", "interactionWindow", "conversationTranscription"]
  }
}

Pour vous abonner au canal de messages, installez la version 3.12 ou version ultérieure du package géré PureCloud pour Salesforce. Ces versions de le package géré comprend le purecloud__ClientEvent__c canal qui reçoit tous les messages. Après vous être abonné à purecloud__ClientEvent__c, Salesforce peut écouter et déclencher les événements sélectionnés dans les paramètres du centre d'appels. 

La méthode de mise en œuvre varie en fonction des composants que vous utilisez. L'exemple de code suivant montre comment utiliser LMS avec un composant Lightning Aura.

Abonnez-vous aux messages Lightning sur le purecloud__ClientEvent__c canal pour un composant Aura.

<lightning:messageChannel type="purecloud__ClientEvent__c" aura:id="clientEventMessageChannel" onMessage="{!c.onClientEvent}" scope="APPLICATION"/>

Pour recevoir des messages Lightning, créez un onClientEvent.

({
    onClientEvent: function (component, message, helper) {
        var eventData = message.getParams();
        if (eventData) {
            if(eventData.type === 'Interaction' && eventData.data.id) {
		console.log(‘Interaction ID: ‘ + eventData.data.id);
            }
        }
    }
})

Pour envoyer des messages Lightning, publiez les événements que le client Genesys Cloud for Salesforce écoute. Pour une liste des événements, consultez le Communicate avec Genesys Cloud for Salesforce section.

component.find('clientEventMessageChannel').publish({
    type: 'PureCloud.User.updateStatus',
    data: { id: status }
});

Pour d'autres exemples, voir Service de messagerie Lightning [Aperçu développeur] dans le blog des développeurs Salesforce.