Passer au contenu principal
Loading...
Skip to article
  • Qualtrics Platform
    Qualtrics Platform
  • Customer Journey Optimizer
    Customer Journey Optimizer
  • XM Discover
    XM Discover
  • Qualtrics Social Connect
    Qualtrics Social Connect

É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 : Les Evènements JSON ne sont disponibles que pour les utilisateurs qui ont acheté l’accès à l’API Qualtrics. Si vous souhaitez bénéficier de cette fonction, adressez-vous à votre Commercial ou à votre XM Success Manager.

À propos de l’évènement JSON

Avez-vous déjà souhaité qu’une requête effectuée sur votre site web déclenche la création d’un ticket dans Qualtrics ? Avez-vous déjà voulu créer une intégration transparente entre Qualtrics et votre propre système interne ? Avez-vous déjà voulu déclencher une tâche dans l’onglet Flux de travail, mais avec un évènement qui se produit en dehors de Qualtrics ?

Les évènements JSON permettent à des logiciels externes de lancer des flux de travail via une requête HTTP. Au lieu d’attendre qu’un événement dans Qualtrics déclenche une action supplémentaire dans la plateforme, vous pouvez simplement configurer un évènement JSON pour recevoir des demandes d’un tiers.

Astuce : Vous devez générer une clé API avant que cette fonction ne soit disponible. Si vous disposez déjà d’une clé API, vous n’avez pas besoin d’en générer une nouvelle.
Attention: La mise en place d’un évènement JSON nécessite des connaissances avancées en programmation. Bien que notre équipe d’assistance soit heureuse de vous aider à mettre des informations dans l’évènement, nous ne pouvons pas vous aider 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 suivis et configurations suivants :

  • Tout ce qui n’est pas HTTP (par exemple, file d’attente de messages, SMS).
  • Appels HTTP sortants.
  • Traiter le XML (le corps de la requête XML sera ignoré).
  • Traiter tout ce qui n’est pas du JSON.
  • S’authentifier autrement que par un en-tête X-API-TOKEN ou notre authentification de base HTTP modifiée.
    Astuce : OAuth et d’autres formes d’authentificateurs sont incompatibles avec les évènements JSON.
  • Toute analyse JSON qui ne peut être satisfaite par l’utilisation de requêtes JSONPath sur le corps JSON.
  • Appels dépassant la limite de débit de l’API de 3 000 par minute.
  • Charges utiles supérieures à 100 KB.

Types d’authentification pris en charge

Auth à base de jetons / Auth à base d’en-têtes

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

Exemple: Dans l’exemple POST suivant, nous spécifions dans cURL l’URL de base, le Content-Type et le Token dans l’en-tête. L’ID de l’enquête et le format de l’exportation sont spécifiés dans le corps

.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'

Auth de base HTTP

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

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

Exemple : Disons que votre nom d’utilisateur Qualtrics est demo@qualtrics.com et que votre clé API est f8gIK7G6GFH985Y4. Vous écrivez d’abord,

 demo@qualtrics.com:f8gIK7G6GFH985Y4

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

 Basic ZGVtb0BxdWFsdHpY3MuY29tOmY4Z0lLN0c2R0ZIOTg1WTQ=

L’en-tête Authorization que vous ajoutez à votre requête HTTP aura donc la valeur Basic ZGVtb0BxdWsdHJpY3MuY29tOmY4Z0lN0c2R0ZIOTg1WTQ=.

Astuce : Consultez ces outils pour encoder base64 et décoder base64.

