Passer au contenu principal
Loading...
Skip to article
  • Customer Experience
    Customer Experience
  • Employee Experience
    Employee Experience
  • Brand Experience
    Brand Experience
  • Core XM
    Core XM
  • Design XM
    Design XM

Évènement JSON


Was this helpful?


This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

The feedback you submit here is used only to help improve this page.

That’s great! Thank you for your feedback!

Thank you for your feedback!


Astuce Qualtrics : les événements JSON sont disponibles uniquement pour les utilisateurs ayant acheté un accès à l’API Qualtrics. Si vous souhaitez obtenir cette fonctionnalité, parlez-en à votre Commercial ou à votre XM Success Manager.

À propos de l’événement JSON

Avez-vous déjà voulu qu’une demande de déclenchement de ticket dans Qualtrics soit faite sur votre site Web ? Avez-vous déjà voulu créer une intégration fluide entre Qualtrics et votre propre système interne ? Avez-vous déjà voulu déclencher une tâche dans l’onglet Workflows, mais avec un événement qui se produit en dehors de Qualtrics ?

Les événements JSON permettent au logiciel externe de lancer des workflows via une requête HTTP. Au lieu d’attendre qu’un événement dans Qualtrics déclenche d’autres actions sur la plateforme, vous pouvez simplement configurer un événement JSON pour recevoir des demandes d’un tiers.

Astuce Qualtrics : vous devez générer un jeton API avant que cette fonctionnalité ne soit disponible. Si vous avez déjà un jeton API, vous n’avez pas besoin d’en générer un nouveau.
Attention : la configuration d’un événement JSON nécessite des connaissances avancées en programmation. Bien que notre équipe de support soit ravie d’apporter son aide sur les bases de la mise à disposition d’informations dans l’événement, nous ne pouvons pas fournir d’assistance sur les aspects de programmation. Vous pouvez plutôt tenter de vous adresser à notre communauté d’utilisateurs dédiés.

Limites

L’événement JSON n’est pas compatible avec les configurations et configurations suivantes :

  • Tout ce qui n’est pas HTTP (par exemple, file d’attente des messages, SMS).
  • Appels HTTP sortants.
  • XML de processus (le corps de la demande XML sera ignoré).
  • Traitez tout autre chose que JSON.
  • Authentifiez-vous de toute autre manière qu’un en-tête X-API-TOKEN ou notre autorisation de base HTTP modifiée.
    Astuce Qualtrics : OAuth et d’autres formes d’authentification sont incompatibles avec les événements JSON.
  • Toute analyse JSON qui ne peut pas être satisfaite en utilisant des requêtes JSONPath sur le corps JSON.
  • Appels dépassant la limite de débit API de 3 000 par minute.
  • Données utiles dépassant 100 Ko.

Types d’authentification pris en charge

Autoris. basée sur jetons/autor. en-tête

Vous pouvez vous authentifier en transmettant votre jeton API via l’en-tête de la demande sous la forme X-API-TOKEN.

Exemple : dans l’exemple POST suivant, dans cURL, nous spécifions l’ URL de base, le type de contenu et le jeton dans l’en-tête. L’ID d’enquête et le format d’exportation sont indiqués dans

body.curl -X POST -H "X-API-TOKEN: yourapitokenhere" -H "Content-Type: application/json" -d '{

     "surveyId": "SV_012345678912345",

     "format": "csv"

 }" "https://yourdatacenterid.qualtrics.com/API/v3/responseexports"

Authentification de base HTTP

L’authentification de base est généralement une version encodée en Base64 du nom d’utilisateur:mot de passe. Cependant, pour une sécurité améliorée, Qualtrics utilise une chaîne codée Base64 de nom d’utilisateur:x-api-token.

Pour utiliser l’authentification de base, vous devez définir des en-têtes sur la requête HTTP. L’en-tête spécifique est Autorisation.

Exemple : supposons que votre nom d’utilisateur Qualtrics soit demo@qualtrics.com et que votre jeton d’API soit f8gIK7G6GFH985Y4. Tout d’abord, écrivez,

 demo@qualtrics.com:f8gIK7G6GFH985Y4

Ensuite, après l’encodage Base64, cela apparaîtrait comme suit :

 de base ZGVtb0BxdWFsdHJpY3MuY29tOmY4Z0lLN0c2R0ZIOTg1WTQ=

Ainsi, l’en-tête d’autorisation que vous ajoutez à votre requête HTTP aurait la valeur Basic ZGVtb0BxdWFsdHJpY3MuY29tOmY4Z0lLN0c2R0ZIOTg1WTQ=.

Astuce Qualtrics : consultez ces outils pour coder base64 et décoder base64.

