L'étape Wait for Webhook met un workflow en pause jusqu'à ce qu'elle reçoive une requête webhook, ce qui la rend idéale pour les processus nécessitant une entrée externe avant de continuer.
Imaginez que votre workflow doive s'intégrer à un système externe — comme une application tierce pour la vérification d'identité. Avec Wait for Webhook, le workflow s'arrête à cette étape jusqu'à ce que le système externe envoie une réponse webhook. Une fois reçue, la tâche reprend et agit en fonction des données fournies.
Exemples
Vérification d'identité : Mettez le workflow en pause jusqu'à ce qu'un service tiers confirme l'identité d'un utilisateur.
Confirmation de paiement : Attendez un webhook de votre fournisseur de paiement pour confirmer une transaction avant de continuer.
Exécution de commande : Mettez en pause jusqu'à ce que votre système d'inventaire envoie une mise à jour sur la disponibilité du stock.
Processus d'approbation : Maintenez le workflow en attente jusqu'à ce qu'un outil tiers envoie un statut d'approbation ou de rejet.
Cette fonctionnalité garantit que vos workflows sont fluides et synchronisés avec les systèmes externes, réduisant l'intervention manuelle et maintenant l'efficacité !
Ajouter Wait for Webhook à un workflow
Pour ajouter une étape Wait for Webhook à votre workflow :
Allez dans Fin AI Agent > Workflows et ajoutez un nouveau workflow ou ouvrez-en un existant.
Cliquez ensuite sur Ajouter une étape et sélectionnez Wait for Webhook.
Sélectionnez le bloc Wait for Webhook pour le configurer.
Mettez le workflow en ligne.
Bonnes pratiques pour Wait for Webhook
Ajoutez un nom clair à l'étape pour faciliter l'identification des variables temporaires créées pour cette étape.
Configurez correctement la Requête d'exemple en incluant tous les champs que vous attendez de recevoir dans le rappel webhook au sein de l'objet data.
Assurez-vous que le webhook renvoie un corps JSON correspondant à la structure de l'étape. Si la structure JSON est mise à jour, aucune donnée ne sera reçue. Les champs manquants dans la configuration rendront également ces champs inaccessibles dans la tâche.
Cliquez sur le bouton « Copier » pour copier l'URL du webhook dans votre presse-papiers. Sur le site tiers où le webhook est déclenché, assurez-vous que le
conversationIdest transmis comme prévu.
Note :
Le point de terminaison webhook prend en charge l'idempotence pour réessayer les requêtes en toute sécurité et éviter que la même opération ne soit effectuée plusieurs fois. Lors de l'envoi d'une requête, incluez un en-tête « Idempotency-Key » avec une valeur unique. Nous recommandons d'utiliser des UUID. Les clés d'idempotence expirent après 24 heures.
L'étape Wait for Webhook ne restera pas en attente indéfiniment et dispose d'une limite intégrée de 7 jours. Si aucun webhook n'est reçu dans les 7 jours suivant l'atteinte de l'étape, celle-ci expirera. Il n'est pas possible de modifier cette limite.