Mise en place d’un évènement JSON

  1. Tout d’abord, vous devez créer un flux de travail. Accédez à la page des Flux de travail autonomes.
    Dans longlet Flux de travail, cliquer sur créer un flux de travail et le lancer à la réception dun évènement

    Astuce : Vous pouvez également utiliser des évènements JSON dans la fonction Onglet FLUX DE TRAVAIL dans un projet. Nous recommandons d’ajouter un flux de travail à un projet spécifique uniquement s’ils sont explicitement liés. (Évènement : vous distribuez ce projet avec l’évènement JSON)
  2. Assurez-vous d’être dans l’onglet Vos flux de travail.
  3. Cliquez sur Créer un flux de travail.
  4. Sélectionnez Évènement lors de la réception d’un évènement.
  5. Sélectionnez l’évènement JSON .
    choisir lévènement JSON pour lancer le flux de travail
  6. Si vous le souhaitez, indiquez un résumé du Déclencheur, qui doit décrire l’objectif de l’évènement JSON. lajout dun résumé, la copie du point final et lactivation de lauthentificateur
  7. Vous recevrez une URL. Utilisez ceci pour invoquer 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 la copier, cliquez sur Copier l’URL.
  8. Par défaut, les évènements JSON nécessitent une authentification. Si vous souhaitez autoriser les demandes non authentifiées, vous pouvez désactiver l’option Require authentication by Qualtrics.
  9. Vous pouvez maintenant définir les données de l’évènement. Cela permet de capturer les données de la demande entrante. Pour commencer, cliquez sur Paramètres avancés.
    définition des données dévènement dans la section des paramètres avancés

    Astuce : Pour plus d’informations sur la section Test, voir la section Capture d’événements ci-dessous.
  10. Dans la case de gauche, donnez le nom du champ JSON. Dans la case de droite, indiquez l’emplacement dans les données de l’évènement (corps de la requête HTTP).
    Astuce : les emplacements doivent être au format JSONPath ! Voir le tableau ci-dessous pour un guide rapide de la syntaxe JSONPath.
  11. Pour ajouter un autre champ, cliquez sur Ajouter un champ JSON.
  12. Si vous souhaitez ajouter un paramètre de requête, ajoutez-le dans la section Paramètres de requête. Pour en savoir plus sur la nature de ces paramètres et leur fonctionnement dans l’API, consultez notre documentation sur les paramètres de l’API.
    Avertissement : Il est déconseillé de transmettre des informations personnellement identifiables par le biais des paramètres QUERY. Toute information personnelle identifiable ou donnée sensible doit être transmise via le corps POST dans la mesure du possible, car POST est plus sûr. Veuillez contacter le support de Qualtrics si vous avez des questions ou des préoccupations.
  13. Pour supprimer un champ, cliquez sur le signe moins ( ).
  14. Pour enregistrer vos modifications, cliquez sur Enregistrer.
  15. Vous pouvez maintenant ajouter des conditions et une tâche à votre flux de travail en cliquant sur le signe plus ( + ). Les conditions déterminent l’exécution d’un flux de travail, tandis que les tâches sont le résultat du flux de travail. Voir le Création de flux DE TRAVAIL pour plus d’informations.
    en cliquant sur le signe plus, un menu apparaît avec les options ajouter une tâche et ajouter une condition

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

Attention : Un événement JSON ne peut être déclenché via l’API qu’à partir du compte qui a créé l’événement. Si un compte différent est utilisé pour déclencher l’API pour un évènement JSON, vous pouvez toujours recevoir une réponse d’API 202-success, mais cela signifie qu’un clé API valide a été utilisée pour faire une demande valide, mais ne signifie pas nécessairement que la clé api correcte a été utilisée, ou que l’évènement JSON a été déclenché correctement. Si vous recevez un message API 202-success, vous devrez vérifier la plateforme pour confirmer que la bonne API a été utilisée.

&nbsp ;

Capturer les évènements

Lorsque vous créez un évènement API externe, vous pouvez avoir besoin d’analyser les données du corps du message. Cependant, il est parfois difficile d’analyser ces informations. Si vous voulez savoir ce que votre API externe envoie, suivez les étapes suivantes.

  1. Cliquez sur votre évènement JSON.
    sélection de lévènement JSON
  2. Par défaut, l’option Capturer les champs JSON des résultats du test afin qu’ils puissent être utilisés comme texte inséré dans d’autres tâches de ce flux de travail est activée. Cette option fait en sorte que les champs analysés dans le corps du payload soient automatiquement disponibles en tant que texte inséré lorsque vous ajoutez vos tâches de flux de travail.
    en cliquant sur 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. Activez votre API externe.lÉvènement JSON qui attend de recevoir un évènement de votre système externe
    Astuce : pour annuler ce test, cliquez sur Annuler le test.
  5. Si le test a réussi, vous verrez apparaître le message Successfully connected to the server (Connexion réussie au serveur). La charge utile sera analysée et ajoutée à la fenêtre.un test réussi - la charge utile JSON se trouve dans la fenêtre de lévènement
  6. Si vous le souhaitez, cliquez sur Exécuter un nouveau test pour lancer un autre test. Vous devrez lancer votre prochain appel à l’API après avoir cliqué sur cette option.
  7. Cliquez sur Enregistrer.

