Utilisez cet article pour ajouter l'outil Wait for Webhook à une procédure Fin, le configurer pour mettre en pause et attendre la réponse d'un système externe, et définir le comportement de délai et d'escalade.

Wait for Webhook met en pause une procédure Fin et attend qu'un système externe envoie un webhook, une notification HTTP automatisée qu'un système envoie à un autre lorsqu'un événement spécifique se produit, avant que Fin ne reprenne. Chaque conversation reçoit une URL de callback unique (une adresse web dédiée générée par Fin pour cette conversation), que votre système externe utilise pour renvoyer sa réponse à Fin. Cela permet d'intégrer des services tiers qui traitent les requêtes de manière asynchrone — comme les fournisseurs de vérification d'identité, les processeurs de paiement ou les systèmes d'approbation — sans perdre le contexte de la conversation en cours.

Note :

Wait for Webhook est actuellement en version bêta. Pour l'activer dans votre espace de travail, contactez l'équipe support pour demander l'accès. Vous aurez également besoin de la permission can manage workspace data pour créer ou modifier des procédures Fin.

Wait for Webhook est uniquement disponible dans les étapes Instruction. Ajoutez-le en tapant @ dans une étape Instruction et en sélectionnant Wait for Webhook dans le sélecteur d'outils.

Quand utiliser Wait for Webhook

Utilisez cet outil lorsque votre procédure doit déléguer à un système externe et attendre un résultat avant de continuer — et que ce système traite les requêtes de manière asynchrone plutôt que de renvoyer une réponse immédiatement.

Cas d'utilisation courants incluent :

Vérification d'identité ou d'âge — attendre qu'un fournisseur KYC (Know Your Customer) confirme l'identité d'un client
Autorisation de paiement — attendre qu'un processeur de paiement confirme une transaction
Lien de compte — attendre la fin d'un flux OAuth (standard d'autorisation ouvert)
Contrôles de traitement de commande — attendre qu'un système d'entrepôt confirme la disponibilité du stock
Workflows d'approbation — attendre qu'une équipe interne approuve un remboursement ou une exception

Comment ça fonctionne

Lorsque Fin atteint un outil Wait for Webhook dans une procédure, les actions suivantes se produisent :

Fin génère une URL de callback unique pour cette conversation au démarrage de la procédure — pas lorsque l'exécution atteint l'outil Wait for Webhook. Cette URL est disponible pour toute étape de la procédure dès le début.
Votre procédure (via un connecteur de données configuré plus tôt dans le flux) transmet cette URL de callback à votre système externe.
Le système externe termine son traitement et envoie sa réponse à l'URL de callback.
Fin reçoit la réponse, capture la charge utile dans les attributs de réponse définis dans la configuration de l'outil Wait for Webhook, et reprend la procédure à l'étape suivante.
Si aucun callback n'est reçu dans le délai d'attente configuré, Fin déclenche l'action de secours.

Important : L'URL de callback est unique pour chaque exécution de procédure. Elle ne peut pas être réutilisée pour plusieurs conversations ni stockée comme point de terminaison statique.

Comment ajouter Wait for Webhook à une procédure

Ouvrez votre procédure dans l'éditeur.
Dans une étape Instruction, tapez @ pour ouvrir le sélecteur d'outils.
Sélectionnez Wait for Webhook dans la liste.
L'outil Wait for Webhook est inséré dans l'étape et un panneau de configuration s'ouvre à droite.

Comment configurer l'outil

Le panneau de configuration Wait for Webhook comporte trois champs :

Nom de l'outil

Donnez un nom descriptif à l'outil (par exemple, « Wait for ID verification callback »). Ce nom identifie l'outil dans l'éditeur et est référencé lorsque vous mappez l'URL de callback comme paramètre dans votre connecteur de données.

Attributs de réponse

Définissez les champs que vous attendez que le système externe inclue dans la charge utile du webhook. Chaque attribut défini ici est capturé à l'arrivée du callback et peut être référencé dans les étapes suivantes à l'aide de l'outil Lire attribut.

Par exemple, si votre fournisseur de vérification d'identité renvoie un status et un reference_id, ajoutez-les tous deux comme attributs de réponse ici.

Note : Seules les valeurs scalaires de type chaîne sont prises en charge comme attributs de réponse — une valeur scalaire est un seul morceau de texte (par exemple, « verified » ou « approved »), contrairement aux tableaux ou objets JSON imbriqués. Si votre système externe envoie une charge utile complexe imbriquée, transformez-la en valeurs scalaires avant d'envoyer le callback. Les attributs de réponse doivent être définis avant le déclenchement du webhook et ne peuvent pas être ajoutés rétroactivement une fois la procédure en cours.

Temps d'attente et secours

Définissez combien de temps Fin doit attendre un callback avant d'escalader. Contactez votre équipe Intercom pour connaître les valeurs minimales et maximales du temps d'attente. Si aucun callback n'est reçu dans la fenêtre configurée, Fin escalade toujours via un chemin fixe — il n'y a pas de branchement conditionnel sur le délai. Vous devez configurer deux éléments dans le panneau de configuration Wait for Webhook : un message d'escalade à envoyer au client, et un assigné d'escalade (une équipe ou un coéquipier) pour diriger la conversation.

Important : Configurez toujours à la fois un message d'escalade et un assigné d'escalade dans le panneau. Si l'un des deux manque, le comportement en cas de délai peut être imprévisible.

Comment transmettre l'URL de callback à votre système externe

