L'étape Wait for webhook met un workflow en pause jusqu'à ce qu'elle reçoive une requête webhook, 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 selon les données fournies. Dans le cadre de l'intégration Zendesk, le workflow peut mettre en pause les interactions clients jusqu'à ce qu'une réponse webhook fournisse une mise à jour de statut ou une résolution. Pour garantir une expérience utilisateur fluide, il est utile d'ajouter un message d'avertissement avant cette étape, encourageant les clients à démarrer une nouvelle conversation s'ils ont d'autres questions pendant la pause.
Exemples
Vérification d'identité : Mettre le workflow en pause jusqu'à ce qu'un service tiers confirme l'identité d'un utilisateur.
Confirmation de paiement : Attendre un webhook de votre fournisseur de paiement pour confirmer une transaction avant de continuer.
Exécution de commande : Mettre en pause jusqu'à ce que votre système d'inventaire envoie une mise à jour sur la disponibilité des stocks.
Processus d'approbation : Suspendre le workflow jusqu'à ce qu'un outil tiers envoie un statut d'approbation ou de rejet.
Mises à jour clients Zendesk : Mettre le workflow en pause dans un système de ticket Zendesk en attendant une réponse webhook pour fournir des mises à jour de statut ou la résolution du ticket.
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 à l'étape de déploiement concernée et ouvrez votre workflow.
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 Exemple de requête 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 webhook dans votre presse-papiers. Sur le site tiers où le webhook est déclenché, assurez-vous que le
conversationIdest transmis comme prévu.Informez les clients de manière proactive si leur interaction est mise en pause à cause d'une configuration webhook. Utilisez des messages d'avertissement pour éviter toute confusion pendant les périodes d'attente.
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 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.
Pour les conversations Zendesk Sunshine Messenger, assurez-vous que le point de terminaison webhook Sunshine approprié est configuré dans Fin. Cette étape est cruciale pour traiter les messages en temps réel.