L'outil Wait for Webhook permet à Fin de faire une pause en cours de procédure et d'attendre une entrée externe. Utilisez-le pour automatiser des processus nécessitant une intégration avec des systèmes tiers comme Onfido et Plaid, permettant un traitement asynchrone.

Note :

Wait for Webhook est uniquement disponible dans les étapes d'Instruction. Ajoutez-le en tapant @ dans une étape d'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 qu'un flux OAuth (standard d'autorisation ouvert) soit terminé
Contrôles de traitement des commandes — 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 :

Lorsqu'une exécution de procédure commence, Fin génère une URL de callback unique pour chaque outil Wait for Webhook.
Configurez votre procédure pour transmettre cette URL de callback à votre système externe en utilisant un Data Connector avant que Fin n'atteigne l'outil Wait for Webhook.
Une fois que le système externe a terminé son traitement et envoie un webhook à l'URL de callback, Fin capture la charge utile du webhook dans les attributs de réponse configurés et reprend automatiquement la procédure.
Si aucun callback n'est reçu dans le délai d'attente configuré, Fin envoie le message d'escalade configuré et assigne la conversation à la personne désignée pour l'escalade.

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 d'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 Data Connector.

Attributs de réponse

Définissez les champs que vous attendez que le système externe inclue dans sa charge utile 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 Read attribute.

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.

Temps d'attente et solution de secours

Définissez combien de temps Fin doit attendre un callback avant d'escalader. Vous devez également configurer le message d'escalade envoyé au client et sélectionner la personne à qui la conversation sera attribuée si le délai est dépassé.

Important : Configurez toujours à la fois un message d'escalade et une personne assignée à l'escalade dans le panneau latéral. 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 Data Connector.

Configurez un Data Connector qui appelle l'API de votre système externe (par exemple, un point de terminaison « Start ID Verification »).
Configurez le Data Connector pour accepter une URL de callback comme paramètre d'entrée.
Dans l'éditeur de procédure, mappez ce paramètre d'entrée à l'attribut URL de l'outil webhook.
Assurez-vous que la procédure est configurée pour appeler ce Data Connector avant d'atteindre l'outil Wait for Webhook.
Lorsque Fin appelle le Data Connector, il transmet l'URL de callback unique dans la requête. Votre système externe stocke cette URL et envoie le callback webhook une fois le traitement terminé.

Note : L'appel au Data Connector qui transmet l'URL de callback doit se faire avant l'outil Wait for Webhook. Cela permet au système externe d'accéder à l'URL de callback.

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 Read attribute dans une étape d'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 Data Connector 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 est dépassé ? » ci-dessous.

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

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 est dépassé.
Personne assignée à l'escalade : L'équipe ou le coéquipier à qui la conversation est routé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 route la conversation vers la personne assignée à l'escalade. La procédure ne continue pas.

Comment obtenir l'URL de callback pour mon système externe ?

Utilisez une étape Data Connector 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 callback de l'outil webhook comme paramètre d'entrée. Fin transmet l'URL de callback au système externe lorsque le connecteur est appelé, ainsi le système sait 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 exécution 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 entre 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 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. 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 soit dépassé.

Conseil : Ajoutez toujours une étape d'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.

Quelles autorisations sont nécessaires pour utiliser Wait for Webhook ?

Vous avez besoin de l'autorisation can manage workspace data pour créer ou modifier des procédures Fin, y compris pour ajouter l'outil Wait for Webhook. Vous pouvez vérifier et mettre à jour les autorisations dans Paramètres > Espace de travail > Coéquipiers.

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