Configuration d’un événement JSON

  1. Vous devrez d’abord créer un workflow. Accédez à l’onglet Onglet Workflows dans un projet, ou la page Workflows autonomes.
    Dans longlet Workflows, cliquez sur Créer un workflow, puis sur Démarré lorsquun événement est reçu.
  2. Assurez-vous d’être dans l’onglet Vos workflows.
  3. Cliquez sur Créer un workflow.
  4. Sélectionnez Lancé lors de la réception d’un événement.
  5. Sélectionnez l’événement JSON.
    sélection de lévénement JSON pour lancer le workflow
  6. Si vous le souhaitez, indiquez un Résumé du déclencheur qui doit décrire l’objectif de l’événement JSON. ajout dun récapitulatif du déclencheur et copie de lURL
  7. Vous recevrez une URL. Utilisez cette option pour appeler votre nouveau flux de travail depuis l’extérieur de Qualtrics, en utilisant Postman, votre propre système interne ou d’autres applications similaires. Pour le copier, cliquez sur Copier URL.
  8. Vous pouvez maintenant définir les données d’événement. Cela permet de capturer les données de la demande de stockage. Pour commencer, cliquez sur Paramètres avancés.
    Astuce Qualtrics : pour plus d’informations sur la section Test, voir Enregistrer des événements ci-dessous.
  9. Dans la zone de gauche, donnez le nom de zone JSON. Dans la case de droite, indiquez l’emplacement dans les données d’événement (corps de la requête HTTP).
    ajout du mappage JSON et des paramètres GET

    Astuce Qualtrics : les emplacements doivent être au format JSONPath ! Voir le tableau ci-dessous pour obtenir un guide de consultation rapide de la syntaxe JSONPath.
  10. Pour ajouter une autre zone, cliquez sur Ajouter un champ JSON.
  11. Si vous souhaitez ajouter un paramètre GET, ajoutez-le dans la section Paramètres GET. Pour en savoir plus sur ces paramètres et leur fonctionnement dans l’API, consultez notre documentation API sur les paramètres.
    Avertissement : il n’est pas recommandé de transférer des données personnelles identifiables via les paramètres GET. Toute information permettant d’identifier une personne ou toute donnée sensible doit être transmise par l’intermédiaire de l’organisme POST dans la mesure du possible, car POST est plus sûr. Veuillez contacter le support de Qualtrics pour toute question ou problème.
  12. Pour supprimer une zone, cliquez sur le signe moins ( ).
  13. Pour sauvegarder vos modifications, cliquez sur Sauvegarder.
  14. Vous pouvez maintenant ajouter des conditions et une tâche à votre workflow en cliquant sur le signe plus (+ ). Les conditions déterminent à quel moment un workflow s’exécute, tandis que les tâches sont le résultat du workflow. Voir le Synthèse des workflows pour plus d’informations.
    en cliquant sur le signe plus, puis sur la tâche ou les conditions ;

Astuce Qualtrics : cliquez sur votre événement JSON pour modifier les paramètres et les champs JSON.

Attention : un événement JSON peut uniquement être déclenché via l’API à partir du même compte que celui qui a créé l’événement. Si un autre compte est utilisé pour déclencher l’API pour un événement JSON, il se peut que vous receviez toujours une réponse d’API de réussite 202. Cependant, cela signifie qu’un jeton API valide a été utilisé pour effectuer une demande valide, mais ne signifie pas nécessairement que le jeton API correct a été utilisé ou que l’événement JSON a été déclenché correctement. Si vous recevez un message d’API de 202 succès, vous voudrez vérifier la plate-forme pour confirmer que l’API correcte a été utilisée.

&nbsp ;

Capturer des événements

Lorsque vous créez un événement d’API externe, vous devrez peut-être analyser les données du corps de la publication. Cependant, il peut parfois être difficile d’analyser ces données. Si vous voulez déterminer ce que votre API externe envoie, suivez ces étapes.

  1. Cliquez sur votre événement JSON.
    sélection de lévénement JSON
  2. Par défaut, l’option Capturer les champs JSON à partir des résultats du test pour qu’ils puissent être utilisés comme texte inséré dans d’autres tâches de ce workflow sera activée. Cette option permet de rendre les champs analysés dans le corps des données utiles automatiquement disponibles sous forme de texte inséré lorsque vous ajoutez vos tâches de workflow.
    cliquer sur Exécuter un nouveau test
  3. Cliquez sur Exécuter un nouveau test.
  4. Vous verrez un message indiquant que Qualtrics attend de recevoir l’événement de votre système externe. Lancez votre API externe.lévénement JSON en attente de réception dun événement de votre système externe ;
    Astuce Qualtrics : pour annuler ce test, cliquez sur Annuler le test.
  5. Si le test s’est déroulé correctement, le message Connexion au serveur réussie s’affiche. Les données utiles seront analysées et ajoutées à la fenêtre.un test réussi - les données utiles JSON se trouvent dans la fenêtre dévénement.
  6. Si vous le souhaitez, cliquez sur Exécuter un nouveau test pour exécuter un autre test. Vous devrez exécuter votre prochain appel d’API après avoir cliqué sur cette option.
  7. Cliquez sur Enregistrer.

