Connecteur d’entrée Zendesk
À propos du connecteur d’entrée Zendesk
Vous pouvez utiliser le connecteur entrant Zendesk pour charger les données de discussion en direct de Zendesk dans XM Discover.
Astuce Qualtrics : Pour configurer la connexion, vous aurez besoin des informations suivantes sur votre compte Zendesk :
- Votre adresse e-mail Zendesk
- Votre clé API Zendesk
- Le sous-domaine Zendesk de votre organisation
Configuration d’un job d’entrée Zendesk
Astuce Qualtrics : l’autorisation « Gérer les tâches » est requise pour utiliser cette fonctionnalité.
- Sur la page Tâches, cliquez sur Nouvelle tâche.
- Sélectionnez Zendesk.
- Donnez un nom à votre job pour pouvoir l’identifier.
- Sélectionnez le projet dans lequel charger les données.
- Donnez une description de votre travail pour connaître son objectif.
- Cliquez sur Suivant.
- Choisissez le compte Zendesk à utiliser ou sélectionnez Ajouter nouveau pour en ajouter un nouveau.
- Si vous ajoutez un nouveau compte, saisissez les informations suivantes concernant votre compte Zendesk :
- Nom de la connexion: donnez un nom à la connexion pour que vous puissiez l’identifier.
- E-mail Zendesk: adresse e-mail de votre compte Zendesk.
- clé API Zendesk : clé API de votre compte Zendesk.
- Hôte Zendesk: Votre sous-domaine Zendesk.
- 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.
- Cliquez sur Suivant.
- Sélectionnez le type de données que vous souhaitez importer dans XM Discover :
- Traiter les tickets de discussion en direct comme des conversations: les tickets de discussion en direct Zendesk sont importés en tant que conversations.
- Traiter tous les tickets comme des documents: tous les tickets Zendesk sont importés en tant que documents.
- Vous pouvez choisir d’inclure ou non les tickets non terminés dans le chargement. Sélectionnez le Traiter uniquement les tickets clôturés option permettant de charger uniquement les tickets clôturés. Désélectionnez cette option pour charger à la fois les tickets clôturés et en cours.
- Cliquez sur Suivant.
- 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.
- Cliquez sur Suivant.
- 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. - Cliquez sur Suivant.
- 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.
- 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.
- Cliquez sur Suivant.
- Choisissez quand vous souhaitez recevoir une notification. Pour plus d’informations, voir Notifications de jobs.
- Cliquez sur Suivant.
- Sélectionnez le mode de traitement des documents en double. Pour plus d’informations, voir Traitement des doublons.
- 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.
- Cliquez sur Suivant.
- 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.
- Cliquez sur Terminer pour sauvegarder le job.
Mappage de données par défaut
Cette section contient des informations sur les zones par défaut pour les jobs entrants Zendesk.
- 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. Par défaut, XM Discover utilise des ID source préfixés par le nom du connecteur via une transformation personnalisée:Natural ID = Connector-name;Source-ID.
- 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 :
- updated_at (par défaut): date et heure de la dernière mise à jour de l’activité de discussion en direct.
- created_at: date et heure de création de l’activité de discussion en direct.
- 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 chargements Zendesk, la valeur de cet attribut est définie sur “Zendesk” 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 « Zendesk ». 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 “Plateforme de messagerie”. 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.
Astuce Qualtrics : Voir Mappage des champs conversationnels pour des informations sur la cartographie des données conversationnelles (richVerbatim, clientVerbatim, agentVerbatim, inconnu.