7. Mon premier appel aux services Web

Pour vous familiariser avec les services Web de Dialog Insight, rien de mieux que se lancer dans le code dès maintenant. Nous allons donc réaliser ensemble un premier appel dans votre projet test. Pour cet exemple, nous utiliserons la méthode Contacts.Merge, idéale pour débuter. Cette méthode permet en un seul appel de créer un contact ou de mettre à jour ses informations s’il existe déjà.

Préalables

• Créer un projet test
• Créer une clé de services Web

Étape 1 : Consulter le endpoint et la méthode

Rendez-vous d'abord dans la documentation pour l'environnement que votre compte utilise. 

À gauche, dans la liste des services Web, localisez le endpoint Contacts et cliquez sur la méthode Merge :Dans la documentation de chaque méthode, vous trouverez une description complète de la méthode ainsi que des exemples de requête et de réponses en JSON.  

Étape 2 : Générer un exemple

Dans la page de description de Contacts.Merge, repérez le bouton Tester (il est un peu subtil) :

Dans l'éditeur de requête, rendez-vous dans le Mode avancé et cliquez sur Générer un exemple : 

Étape 3 : Adapter l'exemple

L'exemple généré vous sert de base intéressante pour créer votre appel. Il ne vous reste qu'à ajouter les informations adaptées à votre cas.

Authkey

Lorsque vous avez créé votre clé de services Web, la clé générée possède les paramètres idkey et key dont vous devez ajouter les valeurs ici. 

idProject    

Pour savoir où trouver votre idProject, consultez cet article.

Records

Ajoutez les données des contacts à importer selon la structure mise en place dans votre projet. 

L'exemple présente un cas fréquent de clé de projet avec courriel (key_f_email) dans lequel vous indiquez le contact à ajouter ou mettre à jour avec son courriel. La clé peut être différente dans votre projet. Il arrive que la clé soit un numéro de client. 

→ En savoir plus sur les clés uniques et la gestion des doublons 

Dans Data, les champs s'écrivent avec « f_ » suivi du code du champ de projet (la destination de la donnée). Vous pouvez trouver le code d'un champ dans la liste de votre projet accessible par Projet → Gestion des données → Champs de projet.« FirstName » devient donc « f_FirstName ».

Étape 4 : Envoyer la requête

Vous n'avez pas besoin d'utiliser d'URL dans l'interface de test. C'est ajouté en arrière-plan. Quoique l'interface se nomme test, les appels sont réellement envoyés au projet indiqué dans le idProject. Faites donc attention aux requêtes demandées ici. 

Lorsque vous êtes prêt, cliquez sur Envoyer la requête :

Résultats

Si la réponse est positive et qu'il n'y a pas d'erreurs d'exécution, vous pourrez voir les contacts ajoutés dans la liste dans votre projet. Pour consulter la liste, rendez-vous dans Audience → Contacts.