Syntaxe JSONPath

Le tableau ci-dessous donne quelques-unes des bases de la syntaxe JSONPath. Notez qu’ils ne sont pas établis par Qualtrics, mais qu’il s’agit de normes utilisées avec JSON.

Attention : la configuration d’un événement JSON requiert des connaissances avancées en programmation. Bien que notre équipe de support soit ravie d’apporter son aide sur les bases de la mise à disposition d’informations dans l’événement, nous ne pouvons pas fournir d’assistance sur les aspects de programmation. Vous pouvez toujours essayer de demander à notre communauté d’utilisateurs dédiés à la place.
JSONPath Description Exemple
$ L’objet/l’élément racine $.stores[0].name
@ L’objet/l’élément actuel $.stores[?(@.name===”ACME Store”)]
. Opérateur enfant $.eventDescription
.. Opérateur de descendant récursif $.magasins[0]..prix
* Caractère générique $.stores[*].name
[] Opérateur d’indice $.stores[0].name
[,] Opérateur d’union $.stores[0,1]
[début:fin:étape] Opérateur de tranche de tableau $.stores[0:10:2]
?() Applique un filtre $.stores[?(@.name==”ACME Store”)]
() Expression de script $.stores[(@.length-1)]

Exemple de syntaxe JSONPath

Dans cet exemple, nous allons vous montrer comment, compte tenu d’un objet JSON, la table JSONPath peut être utilisée.

Voici notre objet JSON :

