Connecteur d’entrée Salesforce

À propos du connecteur entrant Salesforce

Vous pouvez utiliser le connecteur entrant Salesforce pour charger les données de reporting opérationnel de votre compte Salesforce dans XM Discover.

Configuration requise dans Salesforce

Pour connecter XM Discover à Salesforce, vous aurez besoin des informations suivantes concernant votre compte Salesforce :

• Votre clé consommateur Salesforce (ID client)
• Votre clé secrète consommateur Salesforce (clé secrète client)
• Votre nom d’utilisateur et mot de passe Salesforce
• URL organisation Salesforce
• Une requête SOQL (Salesforce Object Query Language) valide pour récupérer les interactions de feedback ou de discussion en direct
  Astuce Qualtrics : SOQL vous permet de rechercher des informations spécifiques dans les données Salesforce de votre organisation. SOQL est similaire à l’instruction “SELECT” dans le langage SQL (Structured Query Language), mais il est conçu spécifiquement pour les données Salesforce. Pour une présentation de SOQL, voir cette page d’aide Salesforce.

En outre, vous devez effectuer les opérations suivantes dans votre compte Salesforce :

1. Dans votre application connectée, sélectionnez Activer les options OAuth. Voir cette page d’aide Salesforce pour plus d’informations.
2. Définissez le URL de rappel au : https://data.us1.qualtrics.io/connectors?token_type=salesforce
3. Sélectionnez les éléments suivants : Périmètres OAuth:
   • Accéder aux autorisations personnalisées (custom_permissions)
   • Accéder aux identifiants utilisateur uniques (openid)
   • Accès complet (complet)
   • Gérer les données utilisateur via des API (API)
   • Exécuter des demandes à tout moment (freshh_token, offline_access)
   • Assurez-vous que PKCE n’est pas activé.
4. Dans la même carte connectée, sélectionnez Gérer les stratégies d’accès OAuth. Voir cette page d’aide Salesforce pour plus d’informations.
5. Sélectionnez les options suivantes :
   • Utilisateur autorisé: tous les utilisateurs peuvent s’auto-autoriser.
   • Actualiser la stratégie de jeton: le jeton d’actualisation est valide jusqu’à sa révocation.

Configuration d’un job entrant Salesforce

1. Sur la page Tâches, cliquez sur Nouveau job.
   
2. Sélectionnez Salesforce.
   
3. Donnez un nom à votre job pour pouvoir l’identifier.
   
4. Sélectionnez le projet dans lequel charger les données.
5. Donnez une description de votre travail pour connaître son objectif.
6. Cliquez sur Suivant.
7. Choisissez un compte Salesforce à utiliser ou sélectionnez Ajouter nouveau pour en ajouter un nouveau.
8. Si vous ajoutez un nouveau compte, saisissez les informations suivantes concernant votre compte Salesforce :
   • Nom de la connexion: donnez un nom à la connexion pour que vous puissiez l’identifier.
   • ID client Salesforce: votre clé consommateur Salesforce.
   • Clé secrète client Salesforce: votre secret consommateur Salesforce
   • Environnement Salesforce: URL de organisation Salesforce
   • Environnement de test: si vous vous connectez à un environnement de test, activez cette option.
9. Cliquez sur Autoriser.
10. Si vous souhaitez que vos références d’identification expirent, configurez les options suivantes :
    
    • Envoyer des notifications d’expiration: sélectionnez cette option pour autoriser l’expiration de vos identifiants.
    • Jours avant expiration: si vous activez les notifications d’expiration, saisissez le nombre de jours pendant lesquels vous souhaitez recevoir une notification avant l’expiration. Vous pouvez saisir une valeur comprise entre 1 et 100 jours.
    • Date d’expiration : définissez la date à laquelle les identifiants expireront. Cliquez sur la case pour ouvrir un calendrier afin de choisir la date.
11. Cliquez sur Suivant.
12. Choisissez le type d’avis à télécharger depuis Salesforce :
    
    • Avis Salesforce: Chargez des commentaires réguliers.
    • Discussion en direct Salesforce: chargez les interactions agent/client à partir de la discussion en direct Salesforce.
    • Salesforce SMS Text : Chargez les interactions agent/client à partir de Salesforce LiveMessage.
13. Si chargement en cours Discussion en direct Salesforce, sélectionnez la manière dont les agents et les clients sont identifiés :
    • Détection automatique: détectez automatiquement les agents, les assistants de discussion en direct et les visiteurs.
    • Le premier participant est un agent: le premier participant à la discussion en direct sera affecté en tant qu’agent.
    • Le premier participant est un client: le deuxième participant à la discussion en direct sera affecté en tant qu’agent.
14. Sélectionnez le Version API que vous souhaitez utiliser.
15. Saisissez un(e) instruction SOQL personnalisée pour limiter les données extraites de Salesforce.
    
    Astuce Qualtrics : Pour récupérer les données de discussion en direct, utilisez l’objet LiveChatTranscript dans la requête.
    Attention : GROUP BY n’est pas pris en charge.
    Exemple : SELECT Id, CreatedDate, Body, ChatDuration FROM LiveChatTranscript.
