Utiliser la réponse dans votre flow

Pour les agents

Guide : Utiliser la réponse dans votre flow

Cette page : https://commentwatchdog.com/help/http-requests/use-the-answer-in-your-flow

Sujet : Requêtes HTTP

Durée : environ 4 minutes

Qui peut le faire : Propriétaire, Administrateur ou Gestionnaire

Auteur : https://anantgupta.xyz (Anant Gupta, fondateur de CommentWatchDog)

Commencer dans l'app : https://app.commentwatchdog.com/fr/inbox

Résultat final : Des valeurs de la réponse de l’API, utilisées dans vos messages et conditions suivants, ou enregistrées sur la personne pour plus tard.

Contexte : Nommez la réponse une fois, et chaque champ qu’elle renvoie peut aller dans les messages, les requêtes et les conditions qui suivent sous ce nom, comme {{order.items[0].name}} ou {{order.$status}}. Testez la requête pour de vrai avec des valeurs d’exemple : l’étape liste les champs renvoyés avec leurs valeurs, prêts à insérer. Une valeur qui mérite d’être gardée au-delà de cette conversation peut être enregistrée sur le contact : comme son e-mail, son téléphone ou son nom, ou comme un champ enregistré que les exécutions et les conditions suivantes lisent aussi.

Avant de commencer

1. Le test fait le vrai appel depuis notre serveur, avec des valeurs d’exemple à la place des variables.

2. Jusqu’à 30 requêtes de test par minute et par personne.

3. La réponse est lue jusqu’à 512 Ko ; jusqu’à 20 valeurs enregistrées sur le contact par étape.

Étapes

Étape 1 sur 4 : Nommez la réponse et envoyez une requête de test.

Où : Dans la section Réponse de l’étape, sous Headers : Nom de la réponse (par exemple ship), puis Valeurs d’exemple pour ses variables (par exemple 69001 pour zip), puis Envoyer la requête de test. Une fois qu’un test a tourné, le bouton affiche Tester à nouveau.

Lien : https://app.commentwatchdog.com/fr/inbox (Ouvrez l’app)

Capture d'écran : https://commentwatchdog.com/media/shots/dm-node-http-more.fr.webp (La section Réponse : Nom de la réponse, la valeur d’exemple, Envoyer la requête de test.)

Capture d'écran : https://commentwatchdog.com/media/shots/dm-node-http-more-phone.fr.webp (La section Réponse sur un téléphone.)

Vous devriez voir : Sous le bouton : le statut (200), le temps qu’elle a pris et la sortie qu’elle prendrait, Prend le chemin Succès ou Prend le chemin Échec. Réponse, Headers et Ce qui a été envoyé, sous les champs, ouvrent la réponse brute et exactement ce qui a été envoyé.

Étape 2 sur 4 : Choisissez le champ qu’il vous faut dans Champs renvoyés.

Où : Sous le résultat, Champs renvoyés liste chaque valeur de la réponse selon sa place, avec la valeur en dessous : Code de statut 200, country France, places[0].place name Lyon 01. Le bouton de copie d’une ligne copie sa variable, par exemple {{ship.places[0].place name}}. Les étapes suivantes les trouvent aussi sous le bouton des variables, dans Issues d’appels d’API.

Capture d'écran : https://commentwatchdog.com/media/shots/dm-http-test.fr.webp (Champs renvoyés : chaque valeur de la réponse, avec la copie et Enregistrer sur le contact sur sa ligne.)

Capture d'écran : https://commentwatchdog.com/media/shots/dm-http-test-phone.fr.webp (La même chose sur un téléphone.)

Vous devriez voir : Sous la liste : « Insérez-les plus loin avec le bouton des variables. Copiez-en un pour le coller vous-même. » Les champs restent listés (du dernier test) après la fermeture de l’étape.

Étape 3 sur 4 : Enregistrez une valeur sur le contact, si elle doit durer au-delà de cette conversation.

