Cas d’utilisation API courants

À propos des cas d’utilisation d’API

Cette page met en évidence les façons dont d’autres clients Qualtrics tirent parti de l’API Qualtrics. Vous trouverez ci-dessous une liste des demandes d’API courantes que nos clients utilisent et les cas d’utilisation associés à chaque demande.

Méthodes courantes

Service Web

L’automatisation de la construction des demandes d’API est généralement effectuée par un spécialiste informatique de votre organisation, car ce processus nécessite la mise en œuvre d’un code personnalisé. Toutefois, dans certains cas, vous pouvez utiliser une enquête Qualtrics pour automatiser au lieu d’un code personnalisé. Les étapes ci-dessous montrent comment accomplir ce processus.

Suivez les étapes ci-dessous une fois que votre enquête a été construite :

1. Accédez à l’onglet Enquête et ouvrez votre Flux d’enquête.
   
2. Cliquez sur Ajouter ci-dessous ou Ajouter un nouvel élément ici.
3. Sélectionnez Service Web.
4. Insérez l’URL de la demande d’API dans la section Définition de la documentation.
   
5. Sélectionnez la méthode que vous souhaitez utiliser (par exemple, GET, PUT, POST ou DELETE).
   Attention : bien que PATCH soit disponible dans l’élément Service Web, il ne peut pas être utilisé avec l’API Qualtrics.
6. Cliquez sur Ajouter un en-tête personnalisé à envoyer au service Web.
7. Saisissez X-API-TOKEN dans la zone En-tête du service Web et votre jeton dans la zone Valeur.
   
8. Ajoutez tous les paramètres d’en-tête requis pour votre demande d’API en cliquant sur le signe plus (+).
9. Si vous avez défini la Méthode sur POST ou PUT, cliquez sur Ajouter un paramètre de corps à envoyer au service Web et saisissez tous les paramètres et valeurs requis.
10. Réglez la valeur de chaque paramètre à sa droite.
    Astuce Qualtrics : vous devrez utiliser du texte inséré pour les valeurs avec des données dynamiques, telles que Prénom, Nom et E-mail.

    

11. Si vous utilisez API v2.x dans l’élément Service Web, vous devez cliquer sur Ajouter un paramètre de requête à envoyer au service Web pour ajouter les paramètres d’URL et les valeurs pour les demandes.

JSON

Vous pouvez transmettre vos paramètres au format JSON via le texte de la demande. Lorsque vous utilisez cette méthode, vous devez préciser un type de contenu (c.-à-d. application/json ou texte/json). Cette méthode est généralement réalisée par un spécialiste informatique de votre organisation, car ce processus nécessite la mise en œuvre d’un code personnalisé.

Chaîne de requête

URL racine:

https://survey.qualtrics.com/WRAPI/ControlPanel/api.phpPour

le premier paramètre ajouté à l’URL racine, incluez un “?” suivi du nom du paramètre, d’un signe égal et de la valeur du paramètre (par exemple, ?Version = 2.4). Ajoutez tous les paramètres suivants avec une esperluette en tête “&” (par ex., &Request=importPanel).

URL racine + Paramètres requis :

https://survey.qualtrics.com/WRAPI/ControlPanel/api.php?Version=2.4&Request=importPanel
 &User=kathleenb_gen&Token=12345678901234567890&Format=XML

Continuez d’ajouter ou d’apposer d’autres paramètres supplémentaires à votre URL en suivant le même processus que celui décrit ci-dessus. Une fois que vous aurez inclus tous les paramètres souhaités, vous aurez une demande terminée.

URL racine + Paramètres requis + Paramètres supplémentaires :

https://survey.qualtrics.com/WRAPI/ControlPanel/api.php?Version=2.4&Request=importPanel
 &User=kathleenb_gen&Token=12345678901234567890&Format=XML
&LibraryID=UR_12345678901234567890&ColumnHeaders=1&Fs.com=3&URL=htt%Hph3A%3Headers=1&All2F2F2F2&URL=htt%Htric3A%3Tester=1&All2F2F2F2&
amp;URL=htt%Htric3A%
3Tester=1&

Vous trouverez plus d’informations sur les chaînes de requête sur notre page d’assistance Transmission d’informations via des chaînes de requête.

Plateforme d’enquête

Automatisation de l’importation d’une liste de contacts