Syntaxe de JSONPath

Le tableau ci-dessous présente quelques principes de base de la syntaxe JSONPath. Notez qu’elles ne sont pas établies par Qualtrics, mais qu’il s’agit de normes utilisées avec JSON.

Attention: La mise en place d’un évènement JSON nécessite des connaissances avancées en programmation. Bien que notre équipe d’assistance soit heureuse de vous aider à mettre des informations dans l’évènement, nous ne pouvons pas vous aider sur les aspects de programmation. Vous pouvez toujours essayer de demander à notre communauté d’utilisateurs dévoués.
JSONPath Description Exemple
$ L’objet/élément racine $.stores[0].name
@ L’objet/élément actuel $.stores[ ?(@.name===”ACME Store”)]
. Opérateur enfant $.eventDescription
.. Opérateur descendant récursif $.stores[0]..price
* Carte joker $.stores[*].name
[] Opérateur d’indice $.stores[0].name
[,] Opérateur de l’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 scripturale $.stores[(@.length-1)]

Exemple de syntaxe JSONPath

Dans cet exemple, nous allons vous montrer comment, étant donné un objet JSON, la table JSONPath peut être utilisée.

Il s’agit de notre objet JSON :

{
"eventDescription" : "Revenu mensuel",
"stores" : [
{
"name" : "Magasin Acme",
"total" : 1000000,
"topItem" :

{ "price" : "50", "description" : "Enclume" }
},
{
"name" : "Le stand des bananes",
"total" : 250000,
"topItem" :

{ "price" : "4", "description" : "Le Gob" }
},
{
"name" : "Pizza Planet",
"total" : 80000,
"topItem" :

{ "price" : "15", "description" : "Pepperoni" }
}
]
}

Maintenant, nous devrions ajouter les valeurs de retour que nous voyons dans le tableau JSONPath pour que ce soit plus clair.

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

{ "price" : "50", "description" : "Enclume" }
}
]
. -> ; Revenu mensuel
. -> ; 50

-> ; ["Acme Store", "The Banana Stand", "Pizza Planet"]
[] -> ; Acme Store
[,] -> ; [
Unknown macro : { "name"}
,

Unknown macro : { "name"}
]

**Changez l'exemple de [start:end:step] en "$.stores[1:3:1]"
[start:end:step] -> ; [
{
"name" : "Le stand des bananes",
"total" : 250000,
"topItem" :

{ "price" : "4", "description" : "Le Gob" }
},
{
"name" : "Pizza Planet",
"total" : 80000,
"topItem" :

{ "price" : "15", "description" : "Pepperoni" }
}
]

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

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

() -> ; [
{
"nom" : "Pizza Planet",
"total" : 80000,
"topItem" :

{ "price" : "15", "description" : "Pepperoni" }
}
]

Exemple d’API en Node Javascript

L’exemple ci-dessous est un modèle de base que vous pouvez suivre pour formater vos données d’évènements.

Attention: La mise en place d’un évènement JSON nécessite des connaissances avancées en programmation. Bien que notre équipe d’assistance soit heureuse de vous aider à mettre des informations dans l’évènement, nous ne pouvons pas vous aider sur les aspects de programmation. Vous pouvez toujours essayer de demander à notre communauté d’utilisateurs dévoués.
var request = require('request-promise') ;
var surveyId = "SV_XXXXXXXXXXXX" ;
var triggerId = "OC_XXXXXXX" ;
var brandId = "YOUR_BRAND_ID" ;
var userId = "UR_XXXXXXXXXXXXX" ;
var datacenter = "xx1" ;
var apiToken = "YOUR_QUALTRICS_API_TOKEN" ;

