Configuration d’une tâche de lien de découverte XM

À propos du connecteur XM Discover Link

Vous pouvez utiliser le connecteur XM Discover Link pour pousser les données XM dans XM Discover via un point de terminaison de l’API REST tout en exploitant toutes les fonctionnalités offertes par l’infrastructure Connecteurs, telles que le mappage de champs, les transformations, les filtres, l’observation des tâches, etc.

Le connecteur XM Discover Link vous permet d’ingérer des données à votre rythme, tandis que d’autres connecteurs extraient les données selon une planification.

Formats de données pris en charge

Le connecteur XM Discover Link prend en charge le chargement des types de données suivants :

• Feedback individuel
• Interactions numériques
• Transcriptions d’appel

Tous les documents sont fournis au format JSON qui dépend du type de données.

Pour en savoir plus sur les formats de données pris en charge par XM Discover, voir Présentation des formats de découverte des données XM.

Voici comment fonctionne le connecteur XM Discover Link :

1. La première étape de l’utilisation du connecteur XM Discover Link consiste à configurer une tâche de traitement et à configurer des paramètres et des mappages pour les futurs appels d’API. Pour plus de détails, voir. Création d’une tâche de lien XM Discover.
2. Une fois qu’un job de traitement est configuré, vous pouvez exécuter des appels API via le job de traitement approprié en référençant son ID. Toutes les informations nécessaires sur le point de terminaison de l’API sont fournies dans le récapitulatif de la tâche de traitement. Pour plus de détails, voir. Informations sur le point d’extrémité de l’API.

Configuration de la connexion

Avant de commencer

Avant de configurer une tâche Lien de découverte XM, nous vous recommandons de préparer un exemple de fichier avec les données client au format JSON à l’aide de l’un des types de données suivants :

1. Avis individuel : Pour plus de détails, voir Feedback individuel au format JSON.
2. Interactions numériques : pour plus de détails, voir Interactions numériques au format JSON.
3. Transcriptions d’appel : Pour plus de détails, voir Appeler les transcriptions au format JSON.

Pour configurer la connexion :

1. Connectez-vous aux connecteurs.
2. Cliquez sur le bouton Nouvelle tâche dans le coin supérieur droit de la page Tâches.
3. Sur la page Connecteurs, accédez à la section SÉLECTIONNER UNE SOURCE.
4. Cliquez sur le bouton Lien de découverte XM.

Création d’une tâche de connecteur d’entrée de lien de découverte XM

Après avoir configuré la connexion, suivez ces étapes pour créer une tâche de connecteur entrant XM Discover Link et configurer les données à envoyer à XM Discover.

• Étape 1 : indiquez le nom du job
• Étape 2 : Spécifier le projet et la description
• Étape 3 : mode d’autorisation
• Étape 4 : Sélectionner un exemple de fichier
• Étape 5 : Mapper les champs souhaités dans XM Discover
• Étape 6 : substitution et édition des données (facultatif)
• Étape 7 : Spécifier le filtre (facultatif)
• Étape 8 : configurer des options supplémentaires pour le poste
• Étape 9 : confirmer tous les paramètres de la tâche

Étape 1 : indiquez le nom du job

Saisissez un nom de tâche reconnaissable dans la zone Nom de la tâche en haut de la page.

Étape 2 : Spécifier le projet et la description

1. Sur la page Spécifier le projet et la description, sélectionnez le projet dans lequel les données doivent être chargées dans le menu déroulant des projets.
   Astuce Qualtrics : vous avez la possibilité de saisir une note sur le poste dans la zone Description du poste. La description du job que vous saisissez dans la zone “Description du job” est accessible uniquement dans la liste Connecteurs et n’est pas chargée dans le cadre des données d’un job.
2. Cliquez sur Suivant.

Étape 3 : mode d’autorisation

Sur la page Authorization Mode (Mode d’autorisation), sélectionnez le mode d’autorisation que vous prévoyez d’utiliser pour les appels d’API :

• Clé API : utilisez les jetons API générés par XM Discover. Pour en savoir plus sur les jetons d’API, voir. Jetons API.
• OAUTH 2.0 : utilisez l’ID client et la clé secrète client fournis par le service d’authentification XM Discover. Veuillez contacter votre gestionnaire de la satisfaction clientèle Qualtrics pour demander cette méthode.

Étape 4 : Sélectionner un exemple de fichier

1. Sur la page Sélectionner un exemple de fichier, sous Choisir le format des données, sélectionnez le type de données à traiter par ce job :
   • Discussion en direct : traitez les interactions numériques avec plusieurs lignes de dialogue entre deux participants ou plus. Les interactions numériques doivent suivre un format prédéfini. Vous pouvez télécharger un modèle après avoir sélectionné le format de données.
   • Appel : Charger les transcriptions d’appel avec plusieurs lignes de dialogue entre deux participants ou plus. Les journaux d’appels doivent suivre un format prédéfini ; vous pouvez télécharger un modèle après avoir sélectionné le format de données.
   • Feedback : traitez les documents présentés sous forme d’objets à une seule ligne ou « plats ».
