Cette étape active l'envoi de requêtes HTTP et l'enregistrement de leurs réponses en tant que variables.
Cette étape n'est disponible que pour le plan d'affaires et au-delà.
Il y a deux configurations clés à l'étape de requête HTTP :
La méthode spécifique requise pour la requête. Choisissez la méthode appropriée dans la liste déroulante.
Dans le champ URL, entrez le point de terminaison de l'URL de l'API externe pour récupérer les données. Pour inclure des variables, utilisez le préfixe "$" pour supporter l'interpolation du texte statique et des variables.
Vous pouvez maintenant utiliser des adresses IP et des numéros de port à l'étape de requête HTTP, vous donnant un accès direct aux serveurs et une flexibilité d'accès aux services sur les ports non standard.
Veuillez noter que les domaines respond.io et white label sont tous deux sur liste noire. L'envoi d'un appel API à ces domaines n'est pas autorisé, car cela pourrait causer des problèmes de boucle.
Pour assurer un décodage correct par le destinataire de la requête, développez la section Corps et incluez un corps avec l'en-tête Content-Type Header.
Dans la section En-tête, vous pouvez ajouter des en-têtes à la requête HTTP par paires. La clé représente le nom de l'en-tête et la valeur représente la valeur de l'en-tête. Vous pouvez utiliser les variables comme en-têtes en ajoutant le préfixe "$". Cependant, n'oubliez pas que seuls 10 en-têtes sont autorisés.
Pour les réponses à l'API JSON avec des paires clé-valeur, vous pouvez enregistrer des éléments de réponse spécifiques en tant que Variables. Dans la section Response Mapping, saisissez la clé de l'objet JSON à gauche et assignez un nom à la variable à droite. Gardez à l'esprit que seules les réponses JSON peuvent être enregistrées, et que vous pouvez avoir un maximum de 10 paramètres de correspondance de réponse.
Exemples:
Pour enregistrer une réponse dans différents formats, remplissez la clé JSON correspondant aux données que vous souhaitez enregistrer.
{
"nom": "Jason",
"zip\_codes": "12345",
"téléphone": "123123"
}
Pour enregistrer le numéro de téléphone de la réponse ci-dessus, utilisez $.phone comme clé JSON.
{
"champs personnalisés": {
"prénom": "John",
"Nom de famille": "Biche",
"locale": "fr\_GB",
"fuseau horaire": "5",
"sexe": "masculin",
"téléphone": "123123",
"courriel": "[email protected]",
"identifiant client": "1"
},
"créé\_à": 1575618542
}
Pour enregistrer le numéro de téléphone de la réponse ci-dessus, utilisez $.custom_fields.phone
{
"données": {
"identifiant":"1776025372480910",
"contacts" : \[
{
"prénom":"John",
"nom":"Biche",
"locale": "fr\_GB"
},
{
"Prénom":"Jane",
"Nom de famille":"Biche",
"locale": "fr\_FR"
}
\]
}
}
Pour enregistrer le prénom 'Jane' de la réponse ci-dessus, utilisez $.data.contacts[1].firstName.
Pour enregistrer l'état de la réponse de la requête HTTP en tant que Variable, activez la bascule Enregistrer l'état de réponse en tant que variable. Ensuite, nommez la variable dans le champ fourni.
Lorsqu'elle est activée, cette étape enverra une requête HTTP à l'URL spécifiée, en utilisant le corps et l'en-tête définis.
Vous pouvez guider le flux de travail en fonction du statut de la réponse. Par exemple, vous pouvez créer une succursale pour "le code de statut est égal à 200". Si un autre code de statut de réponse est reçu, une étape de saut peut renvoyer des contacts à l'étape de requête HTTP. Ou encore, la personne-ressource pourrait être adressée à la Direction générale des échecs si les conditions de la succursale ne sont pas remplies. S'il n'y a pas d'étapes mises en place dans la Direction des échecs, le flux de travail se terminera.
Si votre requête HTTP dépasse 10 secondes, cela entraînera un délai, causant l'échec de la requête.
Pour éviter les défaillances potentielles dans l'exécution des requêtes HTTP, assurez-vous que les conditions suivantes sont remplies :
Utilisez la méthode HTTP correcte et l'en-tête Content-Type.
Assurez-vous d'inclure le protocole http:// ou https:// dans votre URL en fonction de ce que votre système prend en charge pour éviter l'échec des requêtes.
Assurez-vous que le type de contenu est valide.
Exclure le numéro de port de l'URL.
Évitez d'utiliser un certificat auto-signé dans l'URL.
Vérifiez que l'autorisation est valide.
Assurez-vous que nos adresses IP (52.74.35.155, 18.138.31.163, 54.169.155.20) ne sont pas bloquées.
Si l'une des conditions ci-dessus n'est pas remplie, le Contact sautera cette étape et poursuivra le trajet restant.
Lors de la vérification des requêtes HTTP en sortie avec des variables dynamiques, souvenez-vous que les variables sans valeur retourneront comme null et indéfinies.
Voici les meilleures pratiques pour cette étape que vous pouvez suivre pour optimiser votre flux de travail:
Enregistrer le statut de la réponse en tant que variable :
Assurez-vous que la première étape est de enregistrer le statut de réponse en tant que variable pour d'autres actions.
Étape de la branche:
Ajouter une étape de la branche pour évaluer le statut de la requête HTTP.
Si le statut est 200, la requête est réussie.
Sinon, configurez une alerte pour avertir le gestionnaire de l'échec de la requête.
Google Sheet pour le monitoring :
Enregistrez le statut de réponse dans une feuille Google pour une visibilité claire sur le succès ou l'échec des requêtes.
Commentaire:
Ajouter un commentaire dans votre workflow pour documenter le statut de la réponse. Cela vous aidera à suivre et à examiner les erreurs plus efficacement.
Enregistrer le statut de la réponse en tant que variable :
Similaire à la requête réussie, enregistrer le statut de réponse comme variable pour la gestion des erreurs.
Utilisez l'étape d'attente ou de saut pour les nouvelles tentatives:
Implémentez l'étape d'attente pour mettre en pause avant de recommencer une requête infructueuse.
Sinon, utilisez l'étape Jump pour retourner à l'étape de requête HTTP et recommencez la requête.
Commentaire:
Documentez l'erreur en créant un commentaire pour enregistrer l'erreur de requête HTTP
Inclure les coordonnées et taguer la personne responsable.
Google Sheet for Monitoring:
Utilisez l'étape Google Sheet pour enregistrer les informations de contact et les détails d'erreurs pour le suivi et la revue.
Tâche Assignation:
Assignez la tâche à un utilisateur spécifique pour lancer un autre processus dans le workflow et réessayez.
Voici quelques façons d'utiliser l'étape de requête HTTP:
Route VIP Contacts: Utilisez l'étape de requête HTTP pour récupérer les coordonnées d'un entrepôt de données comme une CRM. Cela vous permet d'identifier les contacts VIP, permettant ainsi une expérience client personnalisée et de les distinguer des contacts non-VIP.
Articles connexes 👩💻