var url = "https ://" + datacenter + ".qualtrics.com/inbound-event/v1/event/JSON/triggers" +
     "?contextId=" + surveyId + "&userId=" + userId + "&brandId=" + brandId + "&triggerId=" + triggerId ;
var payload = {
    "text" : "This is some text",
    "object" : {
        "number" : 4
    },
    "array" : ["a", "b", "c", "d"]
} ;

var options = {
    url : url,
    json : true,
    body : payload,
    headers : {
        "Content-Type" : "application/json", // OBLIGATOIRE ! !!
        "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

Astuce : Cette tâche est distincte de la tâche Freshdesk.

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

Astuce : le support de Qualtrics peut vous aider à configurer votre évènement JSON et à le connecter via Freshdesk. Cependant, il se peut qu’ils ne puissent pas répondre à certaines questions concernant les fonctionnalités de Freshdesk. Si vous avez des questions sur la côte à côte de Freshdesk, essayez de consulter leur documentation sur les règles de Dispatch’r.
  1. Dans Qualtrics, réglez votre évènement sur JSON Évènement.
    sélection de lévènement JSON
  2. Copiez l’URL.
    cliquer sur copier lURL dans lévènement JSON
  3. Dans un nouvel onglet, connectez-vous à Freshdesk.
  4. Dans la section Admin, naviguez jusqu’à 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 service dassistance lorsque vous avez cliqué sur lengrenage dadministration dans la barre latérale à gauche

    Astuce : découvrez la différence entre le Dispatch’r, le Superviseur et l’Observateursur la documentation d’assistance de Freshdesk.
  5. Créer une nouvelle règle.
    Bouton "Nouvelle règle" en noir en haut à droite
  6. Ensemble de 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é lorsque le ticket est résolu. Ensemble de conditions à lexemple donné ici, le statut est résolu. Laction est développée de manière à ce que le Déclencheur Webhook soit affiché

    Exemple : Peut-être que lorsqu’un agent Freshdesk fait en sorte que le statut du ticket passe de n’importe quel statut à Résolu, vous aimeriez envoyer une enquête CSAT à l’aide de Qualtrics.
  7. Ajoutez une nouvelle action et sélectionnez Déclencheur Web Hook.
    Le menu de laction est développé et le déclencheur webhook est surligné
  8. Définissez le type de requête sur POST.
    Le champ Type dévènement indique POST et lURL de rappel contient lURL de lévènement JSON
  9. Dans Callback URL, collez l’URL de l’évènement JSON de l’étape 2.
  10. Pour utiliser l’authentification par jeton, ajoutez des en-têtes personnalisés, entrez X-API-TOKEN : et mettez-le égal à votre jeton API.
    Dans len-tête personnalisé, il est indiqué X-API-TOKEN :, puis une clé api floue
  11. Pour utiliser l’authentification HTTP Basic, cliquez sur Requires Authentication, ajoutez votre nom d’utilisateur Qualtrics, puis à la place de votre mot de passe, entrez votre clé api.
    Authentificateur de base - loption "authentificateur requis" a été sélectionnée et les informations susmentionnées ont été remplies
  12. Assurez-vous que l’encodage est JSON.
    Lencodage est JSON et lemail du demandeur est sélectionné dans le corps du message
  13. Sélectionnez manuellement le contenu à transmettre ou choisissez Avancé pour saisir un corps JSON.
  14. Sauvegardez votre règle.
  15. Dans Qualtrics, terminez votre flux de travail. Dans cet exemple, nous ajouterions probablement une tâcheEnvoyer l’enquête par e-mail ou Envoyer l’enquête par SMS.
    dans la fenêtre de choix dune tâche, a cherché envoyer une enquête, et une option pour envoyer par e-mail et par message texte est apparue
  16. N’oubliez pas de publier les modifications apportées à votre enquête lorsque vous êtes prêt à la lancer.
Astuce : Pour en savoir plus sur les Webhooks de Freshdesk, consultez la documentation liée sur leur site d’assistance.

Exemple : Intégration avec ServiceNow

Astuce : Il s’agit d’une tâche distincte de la Tâche ServiceNow.

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

Astuce : Le support de Qualtrics peut vous aider à configurer votre évènement JSON et à le connecter via ServiceNow. Cependant, il se peut qu’ils ne puissent pas répondre à certaines questions concernant les fonctionnalités de ServiceNow. Si vous avez des questions sur la façon de vous connecter et d’activer votre instance de développeur ServiceNow, essayez de consulter leur documentation sur les Instances de développeur personnel.
  1. Dans Qualtrics, définissez votre évènement comme étant un évènement JSON.
    sélection de lévènement JSON
  2. Copiez l’URL.
    cliquer sur copier lURL dans lévènement JSON
  3. Dans un nouvel onglet, connectez-vous à votre instance de développeur ServiceNow.
  4. Sélectionnez Message REST.
    choisir un message REST
  5. Cliquez sur Nouveau.
  6. Donnez un nom à votre message de Rest.
    donner un nom au message, spécifier le point de terminaison et choisir le type dauthentificateur
  7. Dans le champ Endpoint, collez l’URL que vous avez copiée à l’étape 2.
  8. Modifier le type d’Authentificateur en Basique.
  9. Allez dans l’onglet Requête HTTP.
    en choisissant la requête HTTP et en ajoutant le X-API-TOKEN
  10. Double-cliquez pour ajouter X-API-TOKEN.
  11. Double-cliquez pour coller votre clé API.
    coller la clé API
  12. Dans une nouvelle ligne, ajoutez le nom Content-type.
  13. Définir la valeur à application/json.
  14. Cliquez sur Envoyer.
    en cliquant sur Soumettre
  15. Rouvrez votre message Rest.
    ouverture du message REST
  16. Sous Méthodes HTTP, cliquez sur Nouveau.
    cliquant sur Nouveau
  17. Donnez un nom à la méthode.
    définir la technologie de linformation et lui donner un nom
  18. Définissez la méthode HTTP sur POST.
  19. Définissez le type d’Authentificateur sur Hériter du parent.
  20. Cliquez sur Envoyer.
  21. Rouvrez la méthode POST HTTP que vous venez de créer.
    ouvrir la méthode POST
  22. En bas de la page, sélectionnez Prévisualiser l’utilisation du script.
    copier le texte
  23. Copier le texte.
  24. Rechercher et sélectionner Règles de gestion.
    Servicenow. Les règles de gestion sont recherchées et sélectionnées à gauche. Teal New button top, center
  25. Sélectionnez Nouveau.
  26. Sélectionnez un tableau.
    Champs vitaux surlignés en rouge sur la page
  27. Sélectionnez Avancé.
  28. Déterminer quand la règle de gestion est exécutée.
    Exemple : Si vous avez sélectionné Incident pour votre table et que vous souhaitez envoyer une enquête CSAT pour les tickets résolus, vous pouvez ajouter une condition indiquant que cette règle doit être exécutée lorsque l’état Incident devient Résolu.
    Astuce : Le support de Qualtrics peut vous aider à configurer votre évènement JSON et à le connecter via ServiceNow. Cependant, il se peut qu’ils ne puissent pas répondre à certaines questions concernant les fonctionnalités de ServiceNow. Si vous avez des questions sur comment / quand les règles de gestion s’exécutent, veuillez consulter la documentation de ServiceNow sur le fonctionnement des règles de gestion.
  29. Allez dans l’onglet Avancé.
    Longlet Avancé est ouvert et le corps du JSON est surligné. Bouton de soumission en bas
  30. Collez le contenu que vous avez copié à l’étape 22, là où il est indiqué Ajouter votre code ici.
    coller le contenu
  31. Ajouter 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 de code final à inclure dans ce champ. La majeure partie de ce code correspond au message sortant fourni par ServiceNow et variera d’un exemple à l’autre. Malheureusement, le support de Qualtrics Assist ne peut pas vous aider avec un codage personnalisé ; si vous avez des problèmes avec votre code, veuillez contacter la communauté de ServiceNow pour obtenir de l’aide.

    La partie en gras du code comprend trois fonctions supplémentaires non incluses dans le code original : un corps JSON qui récupère l’ID utilisateur et l’état de l’incident, et un appel qui récupère l’adresse électronique du client victime de l’incident afin de lui envoyer le CSAT (en italique ci-dessous). Consultez la documentation de ServiceNow et consultez leur communauté si vous avez des questions supplémentaires.

    (function executeRule(current, previous /*null when async*/)) {
    
        // Ajoutez votre code ici
        
     try { 
         var r = new sn_ws.RESTMessageV2('Qualtrics JSON Évènement ', 'JSON Évènement 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 communicating w Qualtrics " + message) ;
    
    }
    
    })(current, previous) ;
  32. Ajouter le corps de la requête. Ajoutez ce qui suit sous la partie en gras et en italique du code de l’étape précédente :
     r.setRequestBody(JSON.stringify(body)) ; 
  33. Cliquez sur Envoyer.
  34. Dans Qualtrics, terminez votre flux de travail. Pour reprendre l’exemple de l’enquête CSAT, nous ajouterions probablement une tâcheEnvoyer l’enquête par e-mail ou Envoyer l’enquête par SMS.
    dans la fenêtre de choix dune tâche, a cherché envoyer une enquête, et une option pour envoyer par e-mail et par message texte est apparue
  35. N’oubliez pas de publier les modifications apportées à votre enquête lorsque vous êtes prêt à la lancer.

Exemple : Intégration avec Microsoft Dynamics via Microsoft Flow

Astuce : Il s’agit d’une tâche distincte de celle de Microsoft Dynamics.

L’Évènement JSON permet aux évènements de Microsoft Dynamics de déclencher des tâches dans Qualtrics, comme la création d’un ticket ou la distribution d’une enquête. Par exemple, lorsque vous supprimez un compte dans Microsoft, vous pouvez distribuer au propriétaire du compte une enquête Qualtrics qui pose des questions de sortie. (par exemple, “Nous sommes désolés de vous voir partir ! Comment s’est passé votre séjour parmi nous ? Comment pouvons-nous nous améliorer ?)

Pour intégrer l’Évènement JSON aux actions qui se déroulent 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 fourni gratuitement avec chaque compte Microsoft Dynamics. Vous pouvez donc vous connecter à Flow à l’aide de vos informations Dynamics ici.

Astuce : le support de Qualtrics peut vous aider à configurer votre évènement JSON et à le connecter via Microsoft Flow et Microsoft Dynamics. Cependant, ils ne peuvent pas répondre à certaines questions concernant les fonctionnalités de Microsoft. Si vous avez des questions concernant la côte à côte de Microsoft, essayez de consulter leur documentation pour Flow et leurs ressources pour Dynamics.
  1. Dans Qualtrics, réglez votre évènement sur JSON Évènement.
    sélection de lévènement JSON
  2. Copiez l’URL.
    cliquer sur copier lURL dans lévènement JSON
  3. Dans un autre onglet, allez sur https://us.flow.microsoft.com/en-us/ et utilisez vos informations Microsoft Dynamics pour vous connecter à Flow.
  4. Sélectionnez Mes flux sur la gauche.
    Coin supérieur gauche de microsoft flow, mes flux sélectionnés à partir de la troisième option du menu de gauche, et nouveau bouton en haut cliqué et développé pour afficher lautomatisme à partir de loption vide de la troisième liste
  5. Cliquez sur Nouveau et sélectionnez Automatisé – à partir du vide.
  6. Nommez le flux.
    Construire une fenêtre de flux automatisée. Image et instructions à gauche, étapes décrites à droite de la fenêtre en descendant la ligne
  7. Sélectionnez un déclencheur. Il s’agit de l’évènement qui se produit dans Microsoft et qui déclenche la tâche dans Qualtrics. Vous pouvez choisir ce qui vous convient, mais pour cet exemple, nous choisirons “Lorsqu’un enregistrement est supprimé (Dynamics 365)”
  8. Cliquez sur Créer.
  9. Sous Nom de l’organisation, connectez-vous à votre compte Dynamics.
    zoom sur la suppression dun enregistrement avec les champs nom de lorganisation et nom de lentité directement en dessous. bouton nouvelle étape en bas, à gauche du centre
  10. Sous Nom de l’entité, choisissez le type d’enregistrement ou de fichier. Pour notre exemple, nous utiliserons “Comptes”
  11. Cliquez sur l’étape suivante et sélectionnez Ajouter une action.
  12. Sélectionnez HTTP.
    http et options élargies
  13. Modifier la méthode en POST.
  14. Collez l’URL de votre évènement JSON dans le champ URI.
  15. Utiliser l’authentificateur à jeton. Sous En-têtes, entrez X-API-TOKEN et dans le champ suivant, collez votre clé api.
  16. Sous Corps, vous pouvez saisir un corps JSON. Cela vous aide à décider des informations que vous souhaitez transmettre de Dynamics à Qualtrics.
    Astuce : Utilisez le bouton Ajouter un contenu dynamique pour sélectionner les champs de l’enregistrement Dynamics que vous souhaitez transférer dans Qualtrics. Veillez à respecter le format JSON approprié, comme indiqué dans la capture d’écran. Pour obtenir de l’aide concernant le contenu dynamique, veuillez contacter le service d’assistance de Microsoft.
  17. Lorsque vous avez terminé, cliquez sur Enregistrer.
  18. Dans Qualtrics, terminez votre flux de travail. Dans cet exemple, nous ajouterions probablement une tâcheEnvoyer l’enquête par e-mail ou Envoyer l’enquête par SMS.
    dans la fenêtre de choix dune tâche, a cherché envoyer une enquête, et une option pour envoyer par e-mail et par message texte est apparue
  19. N’oubliez pas de publier les modifications apportées à votre enquête lorsque vous êtes prêt à la lancer.
Astuce : Microsoft Flow est préféré pour ces étapes car il est capable d’envoyer plus d’informations à Qualtrics dans le corps JSON. Si vous configurez cela dans Microsoft Dynamics au lieu de Flow, seuls les champs modifiés au cours de l’évènement Dynamics seront envoyés à Qualtrics. Par exemple, si vous choisissez de déclencher sur la base d’une mise à jour de l’enregistrement et que seul le champ “e-mail” est modifié, le “nom” et l'”adresse” ne seront pas envoyés à Qualtrics, même si vous demandez spécifiquement ces champs dans le corps du message. L’Évènement enverra à Qualtrics tout ce que vous avez demandé, que ce champ ait été modifié ou non lors de l’évènement déclencheur.

Exemple : Intégration avec Genesys PureCloud

Astuce : pour configurer cette intégration, vous devez avoir accès à Genesys Cloud Architect et à Genesys Web Service Data Actions.

À l’aide d’évènements JSON, vous pouvez intégrer Genesys PureCloud pour envoyer aux clients une enquête de suivi après avoir terminé une interaction d’assistance par téléphone ou par chat.

  1. Accédez à la page des Flux de travail globaux.
    en cliquant sur la création dun flux de travail, puis dun évènement
  2. Créer un nouveau flux de travail basé sur les évènements.
  3. Pour l’événement du flux de travail, sélectionnez l’événement JSON .
    choisir lévènement JSON
  4. Cliquez sur Copier l’URL pour copier le point de terminaison de l’évènement dans votre presse-papiers.
    en cliquant sur copier lURL
  5. Sans fermer la fenêtre de l’évènement JSON, ouvrez un nouvel onglet dans votre navigateur et naviguez vers Genesys.
  6. Naviguer vers Admin.
    laccès aux actions à partir de longlet administrateur
  7. Cliquez sur Actions.
  8. Cliquez sur Ajouter une action.
    le bouton dajout daction
  9. Sélectionnez Actions de données des services Web comme nom d’intégration.
    donner un nom à lintégration et donner un nom à laction

    Astuce : Si vous n’avez pas la possibilité de sélectionner les actions de données des services Web, vous devez activer l’intégration. Voir cette page pour plus d’informations.
  10. Donnez un nom à votre action.
  11. Cliquez sur Ajouter.
  12. Naviguez jusqu’à l’onglet Configuration.
    en sélectionnant JSON et en définissant nos propriétés dans longlet de configuration des contrats
  13. Allez dans l’onglet Contrats.
  14. Sous Contrat d’entrée, sélectionnez JSON.
  15. Configurez les propriétés qui sont envoyées à Qualtrics.

    Exemple : Par exemple, le code ci-dessous transmet l’adresse électronique, 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. Allez dans l’onglet Configuration .changer la requête en POST et coller notre url JSON
  17. Changez le type de requête en POST.
  18. Dans le champ Modèle d’URL de la demande, collez l’URL de l’Évènement JSON dans Qualtrics.
  19. Cliquez sur Ajouter un en-tête.
    ajouter notre clé API en tant quen-tête
  20. Dans la zone Clé , entrez X-API-TOKEN.
  21. Dans la case Valeur, entrez votre clé API Qualtrics.
  22. Allez dans l’onglet Test. ajouter des valeurs de test avant dexécuter un test
  23. Saisissez les valeurs de test pour vos propriétés.
  24. Cliquez sur Exécuter l’action.
  25. Genesys vous indiquera si l’action a réussi. En cas d’échec, la réponse d’erreur s’affiche pour vous aider à résoudre le problème.
    le message de réussite de laction
  26. Retournez à votre évènement JSON dans Qualtrics et vérifiez que vos propriétés ont été transmises à Qualtrics avec succès.en visualisant la charge utile du test et en cliquant sur Enregistrer
  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 voulons envoyer une enquête aux personnes interrogées. Nous sélectionnons donc la tâcheEnvoyer l’enquête par e-mail ou Envoyer l’enquête par SMS.En cliquant sur le signe plus puis sur la tâche
    Astuce : Lors de la configuration de votre tâche, utilisez le menu Texte inséré pour utiliser les valeurs transmises par Genesys (par exemple, l’e-mail du client, son nom, etc.).
  29. Après avoir configuré la tâche dans Qualtrics, retournez dans Genesys et cliquez sur Enregistrer & Publier.
    publier laction
  30. Cliquez sur Oui.
  31. Naviguer vers Admin.sélection dun architecte à partir de la page dadministration
  32. Cliquez sur Architecte.
  33. Sélectionnez ” Invitation à l’enquête ” dans le menu déroulant du flux.en sélectionnant linvitation à lenquête dans le flux denquête
  34. Cliquez sur Ajouter.donner au flux un nom, une description et une division
  35. Donnez à votre flux un nom, une description et une division.
  36. Cliquez sur Créer un flux.
  37. Dans la section Données de votre boîte à outils, sélectionnez Appeler une action de données et faites-la glisser vers la boîte de dépôt dans le flux.faire glisser le titre Call Data Action vers le flux
  38. Donnez un nom à votre action.en donnant un nom à laction de données dappel, en sélectionnant la catégorie et en sélectionnant laction de données que nous avons créée précédemment
  39. Pour la catégorie, sélectionnez Action de données des services Web.
  40. Pour Action de données, sélectionnez l’action de données que vous avez créée précédemment.
  41. Suivant chaque propriété, cliquez sur le menu déroulant et sélectionnez Expression.ajouter des expressions à chaque propriété
  42. Pour les valeurs des biens, indiquez les données envoyées pour chaque bien. La boîte remplit automatiquement les champs au fur et à mesure que vous les tapez.
    Astuce : Cette page contient toutes les propriétés par défaut incluses dans le flux d’invitation à l’enquête. Vous pouvez également utiliser des expressions complexes dans les situations où les informations de contact du client sont manquantes ou nécessitent un formatage supplémentaire.
    Astuce : Les informations de contact sont précédées de la mention Enquête.CustomerContact.
  43. Cliquez sur la case la plus basse de votre flux.lajout de laction dinterruption de lenquête à la fin du flux denquête
  44. Sélectionnez Boîte à outils, puis Invitations à l’enquête, puis Abandonner l’enquête.
  45. Sélectionnez optOut pour la disposition.la modification de la disposition relative à lopt-out avant de publier le flux
  46. Cliquez sur Publier. Genesys validera le flux et le publiera. Une fois cela fait, le flux est en place et commencera à envoyer des enquêtes aux clients lorsqu’ils terminent des interactions d’assistance.

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.