2. Dans la liste déroulante Modèle, sélectionnez un modèle à utiliser.
   Astuce Qualtrics : les options de modèle disponibles sont différentes selon le format de données choisi.

   Format des données	Options de modèle
   Chat	Discussion en direct (par défaut) : utiliser pour les données d’interactions numériques standard. Amazon Connect : utilisation pour les interactions numériques spécifiques à Amazon Connect Chat.
   Appel	Appel (par défaut) : utilisation pour les données de transcription d’appel standard. Verint : Utilisation pour les transcriptions d’appel spécifiques à Verint. Astuce Qualtrics : pour en savoir plus sur le format de fichier d’exportation d’Interaction Analytics de Verint, consultez la documentation de Verint.
   Commentaires	Aucun (par défaut) : n’appliquez aucun modèle. Dynamics 365 : Utilisation pour les données Microsoft Dynamics.

3. Dans la zone Chemin d’accès JSON, indiquez le chemin JSON d’un sous-ensemble de JSON contenant des nœuds de document.
   Astuce Qualtrics : laissez-le vide si les documents sont situés au niveau du nœud racine.
4. Cliquez sur le bouton Cliquer pour sélectionner un fichier à charger et pointez vers l’exemple de fichier ou déposez votre fichier dans la zone de dessin grise.
5. Attendez que XM Discover télécharge l’exemple de fichier et affiche l’aperçu ci-dessous.
   Astuce Qualtrics : si vous voyez un message d’erreur et le contenu du fichier brut au lieu de l’aperçu, il peut y avoir un problème avec les options de format de données que vous avez sélectionnées. Pour plus d’informations sur les messages d’erreur relatifs à l’échec de la validation des exemples de fichiers, voir. Erreurs de l’exemple de fichier.
6. Assurez-vous que les données sont correctes.
7. Cliquez sur Suivant.

Étape 5 : Mapper les champs souhaités dans XM Discover

1. Sur la page Mapper les champs souhaités dans XM Discover, sélectionnez l’onglet MAPPAGE DE SOURCE pour connecter les champs de données source aux champs de données de votre projet XM Discover.
2. Dans la section Mappage source par défaut, configurez les champs de données par défaut que tous les documents dans XM Discover share.Le tableau suivant fournit une synthèse des options de champs de données par défaut pour le connecteur entrant XM Discover Link.
   

   Nom du champ	Modifiable ?	Description
   feedback_type	Oui	Le type de feedback vous aide à identifier 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 : « appel » pour les transcriptions d’appel « chat » pour les interactions digitales « feedback » pour les avis individuels Utilisez la transformation personnalisée pour définir une valeur personnalisée, définir une expression ou la mapper à un champ donné.
   se procurent	Oui	La source vous aide à identifier 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 « Lien de découverte XM ». Utilisez la transformation personnalisée pour définir une valeur personnalisée, définir une expression ou la mapper à un champ donné.
   richVerbatim (pour les données conversationnelles)	Non	Pour les données conversationnelles (comme les interactions d’appel et de discussion en direct), XM Discover utilise un format verbatim conversationnel pour le champ richVerbatim. Ce format prend en charge l’ingestion des métadonnées spécifiques au dialogue requises pour débloquer la visualisation conversationnelle (tours de haut-parleur, silence, événements conversationnels, etc.) et les enrichissements (heure de début, durée, etc.). Ce champ verbatim inclut des champs « enfant » pour suivre le côté client et représentatif de la conversation : clientVerbatim suit le côté client de la conversation. agentVerbatim suit le côté du représentant (de l’agent) de la conversation. inconnu suit le côté inconnu de la conversation. Notes sur les verbatims conversationnels : Les transformations ne sont pas prises en charge pour les champs verbatim conversationnels. Le même mot ne peut pas être utilisé pour différents types de données conversationnelles. Si vous souhaitez que votre projet héberge plusieurs types de conversation, utilisez des paires séparées de verbatims conversationnels par type de conversation.
   clientVerbatim (pour les données conversationnelles)	Oui	Suit le côté client de la conversation dans les interactions d’appel et de discussion en direct. Par défaut, ce champ est mappé sur : clientVerbatimChat pour les interactions numériques clientVerbatimCall pour les interactions d’appel Vous pouvez le mapper à un autre champ textuel si nécessaire.
   agentVerbatim (pour les données conversationnelles)	Oui	Suit le côté représentant de la conversation dans les interactions d’appel et de discussion en direct. Par défaut, ce champ est mappé sur : agentVerbatimChat pour les interactions numériques agentVerbatimCall pour les interactions d’appel Vous pouvez le mapper à un autre champ textuel si nécessaire.
   inconnu (pour les données conversationnelles)	Oui	Suit le côté inconnu de la conversation dans les interactions d’appel et de discussion en direct. Par défaut, ce champ est mappé sur : unknownVerbatimChat pour les interactions numériques unknownVerbatimCall pour les interactions d’appel Vous pouvez le mapper à un autre champ textuel si nécessaire.
   document_date	Oui	La date du document est le champ de date principal associé à un document. Cette date est utilisée dans les rapports XM Discover, les tendances, les alertes, etc. Pour Date du document, sélectionnez l’une des options suivantes : conversationTimestamp (pour les données conversationnelles) : date et heure pour l’ensemble de la conversation. Si les données source contiennent d’autres zones de date, vous pouvez définir l’une d’elles comme Date du document en la sélectionnant dans le menu déroulant de la colonne Nom de zone. Vous pouvez également définir une date spécifique en ajoutant une zone personnalisée. Pour plus de détails, voir. Définition d’une date de document spécifique.
   ID_naturel	Oui	L’ID naturel sert d’identifiant unique d’un document et permet de traiter correctement les doublons. Pour ID naturel, sélectionnez l’une des options suivantes : conversationId (pour les données conversationnelles) : ID unique pour l’ensemble de la conversation. Sélectionnez un champ de texte ou numérique parmi vos données dans la colonne Nom du champ. Générez automatiquement des ID en ajoutant une zone personnalisée. Pour plus de détails, voir. Génération automatique d’ID naturels.
   fournisseur_feedback	Non	Le fournisseur de feedback vous aide à identifier les données obtenues d’un fournisseur spécifique. Pour les téléchargements de liens de découverte XM, la valeur de cet attribut est définie sur « Lien de découverte XM ».
   nom_job	Oui	Le nom du job vous permet d’identifier les données en fonction du nom du job utilisé pour le chargement. Vous pouvez modifier la valeur de cet attribut dans la zone Nom de la tâche en haut de la page.
   Date de chargement	Non	La date de chargement indique quand un document a été téléchargé dans XM Discover. Cette zone est définie automatiquement.

