Envoyer une requête HTTP depuis un flow

Pour les agents

Guide : Envoyer une requête HTTP depuis un flow

Cette page : https://commentwatchdog.com/help/http-requests/send-an-http-request-from-a-flow

Sujet : Requêtes HTTP

Durée : environ 5 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 : Votre flow envoie des données à un autre système, ou en lit, et prend la sortie Succès ou Échec.

Contexte : L’étape Requête HTTP appelle l’API d’un autre système en pleine conversation : retrouver une commande, vérifier un code postal, envoyer un nouveau lead à votre CRM. Elle s’exécute n’importe où dans un flow, sur Instagram et Facebook. Un seul formulaire contient tout : la méthode et l’adresse, l’authentification, un body, des paramètres de requête et des headers, avec tout ce que vous savez de la personne inséré par des variables. Une bonne réponse prend Succès ; une erreur, un délai dépassé ou pas de réponse prend Échec, et la personne n’attend jamais dans le vide.

Avant de commencer

1. L’étape Requête HTTP est incluse avec le créateur de flows, à partir de Starter (et avec le pass DM 7 jours sur Mini et Lite).

2. L’étape ne fait qu’appeler vers l’extérieur : les autres systèmes ne peuvent pas appeler un flow.

3. L’authentification est un Bearer token, une Basic auth ou une clé d’API ; les clés sont enregistrées chiffrées et ne sont plus jamais affichées.

Étapes

Étape 1 sur 5 : Ajoutez une étape Requête HTTP.

Où : Ouvrez le flow sur le canevas. Dans le panneau Étapes à gauche, tapez HTTP dans Rechercher une étape et faites glisser Requête HTTP sur le canevas, ou cliquez dessus pour l’ajouter après l’étape sélectionnée. Sur un téléphone, Ajouter une étape, puis Requête HTTP.

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

Capture d'écran : https://commentwatchdog.com/media/shots/dm-node-http.fr.webp (L’étape Requête HTTP sur le canevas, ses réglages ouverts à droite.)

Capture d'écran : https://commentwatchdog.com/media/shots/dm-node-http-phone.fr.webp (Les réglages de l’étape sur un téléphone.)

Vous devriez voir : L’étape sur le canevas avec deux sorties, Succès et Échec, et ses réglages ouverts à côté.

Étape 2 sur 5 : Choisissez la méthode et saisissez l’adresse.

Où : Sous Adresse, vers le haut des réglages : la méthode à gauche (GET, qui se déplie sur POST, PUT, PATCH et DELETE), puis le champ de l’adresse, puis le bouton des variables {x}, qui insère des valeurs propres à chaque personne, par exemple https://api.zippopotam.us/fr/{{zip}}. Une variable dans l’adresse est encodée pour vous.

Capture d'écran : https://commentwatchdog.com/media/shots/dm-node-http.fr.webp (L’adresse, avec la variable {{zip}} dedans ; la méthode à sa gauche, le bouton des variables à sa droite.)

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

Vous devriez voir : L’étape sur le canevas affiche la méthode et l’adresse.

Étape 3 sur 5 : Remplissez ce que l’API demande : authentification, body, paramètres, headers.

Où : Le formulaire continue sous l’adresse, une section après l’autre. Authentification : Sans authentification, Bearer token, Basic auth ou Clé d’API (envoyée dans un header ou la query string). Body (pas pour GET ; un GET envoie ses valeurs en paramètres de requête) : JSON avec jusqu’à 40 champs, chacun envoyé comme Texte, Nombre, Vrai/faux ou JSON (un point dans une clé l’imbrique), Formulaire, Brut (JSON, texte brut ou XML) ou Aucun. Paramètres de requête : jusqu’à 20 lignes, ajoutées à l’adresse sous la forme clé=valeur. Headers : jusqu’à 20 lignes ; verrouillez une ligne pour garder sa valeur secrète. Envoyer cette ligne désactive une ligne sans la supprimer.

Capture d'écran : https://commentwatchdog.com/media/shots/dm-node-http.fr.webp (Authentification, la première section sous l’adresse.)

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

Vous devriez voir : Chaque section se remplit au fur et à mesure : Ajouter un paramètre et Ajouter un header comptent leurs lignes (0/20, 1/20). Une clé que vous saisissez est enregistrée chiffrée et affiche ensuite Enregistré et masqué, avec Remplacer.

