Modèle d’article

À propos du connecteur Salesforce Inbound

Vous pouvez utiliser le connecteur entrant Salesforce pour charger les données de rapports opérationnels 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é de consommateur Salesforce (identifiant du client)
• Votre secret de consommateur Salesforce (secret du client)
• Votre nom d’utilisateur et votre mot de passe Salesforce
• L’URL de l’environnement de votre organisation Salesforce
• Une requête Salesforce Object Query Language (SOQL) valide pour récupérer les commentaires ou les interactions de chat
  Astuce : SOQL vous permet de rechercher des informations spécifiques dans les données Salesforce de votre organisation. SOQL est similaire à l’instruction “SELECT” du langage de requête structuré (SQL) largement utilisé, mais il est conçu spécifiquement pour les données Salesforce. Pour une introduction à SOQL, veuillez consulter cette page d’aide de Salesforce.

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

1. Dans votre application connectée, sélectionnez Enable OAuth Settings. Consultez cette page d’aide de Salesforce pour plus d’informations.
2. Définissez l’URL de rappel à : https://data.us1.qualtrics.io/connectors?token_type=salesforce
3. Sélectionnez les champs d’application OAuth suivants :
   • Accessibilité des permissions personnalisées (custom_permissions)
   • Accessibilité des identifiants uniques d’utilisateur (openid)
   • Accès complet (full)
   • Manager les données des utilisateurs via les API (api)
   • Effectuer des requêtes à tout moment (refresh_token, offline_access)
   • Assurez-vous que la fonction PKCE n’est pas activée
4. Dans la même carte connectée, sélectionnez Manage OAuth Access Policies (Gérer les politiques d’accès OAuth). Consultez cette page d’aide de Salesforce pour plus d’informations.
5. Choisissez les options suivantes :
   • Utilisateur autorisé: Tous les utilisateurs peuvent s’auto-autoriser.
   • Politique relative au jeton de rafraîchissement: Le jeton de rafraîchissement est valable jusqu’à ce qu’il soit révoqué.

Configuration d’un job Salesforce Inbound

1. Sur la page Emplois, cliquez sur Nouveau travail.
   
2. Sélectionnez Salesforce.
   
3. Donnez un nom à votre travail afin de pouvoir l’identifier.
   
4. Choisissez le projet dans lequel vous souhaitez charger les données.
5. Donnez une description de votre poste afin d’en connaître l’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 afin de pouvoir l’identifier.
   • ID du client Salesforce: Votre clé de consommateur Salesforce.
   • Secret du client Salesforce: votre secret de consommateur Salesforce
   • Environnement Salesforce: L’URL de l’environnement de votre 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 informations d’identification expirent, configurez les options suivantes :
    
    • Envoyer des notifications d’expiration: Sélectionnez cette option pour autoriser l’expiration de vos informations d’identification.
    • Jours avant l’expiration: Si vous activez les notifications d’expiration, indiquez le nombre de jours avant l’expiration. Vous pouvez saisir une valeur comprise entre 1 et 100 jours.
    • Date d’expiration: Définissez la date d’expiration des informations d’identification. Cliquez sur la case pour ouvrir un calendrier et choisir la date.
11. Cliquez sur Suivant.
12. Choisissez le type de feedback à télécharger depuis Salesforce :
    
    • Feedback Salesforce: Téléchargez des commentaires réguliers.
    • Salesforce Chat: Téléchargement des interactions agent/client à partir de Salesforce Chat.
    • Texte SMS Salesforce: Téléchargement des interactions agent/client à partir de Salesforce LiveMessage.
13. Si vous téléchargez Salesforce Chat, sélectionnez la manière dont les agents et les clients sont identifiés :
    • Détection automatique: Détecter automatiquement les agents, les assistants de chat et les visiteurs.
    • Le premier participant est un agent: Le premier participant au chat sera désigné comme agent.
    • Le premier participant est un client: Le deuxième participant au chat est un agent.
14. Sélectionnez la version de l’API que vous souhaitez utiliser.
15. Saisissez une instruction SOQL personnalisée pour limiter les données extraites de Salesforce.
    
    Astuce : Pour récupérer des données de chat, 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 la requête pour tester votre déclaration SOQL.