Vous pouvez utiliser la demande Créer une importation de contacts pour importer des lots de contacts dans votre compte Qualtrics. Grâce à cette demande, vous pouvez importer des listes JSON d’individus à partir de votre CRM dans Qualtrics. Ces contacts peuvent être importés en chargeant un fichier JSON et en définissant le paramètre d’en-tête Content-Type sur multipart/form-data, ou en incluant les contacts dans le corps de la demande et en définissant Content-Type sur application/json.

Automatisation de la création d’un contact

Plutôt que de mettre à jour manuellement les listes de contacts avec de nouveaux membres, vous pouvez automatiser le processus à l’aide de la demande Créer un contact. Cette demande ajoute un nouveau contact à une liste de contacts existante. Pour cette demande, vous aurez besoin de l’ID de la liste de distribution et de tous les autres champs que vous souhaitez ajouter au contact. Ils devront être transmis dans le corps de la demande, en définissant Content-Type sur application/json.

Générer vos propres liens individuels

Vous devrez peut-être distribuer votre enquête par un courrier interne plutôt que par le courrier Qualtrics. Avec l’API Qualtrics, vous pouvez créer des liens individuels qui suivent les informations personnelles d’un répondant sans avoir à utiliser le distributeur Qualtrics.

Pour accomplir cette tâche, vous devez utiliser deux requêtes API : Créer des liens de distribution et de distribution. Avant de commencer, vous devrez importer une liste de contacts dans Qualtrics manuellement ou à l’aide de la demande d’API Créer Importation de contacts.

Les paramètres d’intérêt pour la demande Créer une distribution et Liens de distribution sont :

• ID de la liste de distribution (chaque distribution est liée à une liste de distribution)
• Identifiant de l’enquête
• Description (le nom de la distribution)
• Action (la valeur ici doit être CreateDistribution)

Automatiser le téléchargement de vos données en préparation de l’importation dans votre CRM

Si vous avez besoin de données provenant de nombreuses enquêtes au quotidien, vous pouvez utiliser notre API pour obtenir des réponses. L’API v3 utilise une série de trois demandes pour obtenir des données :

• Créer une exportation de réponse: cette demande lance le processus d’exportation et est utilisée pour indiquer le format de fichier et d’autres préférences. Cela renverra un ID d’exportation de réponse.
• Progression de l’exportation des réponses: cette demande est utilisée pour vérifier l’avancement de l’exportation à l’aide de l’ID d’exportation de réponse fourni dans la première demande. Une fois que percentComplete atteint 100, vous pouvez utiliser la dernière demande pour obtenir le fichier.
• Accéder au fichier d’exportation de la réponse: une fois le fichier prêt, vous pouvez utiliser cette demande pour le télécharger. Il sera exporté sous forme de fichier compressé. Veuillez noter que bien que la plupart des demandes d’API fonctionnent lorsque l’ID de centre de données n’est pas correct dans l’URL, cette demande ne fonctionnera pas. Veuillez vous assurer d’utiliser l’ID de centre de données correct dans cette demande.

Cette séquence de demandes télécharge vos données brutes, ce qui vous permet d’obtenir plus facilement vos données, puis d’importer ces réponses dans votre CRM, votre entrepôt de données, etc.

Répertoire XM

Mise à jour d’un contact (Liste des contacts du répertoire et Mise à jour d’un contact du répertoire)

Parfois, vous pouvez souhaiter mettre à jour un contact via l’API. Pour ce faire, vous aurez besoin de l’ID de contact du contact. La demande d’API Répertorier les contacts du répertoire vous permet de rechercher l’identifiant de contact d’un contact, que vous pourrez ensuite utiliser pour des demandes d’API ultérieures. Nous allons d’abord expliquer la demande d’API Répertorier les contacts du répertoire, puis Mettre à jour le contact du répertoire.

Tout ce dont vous aurez besoin pour la demande Contacts du répertoire de listes est l’identifiant du répertoire. Le résultat de la demande de contacts du répertoire de la liste sera de recevoir l’identifiant de contact du contact afin que vous puissiez ensuite l’utiliser pour les demandes telles que Mettre à jour le contact du répertoire.

Il existe alors deux paramètres principaux d’intérêt pour la demande de mise à jour du contact du répertoire : ID du répertoire et ID du contact. Suite à la demande de mise à jour du contact du répertoire, le contact spécifié sera mis à jour avec toutes les informations que vous avez modifiées en fonction des paramètres de votre demande.

Guides de solution API

Vous trouverez différents guides de solutions pour la gestion des enquêtes, la gestion des utilisateurs, la gestion des groupes d’utilisateurs et l’obtention des réponses aux enquêtes sur notre site Web de documentation de l’API v3.