Étape 4 sur 5 : Ouvrez Plus d’options pour le succès, le délai maximal et les nouvelles tentatives.

Où : Plus d’options, replié en bas du formulaire ; sa ligne affiche les choix actuels (par exemple Uniquement une réponse 2xx · 8 s · Une fois). Compte comme un succès : Uniquement une réponse 2xx, ou Toute réponse (vérifiez alors le code de statut dans une Condition). Délai maximal : 3, 5, 8 ou 10 s (8 par défaut). Réessayer en cas d’erreur : Ne pas réessayer, Une fois ou Deux fois, en l’absence de réponse ou sur une 5xx, uniquement pour les requêtes que l’on peut envoyer deux fois sans risque.

Capture d'écran : https://commentwatchdog.com/media/shots/dm-node-http-more.fr.webp (Plus d’options, en bas du formulaire, avec les choix actuels sur sa ligne.)

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

Vous devriez voir : La ligne Plus d’options affiche ce que vous avez choisi.

Étape 5 sur 5 : Reliez Succès et Échec.

Où : Faites glisser depuis le point Succès jusqu’à l’étape suivante (un message qui utilise la réponse), et depuis Échec vers ce qui doit se passer à la place (prévenir votre équipe, passer la main à une personne, ou un message bienveillant). Sur un téléphone, choisissez chaque étape sous Étapes suivantes, en bas des réglages. Une sortie Échec reliée à rien termine l’exécution en échec, et la barre vous prévient.

Capture d'écran : https://commentwatchdog.com/media/shots/dm-node-http.fr.webp (Les deux sorties de l’étape, Succès et Échec, chacune reliée à son étape suivante.)

Capture d'écran : https://commentwatchdog.com/media/shots/dm-node-http-more-phone.fr.webp (Sur un téléphone : Succès et Échec sous Étapes suivantes, chacune avec l’étape où elle mène.)

Vous devriez voir : Les deux sorties sont reliées ; la barre affiche Prêt à activer dès qu’il ne reste rien à corriger.

Si quelque chose ne va pas

Problème : Bloquée

Solution : L’adresse pointe vers un réseau privé (ou vers une adresse de bouclage ou de métadonnées cloud) : elle est donc refusée par sécurité. Utilisez l’adresse publique de l’API.

Problème : Délai dépassé

Solution : L’API a mis plus longtemps que le délai maximal défini dans Plus d’options (10 secondes au plus). L’exécution a pris la sortie Échec.

Problème : En pause après des échecs

Solution : L’adresse a échoué 5 fois de suite : les appels vers elle sont en pause une minute, puis elle est réessayée.

Problème : Adresse invalide

Solution : Une fois ses variables remplies, l’adresse n’est pas un lien http ou https valide. Vérifiez que la variable a une valeur à cet endroit du flow.

Questions fréquentes

Question : Un flow peut-il appeler n’importe quelle API ?

Réponse : Oui, toute API accessible sur l’internet public en GET, POST, PUT, PATCH ou DELETE, sans authentification, avec un Bearer token, une Basic auth ou une clé d’API. Les adresses situées dans des réseaux privés sont refusées par sécurité.

Question : Un autre système peut-il envoyer des données dans un flow ?

Réponse : Non. L’étape Requête HTTP ne fait qu’appeler vers l’extérieur depuis un flow ; il n’existe pas de webhook entrant qui en lance ou en alimente un.

Question : Combien de temps une requête HTTP peut-elle attendre au maximum ?

Réponse : 10 secondes, le maximum que permet le délai maximal (8 par défaut). Les gens sont en pleine conversation : plus c’est court, mieux c’est pour eux.

Question : Mes clés d’API sont-elles en sécurité ?

Réponse : Les valeurs d’authentification et toute ligne marquée comme secrète sont chiffrées à l’enregistrement, liées à votre compte, et ne sont plus jamais affichées, pas même dans l’historique des exécutions.

Guides associés

Utiliser la réponse dans votre flow : https://commentwatchdog.com/help/http-requests/use-the-answer-in-your-flow

Coller une commande cURL : https://commentwatchdog.com/help/http-requests/paste-a-curl-command

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/send-an-http-request-from-a-flow.md

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