3. Dans la section Mappage source, configurez le reste des champs de données.
   Astuce Qualtrics : cette section contient les mappages pour les champs source que vous avez fournis via l’exemple de fichier. Si vous n’avez pas fourni d’exemple de fichier, vous devrez créer des mappages manuellement. Pour plus d’informations sur le mappage des données, voir. Configuration du mappage de données.
4. Cliquez sur Suivant.

Étape 6 : substitution et édition des données (facultatif)

1. Sur la page Remplacement et édition des données, vous pouvez fournir des règles de remplacement et de rédaction pour masquer les données sensibles ou remplacer automatiquement certains mots et phrases types dans le feedback et les interactions des clients.
   Astuce Qualtrics : pour en savoir plus sur la substitution et la rédaction des données, voir Remplacement et réduction des données.
2. Cliquez sur Suivant.

Étape 7 : Spécifier le filtre (facultatif)

1. Sur la page Spécifier un filtre, vous pouvez définir une condition de filtre pour que le job charge uniquement les données qui correspondent au filtre.
   Astuce Qualtrics : pour plus d’informations sur le filtrage des données entrantes, voir Filtre de connecteur.
2. Cliquez sur Suivant.

Étape 8 : configurer des options supplémentaires pour le poste

1. Sur la page Configurer des options supplémentaires pour la tâche, choisissez comment XM Discover doit gérer les documents en double en sélectionnant l’un des modes de détection de doublons suivants dans la section Gestion des documents nouveaux et existants :
   • Rejeter les doublons pour les documents existants et créer de nouveaux enregistrements pour les nouveaux documents.
   • Mettre à jour les attributs structurés pour les documents existants et créer de nouveaux enregistrements pour les nouveaux documents.
   • Mettre à jour les attributs structurés pour les documents existants et ne pas créer d’enregistrements pour les nouveaux documents.
     Attention : chaque document doit avoir un ID naturel unique afin que le système puisse traiter les documents en double ayant des ID naturels identiques.
     Astuce Qualtrics : pour en savoir plus sur les modes de détection des doublons, voir Détection des doublons.
2. Cliquez sur Suivant.

Étape 9 : confirmer tous les paramètres de la tâche

1. Sur la page Confirmer tous les paramètres de la tâche, vous pouvez afficher une synthèse de tous les paramètres d’une tâche et modifier les paramètres, si nécessaire.
2. Cliquez sur le bouton Terminer pour créer la tâche Lien de découverte XM.
3. Une fois la tâche Lien de découverte XM créée, vous pouvez l’utiliser pour exécuter des appels d’API. Pour plus de détails, voir. Informations sur le point d’extrémité de l’API.

Comment obtenir les informations de point d’extrémité de l’API

Après avoir configuré une tâche Lien de découverte XM, vous devez obtenir les informations de point de terminaison de l’API nécessaires pour commencer à charger les données à l’aide de cette tâche.

1. Connectez-vous aux connecteurs.
2. Assurez-vous que l’onglet JOBS est ouvert.
3. Recherchez la tâche XM Discover Link appropriée à l’aide de filtres ou de la recherche.
4. Développez le menu d’actions en regard de la tâche et sélectionnez Récapitulatif.
5. Dans le coin supérieur droit de la fenêtre Détails de la tâche : nom de la tâche, cliquez sur le lien Documentation de l’API pour ouvrir la documentation de l’API de tâche. Le tableau ci-dessous fournit les détails des informations de point de terminaison de l’API nécessaires pour lancer le chargement des données à l’aide d’une tâche Lien de découverte XM :