Où : Enregistrer sur le contact, sur la ligne d’un champ, ouvre quatre choix : Son e-mail, Son téléphone, Son nom ou Un champ enregistré. Le bouton de la ligne affiche alors le choix, et la valeur est listée sous Enregistré sur le contact, sous les champs, où vous pouvez changer sa destination ou la retirer.

Capture d'écran : https://commentwatchdog.com/media/shots/dm-http-save.fr.webp (Enregistrer sur le contact, ouvert sur un champ : Son e-mail, Son téléphone, Son nom, Un champ enregistré.)

Capture d'écran : https://commentwatchdog.com/media/shots/dm-http-save-phone.fr.webp (La même chose sur un téléphone.)

Vous devriez voir : Sous Enregistré sur le contact : la place du champ dans la réponse (places[0].place name), sa destination, et Dernier test : avec la valeur lue (Lyon 01).

Étape 4 sur 4 : Utilisez-la dans un message ou une condition.

Où : Dans un message plus loin, appuyez sur le bouton des variables {x} à côté d’Insérer, sous le texte. Sa liste s’ouvre sur Issues d’appels d’API : le code de statut de la réponse (ship.$status, avec 200 du dernier test) et la valeur que vous avez gardée comme variable (city). Insérez-en une, par exemple : Bonne nouvelle ! Le café arrive à {{city}} en 3 à 5 jours ouvrés. Dans une Condition, vérifiez la valeur ou le code de statut.

Capture d'écran : https://commentwatchdog.com/media/shots/dm-http-use.fr.webp (Le message après Succès, avec {{city}} dans son texte : le bouton des variables ouvert sur Issues d’appels d’API.)

Capture d'écran : https://commentwatchdog.com/media/shots/dm-http-use-phone.fr.webp (La même chose sur un téléphone.)

Vous devriez voir : Le message affiche la variable entre doubles accolades, ici {{city}}, dans le panneau et sur l’étape ; lors d’un test, elle affiche la vraie valeur.

Si quelque chose ne va pas

Problème : Introuvable au dernier test

Solution : Le chemin que vous avez enregistré ne figure pas dans la dernière réponse. Testez à nouveau avec des valeurs d’exemple qui le renvoient.

Problème : Un message affiche la variable vide

Solution : La valeur est utilisée avant que son étape HTTP ait pu s’exécuter, ou la requête a pris la sortie Échec. Le créateur prévient quand une réponse est utilisée avant son étape.

Problème : Testez la requête pour voir les champs qu’elle renvoie

Solution : Aucun test n’a encore tourné. Remplissez les valeurs d’exemple et appuyez sur Envoyer la requête de test.

Problème : Trop de tests en une minute

Solution : Jusqu’à 30 tests par minute et par personne. Attendez un instant et testez à nouveau.

Questions fréquentes

Question : Puis-je enregistrer une valeur d’API sur le contact ?

Réponse : Oui. Enregistrer sur le contact, sur n’importe quel champ de la réponse : comme son e-mail, son téléphone ou son nom, ou comme un champ enregistré que les exécutions et les conditions suivantes lisent aussi.

Question : Une condition peut-elle vérifier la réponse de l’API ?

Réponse : Oui. Chaque champ d’une réponse nommée est une variable qu’une Condition peut vérifier, et le code de statut aussi quand Compte comme un succès est réglé sur Toute réponse.

Question : La requête de test appelle-t-elle vraiment l’API ?

Réponse : Oui. Elle fait le vrai appel depuis notre serveur avec vos valeurs d’exemple et affiche la réponse, ses headers et exactement ce qui a été envoyé, secrets masqués.

Guides associés

Envoyer une requête HTTP depuis un flow : https://commentwatchdog.com/help/http-requests/send-an-http-request-from-a-flow

Champs personnalisés : https://commentwatchdog.com/help/people/custom-fields

Construire la requête avec l’IA : https://commentwatchdog.com/help/http-requests/build-the-request-with-ai

Texte brut de ce guide : https://commentwatchdog.com/help/http-requests/use-the-answer-in-your-flow.md

Tous les guides pour assistants : https://commentwatchdog.com/help/llms.txt