16. Cliquez sur Valider Requête pour tester votre instruction SOQL.
17. Si la validation a réussi, sélectionnez zone de date utilisé pour identifier les données à récupérer.
    Astuce Qualtrics : Cette liste contient uniquement les zones présentes dans votre requête SOQL.
18. Cliquez sur Suivant
19. Si nécessaire, ajustez vos mappages de données. Consultez la page d’assistance Mappage des données pour en savoir plus sur le mappage des champs dans XM Discover. Le Section Mappage de données par défaut contient des informations sur les champs spécifiques à ce connecteur et Mappage des champs conversationnels La section explique comment mapper des données pour des données conversationnelles.
    
20. Cliquez sur Suivant.
21. Si vous le souhaitez, vous pouvez ajouter des règles de substitution et de rédaction des données pour masquer les données sensibles ou remplacer automatiquement certains mots et expressions dans les commentaires et interactions des clients. Voir le Page d’assistance sur la substitution et la reproduction des données.
    Astuce Qualtrics : Cliquez sur Télécharger des Échantillon de données pour télécharger un fichier Excel avec des échantillon de données sur votre ordinateur.
22. Cliquez sur Suivant.
23. Si vous le souhaitez, vous pouvez ajouter un filtre de connecteur pour filtrer les données entrantes afin de limiter les données importées.
    
24. Vous pouvez également limiter le nombre d’enregistrements importés dans un seul job en saisissant un nombre dans la zone Spécifier la limite d’enregistrement. Saisissez « Tout » si vous souhaitez importer tous les enregistrements.
    Astuce Qualtrics : pour les données conversationnelles, la limite est appliquée en fonction des conversations plutôt que des lignes.
25. Cliquez sur Suivant.
26. Choisissez quand vous souhaitez recevoir une notification. Pour plus d’informations, voir Notifications de jobs.
    
27. Cliquez sur Suivant.
28. Sélectionnez le mode de traitement des documents en double. Pour plus d’informations, voir Traitement des doublons.
    
29. Sélectionnez Planifier exécutions incrémentielles si vous souhaitez que votre job s’exécute périodiquement selon une planification ou Configurer exécution unique si vous souhaitez que le job soit exécuté une seule fois. Pour plus d’informations, voir Planification des jobs.
30. Cliquez sur Suivant.
31. Vérifiez votre configuration. Si vous devez modifier un paramètre spécifique, cliquez sur le bouton Modifier pour accéder à cette étape dans la configuration du connecteur.
32. Cliquez sur Terminer pour sauvegarder le job.

Mappage de données par défaut

Cette section contient des informations sur les champs par défaut pour les tâches entrantes Salesforce.

• natural_id : identifiant unique d’un document. Il est fortement recommandé d’avoir un ID unique pour chaque document afin de traiter correctement les doublons. Pour ID naturel, vous pouvez sélectionner n’importe quelle zone de texte ou zone numérique à partir de vos données. Vous pouvez également générer automatiquement des ID en ajoutant une zone personnalisée.
• document_date : champ de date principal associé à un document. Cette date est utilisée dans les rapports XM Discover, les tendances, les alertes, etc. Par défaut, il est mappé sur la zone de date sélectionnée après avoir indiqué la requête SOQL. Vous pouvez sélectionner l’une des options suivantes :
  • CreatedDate (par défaut): date à laquelle l’objet Salesforce a été créé.
  • ClosedDate (pour les données de discussion en direct): date à laquelle le cas a été clôturé.
  • Si vos données source contiennent d’autres zones de date, vous pouvez en sélectionner une.
  • Vous pouvez également définir une date de document spécifique.
• feedback_provider : identifie les données obtenues auprès d’un fournisseur spécifique. Pour les téléchargements Salesforce, la valeur de cet attribut est définie sur « Salesforce » et ne peut pas être modifiée.
• source_value : identifie les données obtenues à partir d’une source spécifique. Il peut s’agir de tout ce qui décrit l’origine des données, comme le nom d’une enquête ou d’une campagne marketing mobile. Par défaut, la valeur de cet attribut est définie sur « Salesforce ». Utilisez les transformations personnalisées pour définir une valeur personnalisée, définir une expression ou la mapper à une autre zone.
• feedback_type : identifie les données en fonction de leur type. Cela est utile pour le reporting lorsque votre projet contient différents types de données (par exemple, des enquêtes et des commentaires sur les médias sociaux). Par défaut, la valeur de cet attribut est définie sur « Reporting opérationnel ». Utilisez les transformations personnalisées pour définir une valeur personnalisée, définir une expression ou la mapper à une autre zone.
• job_name : identifie les données en fonction du nom du job utilisé pour le charger. Vous pouvez modifier la valeur de cet attribut lors de la configuration via le champ Nom de la tâche qui est affiché en haut de chaque page pendant la configuration.
• loadDate : indique quand un document a été chargé dans XM Discover. Cette zone est définie automatiquement et ne peut pas être modifiée.