L'URL de callback est générée au démarrage de la procédure — pas lorsque l'exécution atteint l'outil Wait for Webhook. Cela signifie que vous pouvez la transmettre à votre système externe à n'importe quelle étape antérieure, y compris la toute première. Pour transmettre l'URL, utilisez un connecteur de données.

Configurez un connecteur de données qui appelle l'API de votre système externe (par exemple, un point de terminaison « Start ID verification »).
Dans la configuration du connecteur de données, ajoutez un paramètre d'entrée et mappez-le à l'attribut de callback de l'outil webhook — c'est l'URL de callback générée dynamiquement pour cette conversation.
Ajoutez une étape Appeler connecteur de données dans votre procédure avant l'outil Wait for Webhook.
Lorsque Fin appelle le connecteur de données, il transmet l'URL de callback à votre système externe dans la requête.
Votre système externe stocke l'URL de callback et l'utilise pour POSTER le résultat à Fin une fois le traitement terminé. Une fois le callback reçu, Fin reprend automatiquement la procédure à partir de l'outil Wait for Webhook.

Note : L'étape du connecteur de données qui transmet l'URL de callback doit précéder l'outil Wait for Webhook. Puisque l'URL est disponible dès le début de la procédure, votre appel de connecteur peut être aussi tôt dans le flux que nécessaire.

Comment lire les données de réponse après le callback

Une fois que Fin reçoit le callback webhook et reprend la procédure, la charge utile de la réponse est capturée dans les attributs de réponse que vous avez définis dans la configuration de l'outil Wait for Webhook. Utilisez l'outil Lire attribut dans une étape Instruction ultérieure pour accéder à ces valeurs.

Par exemple :

Lisez verification_status pour vérifier si la vérification d'identité a réussi ou échoué.
Utilisez une étape Condition pour brancher le flux en fonction du résultat.
Transmettez les valeurs de la réponse à un autre connecteur de données pour un traitement ultérieur.

Une fois que l'outil Wait for Webhook a reçu son callback et que vous avez branché les attributs de réponse capturés, la procédure continue normalement à l'étape suivante. Si le callback n'arrive jamais dans le délai d'attente configuré, Fin escalade comme décrit dans « Que se passe-t-il lorsque le délai d'attente expire ? » ci-dessous.

Que se passe-t-il lorsque le délai d'attente expire ?

Lorsque le délai d'attente configuré de l'outil Wait for Webhook expire sans recevoir de callback, Fin escalade toujours. Il n'y a pas de branchement conditionnel — vous ne pouvez pas configurer un comportement différent selon le délai. L'escalade suit toujours ces deux étapes :

Message d'escalade : Le message que Fin envoie au client lorsque le délai expire.
Assigné d'escalade : L'équipe ou le coéquipier à qui la conversation est dirigée après l'envoi du message.

Conseil :

Réglez votre temps d'attente pour correspondre au temps de traitement attendu de votre système externe, avec une marge raisonnable. Si votre fournisseur répond généralement en 10 secondes, un temps d'attente de 60 secondes offre une marge de sécurité tout en gardant une expérience réactive.

Une fois votre procédure configurée, utilisez les simulations dans l'éditeur de procédures pour valider le flux Wait for Webhook de bout en bout avant qu'il n'atteigne de vrais clients. Définissez une charge utile de callback fictive dans la simulation et fixez des critères de réussite basés sur le chemin de procédure que vous attendez que Fin suive.

FAQ

Mon webhook n'est jamais arrivé — que se passe-t-il ?

Si aucun callback n'est reçu dans le délai d'attente configuré, Fin déclenche le chemin d'escalade — il envoie le message d'escalade configuré au client et dirige la conversation vers l'assigné d'escalade. La procédure ne continue pas.

Comment transmettre l'URL de callback à mon système externe ?

Utilisez une étape Connecteur de données placée avant l'outil Wait for Webhook dans votre procédure. Configurez le connecteur pour appeler l'API de votre système externe et mappez l'attribut de callback de l'outil webhook comme paramètre d'entrée. Fin transmet l'URL de callback au système externe lors de l'appel du connecteur, afin que le système sache où envoyer le callback.

Puis-je utiliser la même URL de callback pour plusieurs conversations ?

Non. L'URL de callback est unique pour chaque exécution de procédure et est générée au démarrage de la procédure — pas lorsque l'exécution atteint l'outil Wait for Webhook. Chaque fois qu'une procédure est exécutée pour un client, une nouvelle URL est générée. Vous ne pouvez pas la stocker comme point de terminaison statique ni la réutiliser pour plusieurs conversations.

Quels champs de charge utile mon système externe peut-il renvoyer ?

Votre système externe peut inclure n'importe quels champs dans la charge utile du webhook, mais seuls les champs que vous avez définis comme attributs de réponse dans la configuration de l'outil Wait for Webhook sont capturés par Fin et disponibles dans les étapes suivantes. Tous les champs supplémentaires dans la charge utile sont ignorés.

Que se passe-t-il pendant que Fin attend un callback ?

Pendant que Fin est en pause en attendant un callback webhook, il ne répond pas aux messages entrants du client. La conversation est effectivement silencieuse jusqu'à l'arrivée du callback ou jusqu'à ce que le délai expire.

Conseil : Ajoutez toujours une étape Instruction avant l'outil Wait for Webhook pour informer le client de ce qui se passe — par exemple, « Nous vérifions votre identité. Veuillez compléter l'étape dans le lien que nous vous avons envoyé. » Sans cela, Fin restera silencieux en plein milieu de la conversation sans explication pour le client.

Utilisation de l'outil Wait for Webhook dans les procédures Fin