{
 "eventDescription": "Monthly Revenue",
 "stores": [
 {
"name": "Acme Store",
 "total": 1000000,
 "topItem":

 {"price": "50", "description": "Anvil" }

 },
 {
"name": "The Banana Stand",
 "total": 250000, "topItem": {"price": "4": "4", "Plan}
": "Plan}" description:

 250000, "topItem": { "price": "4", "Plan}

",
 "Plan}":
 250000
,

 "topItem":

 {"price": "4", "Plan}": "8
"

À présent, nous devons ajouter les valeurs de retour que nous voyons dans la table JSONPath pour le rendre plus clair.

$ -> Acme Store
 @ -> [
 {
 "name": "Acme Store",
 "total": 1000000,
 "topItem":

 { "price": "50", "description": "Anvil" }
 }

 . . -> Revenu mensuel
 .. ->

; 50



 -> ["Acme Store", "The Bandeo Stand", "Pizza Planet"]









 [] -> Acme Store
 [,] -> [

 Unknown
 stana
"

: ""name"}


2
]

() -> [{
 "name": "Acme Store",
 "total": 1000000,
 "topItem":

 { "price": "50", "description": "Anvil" }
 }]

 () -> [
 {
 "name": "Pizza Planet","total": 80000,"toponi": "toponi": "toponi": "Pizza Planet","total": 80000,"toponi Item": "toponi": "Pizza Planet",
 "total": 80000,"toponi": "toponi": "pizza Planet","total": 80000,
 "toponi" 
 "toponi": "toponi": "Pizza Planet","total": 80000,"toponi" 

 "toponi": "toponi" 

Exemple d’API dans le noeud Javascript

L’exemple ci-dessous est un modèle de base que vous pouvez suivre lors de la mise en forme de vos données d’événement.

Attention : la configuration d’un événement JSON requiert des connaissances avancées en programmation. Bien que notre équipe de support soit ravie d’apporter son aide sur les bases de la mise à disposition d’informations dans l’événement, nous ne pouvons pas fournir d’assistance sur les aspects de programmation. Vous pouvez toujours essayer de demander à notre communauté d’utilisateurs dédiés à la place.
var request = Required('request-promesse');
 var surveyId = "SV_XXXXXXXXXXXX";
 var triggerId = "OC_XXXXXXXXX";
 var brandId = "YOUR_BRAND_ID";
 var userId = "UR_XXXXXXXXXXXXXXX";var datacentre = "xx1";var TOiToiken = "UR_XXXXXXXXXXX";var datacSON = "xxCS_";var TOi_Toiken = "UR_XXXXXXXXXXX";
 var datacs.com = "xxCS_";
 var TOiToi_Kken = "UR_XXXXXXXXXXX";var datacs.com = "xxCS_CS_";var TOiToiken = "UR_XXXXXXXXXXXXX";var datacs.com = "xxCS_CS_";var TOi_Toiken = "UR_XXXXXXXXXXX";var datacs.com = "xxCS_CS_";var TOiToi_Kken = "UR_XXXXXXXXXXX";var datacs.com = "xxCS_CS_ID" + var TOi_Toiken = "UR_XXXXXXXXXXX";var datacs.com = "xxCS_";var TOi_ToiKken = "UR_XXXXXXXXXXX";var datacs.com = "xxCS_2";var TOi_ToiKken = "UR_XXXXXXXXXXX";var datacs.com = "xxCS_ATTRI";

 var TOi_Toiken = "UR_XXXXXXXXXXXXX";var datacs.com = "xx1";var TOi_ToiKken = "UR_XXXXXXXXXXXXX";var datacs.com = "xxCS_ATT" + 
      var api_tokken = "XXXXXXXXXXXXX"contextId=" + surveyId + "&userId=" + userId + "&brandId=" + brandId + "&triggerId=" + triggerId;
 var payload = {
    
    
    
         "text": "This is some text",
     "object": {
         "number": 4
    ,

 "array": ["a": {numéro
    ":
     4
,
     "array": ["a"
        "X-API-TOKEN": apiToken
     }
 };

 request.post(options).then(function (ret) {
     console.log("success:", url, payload);
 }).catch(function (err) {
     console.log("error: ", url);
     console.log(err);
 });

Exemple : intégration avec Freshdesk

L’événement JSON peut être utilisé pour intégrer à Freshdesk en tant que règle Webhook dans le fichier Dispatch’r. Cela signifie que les événements de Freshdesk peuvent ensuite déclencher des tâches dans Qualtrics, telles que la création d’un ticket ou la distribution d’une enquête.

Astuce Qualtrics : le support de Qualtrics peut vous aider à configurer votre événement JSON et à le connecter via Freshdesk. Cependant, il peut y avoir des questions sur la fonctionnalité Freshdesk auxquelles ils ne peuvent pas répondre. Si vous avez des questions sur le côté Freshdesk, essayez de consulter leur documentation sur les règles d’envoi.
  1. Dans Qualtrics, définissez votre Événement sur Événement JSON.
    sélection de lévénement JSON
  2. Copiez l’URL.
    cliquer sur Copier URL dans lévénement JSON
  3. Dans un nouvel onglet, connectez-vous à Freshdesk.
  4. Dans la section Admin, accédez à l’option qui correspond le mieux au type de règle que vous souhaitez définir.
    Trois options différentes en haut de la section de production du centre dassistance lorsque vous avez cliqué sur lengrenage dadministration dans la barre latérale à gauche

    Astuce Qualtrics : découvrez la différence entre Dispatch’r, Supervisor et Observer dans la documentation de support de Freshdesk.
  5. Créez une nouvelle règle.
    Nouveau bouton Règle en noir en haut à droite
  6. Définissez des conditions pour déterminer quel événement Freshdesk doit déclencher une tâche dans Qualtrics.
    Le nom est Qualtrics CSAT, la description est Enquête envoyée lorsque le ticket est résolu. Condition définie sur lexemple donné ici, le statut est résolu. Action développée de sorte que Déclencher Webhook saffiche

    Exemple : peut-être, lorsqu’un agent Freshdesk le fait de sorte que le statut du ticket passe de n’importe quel statut à Résolu(e), vous souhaitez envoyer une enquête CSAT avec Qualtrics.
  7. Ajoutez une nouvelle action et sélectionnez Déclencher webhook.
    Laction comporte un menu développé avec le webhook déclencheur en surbrillance.
  8. Définissez le Type de demande sur POST.
    Le champ Type de demande indique POST et lURL de rappel contient lURL de lévénement JSON.
  9. Dans URL de rappel, collez l’URL d’événement JSON de l’étape 2.
  10. Pour utiliser l’authentification par jeton, ajoutez des en-têtes personnalisés, saisissez X-API-TOKEN: et définissez-le comme égal à votre jeton d’API.
    Dans la boîte den-tête personnalisé, il indique X-API-TOKEN : puis un jeton dAPI flou
  11. Pour utiliser l’authentification HTTP élémentaire, cliquez sur Requiert une authentification, ajoutez votre nom d’utilisateur Qualtrics, puis saisissez votre jeton API à la place de votre mot de passe.
    Authentification de base - nécessite que lauthentification ait été sélectionnée et que les informations susmentionnées aient été renseignées.
  12. Assurez-vous que le codage est JSON.
    Lencodage est JSON et le-mail du demandeur est sélectionné dans le corps.
  13. Sélectionnez manuellement le contenu à transférer ou sélectionnez Avancé pour saisir un corps JSON.
  14. Sauvegardez votre règle.
  15. Dans Qualtrics, terminez votre workflow. Dans cet exemple, nous ajoutons probablement Tâche du répertoire XM.
    sélection de la tâche de répertoire xm
  16. N’oubliez pas de publier les modifications apportées à votre enquête lorsque vous êtes prêt à la lancer.
Astuce Qualtrics : pour en savoir plus sur les Webhooks de Freshdesk, consultez la documentation associée sur leur site de support technique.

Exemple : intégration à ServiceNow

Astuce Qualtrics : ceci est distinct de la tâche ServiceNow.

L’événement JSON peut être utilisé pour l’intégration à ServiceNow. Cela signifie que les événements dans ServiceNow peuvent ensuite déclencher des tâches dans Qualtrics, telles que la création d’un ticket ou la distribution d’une enquête.

Astuce Qualtrics : le support de Qualtrics peut vous aider à configurer votre événement JSON et à le connecter via ServiceNow. Cependant, il peut y avoir des questions sur la fonctionnalité ServiceNow auxquelles ils ne peuvent pas répondre. Si vous avez des questions sur la manière de vous connecter à votre instance de développeur ServiceNow et de l’activer, consultez sa documentation sur les instances de développeur personnelles.
  1. Dans Qualtrics, définissez votre Événement sur Événement JSON.
    sélection de lévénement JSON
  2. Copiez l’URL.
    cliquer sur Copier URL dans lévénement JSON
  3. Dans un nouvel onglet, connectez-vous à votre instance de développeur ServiceNow.
  4. Sélectionnez Message REST.
    Sélection dun message REST
  5. Cliquez sur Nouveau.
  6. Donnez un nom à votre message résiduel.
    en donnant un nom au message, en indiquant le point dextrémité et en sélectionnant le type dauthentification ;
  7. Dans la zone Point d’extrémité, collez l’URL que vous avez copiée à l’étape 2.
  8. Remplacez le type d’authentification par De base.
  9. Accédez à l’onglet Requête HTTP.
    sélectionner la requête HTTP et ajouter le X-API-TOKEN
  10. Double-cliquez pour ajouter X-API-TOKEN.
  11. Double-cliquez pour coller votre jeton API.
    collage du jeton API
  12. Dans une nouvelle ligne, ajoutez le nom Content-type.
  13. Définissez la valeur sur application/json.
  14. Cliquez sur Envoyer.
    Cliquer sur Soumettre
  15. Rouvrez votre message REST.
    ouverture du message résiduel
  16. Sous Méthodes HTTP, cliquez sur Nouveau.
    Cliquez sur Nouveau.
  17. Donnez un nom à la méthode.
    Définition de la méthode HTTP et attribution dun nom
  18. Définissez la méthode HTTP sur POST.
  19. Définissez le type d’authentification sur Hériter du parent.
  20. Cliquez sur Envoyer.
  21. Rouvrez la méthode HTTP POST que vous venez de créer.
    ouverture de la méthode POST
  22. En bas de la page, sélectionnez Aperçu de l’utilisation du script.
    copie du texte
  23. Copiez le texte.
  24. Recherchez et sélectionnez Règles de gestion.
    Servicenow. Règles de gestion recherchées et sélectionnées à gauche. Bouton Teal New en haut, centre
  25. Sélectionnez Nouveau.
  26. Sélectionnez une table.
    Zones vitales surlignées en rouge sur la page
  27. Sélectionnez Avancé.
  28. Déterminez quand la règle de gestion est exécutée.
    Exemple : si vous avez sélectionné Incident pour votre table et que vous voulez envoyer une enquête CSAT pour les tickets résolus, vous pouvez ajouter une condition indiquant que cette règle doit s’exécuter lorsque le statut de l’incident passe à Résolu.
    Astuce Qualtrics : le support de Qualtrics peut vous aider à configurer votre événement JSON et à le connecter via ServiceNow. Cependant, il peut y avoir des questions sur la fonctionnalité ServiceNow auxquelles ils ne peuvent pas répondre. Si vous avez des questions sur le mode/moment d’exécution des règles de gestion, consultez la documentation de ServiceNow sur le fonctionnement des règles de gestion.
  29. Accédez à l’onglet Avancé.
    Longlet Avancé souvre et le corps JSON est mis en surbrillance. Bouton Envoyer en bas
  30. Collez le contenu que vous avez copié depuis l’étape 22 où il indique Ajouter votre code ici.
    coller le contenu
  31. Ajoutez un corps. C’est ici que vous communiquez les informations que vous souhaitez transmettre à Qualtrics.
    ajout dun corps

    Exemple : il s’agit d’un exemple du code final que vous incluez dans ce champ. La plupart de ce code est le message sortant fourni par ServiceNow et variera d’un exemple à l’autre. Malheureusement, le support de Qualtrics ne peut pas vous aider avec un code personnalisé. Si vous rencontrez des problèmes avec votre code, veuillez contacter la communauté de ServiceNow pour obtenir de l’aide.

    La partie en gras du code inclut trois fonctions supplémentaires non incluses dans le code d’origine : un corps JSON qui extrait l’ID utilisateur et le statut de l’incident, et un appel qui récupère l’adresse e-mail du client de l’incident afin qu’il puisse être envoyé au CSAT (en italique ci-dessous). Consultez la documentation de ServiceNow et consultez leur communauté si vous avez d’autres questions.

    (function executeRule(current, before /*null when async*/) {
    
         // Ajoutez votre code ici
        
      essayez { 
         var r = new sn_ws.RESTMessageV2('Qualtrics JSON Event ', 'JSON Event POST');
         var body = {
              "User ID": gs.getUserID()
              "incident state": current.state.getDisplayValue; }()
         ;
         
         var target = new GlideRecord('sys_user');
          target.addQuery('sys_id', '=', current.caller_id);
          target.query();
          While(target.next()) {
              body["email"] = target.email.getDisplayValue();
          }      
          var response = r.execute();
          var responseBody = response.getBody();
          var httpStatus = response.getStatusCode();
          gs.addInfoMessage(httpStatus);
         }
     catch(ex) {
          var message = ex.message;
          gs.addInfoMessage("Error communicant w Qualtrics " + message);
    
    } 
    
    )(current, before);
  32. Ajoutez le corps à la demande. Ajoutez ce qui suit sous la partie en italique en gras du code de l’étape précédente :
     r.setRequestBody(JSON.stringify(body)) ; 
  33. Cliquez sur Envoyer.
  34. Dans Qualtrics, terminez votre workflow. Pour poursuivre l’exemple de l’enquête CSAT, nous ajouterons probablement Tâche du répertoire XM.
    choisir la tâche du répertoire xm
  35. N’oubliez pas de publier les modifications apportées à votre enquête lorsque vous êtes prêt à la lancer.

Exemple : intégration à Microsoft Dynamics via Microsoft Flow

Astuce Qualtrics : ceci est distinct de la tâche Microsoft Dynamics.

L’événement JSON l’entraîne afin que les événements dans Microsoft Dynamics puissent ensuite déclencher des tâches dans Qualtrics, telles que la création d’un ticket ou la distribution d’une enquête. Par exemple, lorsque vous supprimez un enregistrement de compte dans Microsoft, vous pouvez distribuer une enquête Qualtrics au titulaire du compte qui pose des questions de sortie. (Par exemple, nous sommes désolés de vous voir partir ! Comment s’est passé ton temps avec nous ? Comment pouvons-nous nous améliorer?)

Afin d’intégrer l’événement JSON aux actions qui se produisent dans Microsoft Dynamics, vous devez en fait effectuer la configuration dans Microsoft Flow au lieu de Dynamics. Ne vous inquiétez pas – Microsoft Flow est gratuit avec chaque compte Microsoft Dynamics, vous pouvez donc vous connecter à Flow avec vos informations Dynamics ici.

Astuce Qualtrics : le support de Qualtrics peut vous aider à configurer votre événement JSON et à le connecter via Microsoft Flow et Microsoft Dynamics. Cependant, il peut y avoir des questions sur les fonctionnalités de Microsoft auxquelles ils ne peuvent pas répondre. Si vous avez des questions sur Microsoft, essayez de consulter leur documentation pour Flow et leurs ressources pour Dynamics.
  1. Dans Qualtrics, définissez votre Événement sur Événement JSON.
    sélection de lévénement JSON
  2. Copiez l’URL.
    cliquer sur Copier URL dans lévénement JSON
  3. Dans un onglet distinct, accédez à https://us.flow.microsoft.com/en-us/ et utilisez vos informations Microsoft Dynamics pour vous connecter au flux.
  4. Sélectionnez Mes flux à gauche.
    Le coin le plus à gauche du flux microsoft, mes flux sélectionnés dans la 3e option du menu de gauche et le nouveau bouton en haut cliqué et développé pour afficher loption troisième de la liste automatisé à partir dune option vide
  5. Cliquez sur Nouveau et sélectionnez Automatique – vide.
  6. Nommez le flux.
    Créez une fenêtre de flux automatique. Image et instructions à gauche, étapes décrites à droite de la fenêtre en descendant la ligne
  7. Sélectionnez un déclencheur. C’est l’événement qui se produit dans Microsoft qui démarrera la tâche dans Qualtrics. Vous pouvez choisir ce qui sert vos objectifs, mais pour cet exemple, nous sélectionnerions “Quand un enregistrement est supprimé (Dynamics 365)”.
  8. Cliquez sur Créer.
  9. Sous Nom de l’organisation, connectez-vous à votre compte Dynamics.
    Zoom sur lorsquun enregistrement supprimé avec des champs de nom dorganisation et de nom dentité directement en dessous. nouveau bouton détape en bas, à gauche du centre
  10. Sous Nom de l’entité, sélectionnez le type d’enregistrement ou de fichier. Pour notre exemple, nous utiliserions « Comptes ».
  11. Cliquez sur Étape suivante et sélectionnez Ajouter une action.
  12. Sélectionnez HTTP.
    http et options étendues
  13. Remplacez la méthode par POST.
  14. Collez l’URL de votre événement JSON dans la zone URI.
  15. Utilisez l’authentification par jeton. Sous En-têtes, saisissez X-API-TOKEN et collez votre jeton API dans la zone en regard de celle-ci.
  16. Sous Corps, vous pouvez saisir un corps JSON. Cela vous aide à décider des informations que vous souhaitez transmettre de Dynamics à Qualtrics.
    Astuce Qualtrics : utilisez le bouton Ajouter du contenu dynamique pour sélectionner les champs d’enregistrement Dynamics que vous souhaitez transférer à Qualtrics. Assurez-vous de respecter le format JSON approprié, tel qu’affiché dans la capture d’écran. Pour obtenir de l’aide sur la résolution des problèmes liés au contenu dynamique, contactez le support de Microsoft.
  17. Lorsque vous avez terminé, cliquez sur Sauvegarder.
  18. Dans Qualtrics, terminez votre workflow. Dans cet exemple, nous ajoutons probablement Tâche du répertoire XM.
    Sélection de lévénement de répertoire xm
  19. N’oubliez pas de publier les modifications apportées à votre enquête lorsque vous êtes prêt à la lancer.
Astuce Qualtrics : le flux Microsoft est préféré pour ces étapes, car il est en mesure d’envoyer plus d’informations à Qualtrics dans le corps JSON. Si vous configurez cela dans Microsoft Dynamics au lieu de Flux, seuls les champs modifiés lors de l’événement Dynamics seront envoyés à Qualtrics. Par exemple, si vous choisissez d’effectuer le déclenchement en fonction d’une mise à jour de l’enregistrement et que seul un champ « e-mail » est modifié, « nom » et « adresse » ne seront pas envoyés à Qualtrics, même si vous demandez spécifiquement ces champs dans le corps. Le flux enverra tout ce que vous avez demandé à Qualtrics, que ce champ ait ou non été modifié dans l’événement déclencheur.

Exemple : intégration à Genesys PureCloud

Astuce Qualtrics : pour configurer cette intégration, vous devez avoir accès aux actions sur les données de Genesys Cloud Architect et Genesys Web Service.

À l’aide des événements JSON, vous pouvez intégrer Genesys PureCloud pour envoyer aux clients une enquête de suivi après avoir répondu à une interaction par téléphone avec l’assistance ou par discussion en direct.

  1. Dans l’enquête que vous souhaitez envoyer, accédez à Workflows.
    en cliquant sur Créer un workflow, puis sur la base dévénements
  2. Créez un workflow basé sur des événements.
  3. Pour l’événement de workflow, sélectionnez l’événement JSON.
    sélection de lévénement JSON
  4. Cliquez sur Copier URL pour copier le point de terminaison de l’événement dans votre presse-papiers.
    Cliquer sur Copier lURL
  5. Sans fermer la fenêtre Événement JSON, ouvrez un nouvel onglet dans votre navigateur et accédez à Genesys.
  6. Accédez à Admin.
    accéder aux actions à partir de longlet Administrateur
  7. Cliquez sur Actions.
  8. Cliquez sur Ajouter une action.
    le bouton Ajouter action
  9. Sélectionnez Services Web Actions sur les données comme Nom d’intégration.
    en donnant un nom à lintégration et en donnant un nom à laction

    Astuce Qualtrics : si vous n’avez pas la possibilité de sélectionner les actions sur les données des services Web, vous devez activer l’intégration. Consultez cette page pour plus d’informations.
  10. Attribuez un nom d‘action à votre action.
  11. Cliquez sur Ajouter.
  12. Accédez à l’onglet Configuration.
    sélection de JSON et définition de nos propriétés dans longlet de configuration des contrats
  13. Accédez à l’onglet Contrats.
  14. Sous Contrat entrant, sélectionnez JSON.
  15. Configurez les propriétés envoyées à Qualtrics.

    Exemple : par exemple, le code ci-dessous transmettra l’adresse e-mail, le numéro de téléphone, le prénom et le nom de famille.

    {
            "type": "object",
            "properties": {
              "emailAddress": {
                "type": "string"
              },
              "phoneNumber": {
               "type": "string"
              },
              "firstName": {
               "type": "string"
              },
              "lastName": {
               "type": "string"
              }
           ,
            "additionalProperties": true
         
  16. Accédez à l’onglet Configuration.modification de la demande en POST et collage de notre URL JSON
  17. Modifiez le type de demande en POST.
  18. Dans le champ Modèle d’URL de demande, collez l’URL de l’événement JSON dans Qualtrics.
  19. Cliquez sur Ajouter un en-tête.
    en ajoutant notre jeton API en tant qu’en-tête
  20. Dans la zone Clé, saisissez X-API-TOKEN.
  21. Dans la zone Valeur, saisissez votre jeton API Qualtrics.
  22. Accédez à l’onglet Test.ajout de valeurs de test avant lexécution dun test
  23. Saisissez des valeurs de test pour vos propriétés.
  24. Cliquez sur Exécuter l’action.
  25. Genesys vous dira si l’action a réussi. En cas d’échec, la réponse à l’erreur s’affiche pour vous aider à résoudre le problème.
    le message daction de réussite
  26. Revenez à votre événement JSON dans Qualtrics et vérifiez que vos propriétés ont bien été transmises à Qualtrics.afficher les données utiles du test et cliquer sur Sauvegarder ;
  27. Cliquez sur Enregistrer.
  28. Cliquez sur le signe plus ( + ), puis sur Tâche pour configurer la tâche que vous souhaitez suivre lorsque l’événement JSON est déclenché. Dans notre cas, nous souhaitons envoyer une enquête aux répondants, donc nous sélectionnons la tâche de répertoire XM.Cliquer sur le signe plus, puis sur la tâche
    Astuce Qualtrics : lors de la configuration de votre tâche, utilisez le menu de texte inséré pour utiliser les valeurs transmises par Genesys (e-mail du client, nom, etc.).
  29. Après avoir configuré la tâche dans Qualtrics, revenez à Genesys et cliquez sur Enregistrer & Publier.
    publication de laction
  30. Cliquez sur Oui.
  31. Accédez à Admin.sélection de larchitecte dans la page dadministration
  32. Cliquez sur Architecte.
  33. Sélectionnez Invitation à l’enquête dans le menu déroulant de la procédure.sélectionner une invitation à une enquête dans le menu déroulant du flux
  34. Cliquez sur Ajouter.en donnant un nom, une description et une division au flux
  35. Donnez à votre flux un Nom, une Description et une Division.
  36. Cliquez sur Créer un flux.
  37. Sous la section Données de votre Boîte à outils, sélectionnez Appeler une action sur les données et faites-la glisser dans la zone de liste déroulante du flux.faisant glisser le titre de laction sur les données Appeler dans le flux
  38. Donnez un nom à votre action.en donnant un nom à laction sur les données dappel, en sélectionnant la catégorie et en sélectionnant laction sur les données créée précédemment ;
  39. Pour la Catégorie, sélectionnez Services Web Action sur les données.
  40. Pour Action sur les données, sélectionnez l’action sur les données que vous avez créée précédemment.
  41. En regard de chaque propriété, cliquez sur le menu déroulant et sélectionnez Expression.ajout dexpressions à chaque propriété
  42. Pour les valeurs de propriété, saisissez les données envoyées pour chaque propriété. La zone renseignera automatiquement vos champs au fur et à mesure de votre saisie.
    Astuce Qualtrics : toutes les propriétés par défaut de cette page sont incluses dans le flux d’invitation à l’enquête. Vous pouvez également utiliser des expressions complexes lorsque des informations de contact client sont manquantes ou nécessitent un formatage supplémentaire.
    Astuce Qualtrics : les informations de contact sont précédées de Survey.CustomerContact.
  43. Cliquez sur la case en bas de votre flux.ajout de laction dinterruption de lenquête à la fin du flux
  44. Sélectionnez Boîte à outils, puis Invitations à l’enquête, puis Interrompre l’enquête.
  45. Sélectionnez opt-in pour la disponibilité.modification de la disponibilité en opposition avant la publication du flux
  46. Cliquez sur Publier. Genesys validera le flux puis le publiera. Une fois cette opération effectuée, le flux est en place et commencera à envoyer des enquêtes aux clients une fois qu’ils auront terminé leurs interactions avec le support.

FAQ

De nombreuses pages de ce site ont été traduites de l'anglais en traduction automatique. Chez Qualtrics, nous avons accompli notre devoir de diligence pour trouver les meilleures traductions automatiques possibles. Toutefois, le résultat ne peut pas être constamment parfait. Le texte original en anglais est considéré comme la version officielle, et toute discordance entre l'original et les traductions automatiques ne pourra être considérée comme juridiquement contraignante.