17. Si la validation a réussi, choisissez le champ de date utilisé pour identifier les données à extraire.
    Astuce : Cette liste ne contient que les champs présents dans votre requête SOQL.
18. Cliquez sur Suivant
19. Si nécessaire, ajustez vos correspondances de données. Consultez la page d’assistance sur le mappage des données pour obtenir des informations détaillées sur le mappage des champs dans XM Discover. La section Mappage des données par défaut contient des informations sur les champs spécifiques à ce connecteur et la section Mappage des champs conversationnels explique comment mapper les données pour les données conversationnelles.
    
20. Cliquez sur Suivant.
21. Si vous le souhaitez, vous pouvez ajouter des règles de substitution de données et de rédaction pour masquer les données sensibles ou remplacer automatiquement certains mots et phrases dans les commentaires et interactions des clients. Voir la page d’aide sur la substitution et la rédaction des données.
    Astuce : Cliquez sur Télécharger des échantillons de données pour télécharger un fichier Excel contenant des échantillons 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 une seule tâche en entrant un nombre dans la case Spécifier la limite d’enregistrements. Saisissez “Tous” si vous souhaitez importer tous les enregistrements.
    Astuce : pour les données conversationnelles, la limite est appliquée en fonction des conversations et non des lignes.
25. Cliquez sur Suivant.
26. Choisissez le moment où vous souhaitez être informé. Pour plus d’informations, voir Notifications d’emploi.
    
27. Cliquez sur Suivant.
28. Choisissez le mode de traitement des documents dupliqués. Pour plus d’informations, voir la rubrique Traitement des dupliqués.
    
29. Choisissez Planifier des exécutions incrémentielles si vous souhaitez que votre travail s’exécute périodiquement selon un calendrier, ou Configurer un tirage unique si vous souhaitez que le travail ne s’exécute qu’une seule fois. Pour plus d’informations, voir Planification des tâches.
30. Cliquez sur Suivant.
31. Évaluateur. Si vous devez modifier un paramètre spécifique, cliquez sur le bouton Modifier pour accéder à cette étape de la configuration du connecteur.
32. Cliquez sur Terminer pour enregistrer le travail.

Mappage des données par défaut

Cette section contient des informations sur les champs par défaut des travaux entrants de Salesforce.

• natural_id: Identifiant unique d’un document. Il est fortement recommandé d’avoir un identifiant unique pour chaque document afin de traiter correctement les dupliqués. Pour Natural ID, vous pouvez sélectionner n’importe quel champ textuel ou numérique de vos données. Vous pouvez également générer automatiquement des identifiants en ajoutant un champ personnalisé.
• document_date: Champ de date primaire associé à un document. Cette date est utilisée dans les rapports XM Discover, les tendances, les alertes, etc. Par défaut, ce champ est associé au champ de date sélectionné après avoir spécifié la requête SOQL. Vous pouvez choisir l’une des options suivantes :
  • CreatedDate (par défaut): La date à laquelle l’objet Salesforce a été créé.
  • ClosedDate (pour les données de chat): La date à laquelle l’affaire a été clôturée.
  • Si vos sources données contiennent d’autres champs de données, vous pouvez choisir l’un d’entre eux.
  • Vous pouvez également fixer une date spécifique pour le document.
• 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.
• valeur_source: 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 de marketing mobile. Par défaut, la valeur de cet attribut est “Salesforce” Utilisez les transformations personnalisées pour définir une valeur personnalisée, une expression ou une correspondance avec un autre champ.
• feedback_type: Identifie les informations en fonction de leur type. Cela est utile pour les rapports 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 fixée à “Rapports opérationnels”. Utilisez les transformations personnalisées pour définir une valeur personnalisée, une expression ou une correspondance avec un autre champ.
• job_name: identifie les informations en fonction du nom de la tâche utilisée pour les télécharger. Vous pouvez modifier la valeur de cet attribut pendant la configuration via le champ Nom de champ qui s’affiche en haut de chaque page pendant la configuration.
• loadDate: Indique quand un document a été téléchargé dans XM Discover. Ce champ est défini automatiquement et ne peut pas être modifié.