Les webhooks sont des messages automatisés qui envoient du contenu - ou des "charges utiles" - à une URL unique. Avec l'événement déclencheur HTTP Webhook, vous pouvez démarrer automatiquement une chaîne lorsqu'une URL Webhook reçoit une requête HTTP POST avec une charge utile JSON. Vous pouvez ensuite utiliser la charge utile JSON comme sortie de données avec les commandes de la chaîne, par exemple pour l'insérer dans une feuille de calcul.
Exigences
- Le connecteur HTTP Request doit être configuré avant d'utiliser cet événement déclencheur.
Démarrer la chaîne avec l'événement déclencheur
Lorsque vous ajoutez l'événement déclencheur à une chaîne, il génère automatiquement l'URL du webhook pour recevoir des données JSON.
- Allez sur Chain Builder, et sélectionnez la chaîne avec laquelle vous souhaitez travailler.
- Recherchez Trigger Event dans le menu de gauche, et faites glisser la commande HTTP Webhook vers la position Start sur le canevas.
- Sélectionnez le nœud HTTP Webhook et cliquez sur Edit .
- Sous Basic Info, saisissez un nom et une description uniques permettant d'identifier l'événement.
- Sous Trigger Event Details, sélectionnez le connecteur HTTP Request et CloudRunner à utiliser avec l'événement.
-
Saisissez le jeton de support à utiliser pour sécuriser l'URL du webhook.
Note : Considérez le jeton du porteur comme un mot de passe. Créez un jeton difficile à deviner et sauvegardez-le en toute sécurité.
- Cliquez sur Enregistrer.
Appeler le webhook avec une requête HTTP POST
Pour que l'événement déclencheur démarre la chaîne, la demande HTTP POST doit inclure :
- L'URL du webhook
- Le type de contenu ; par exemple,
application/json ; charset=UTF-8 - Jeton de support de l'URL
- Un objet JSON, même s'il est vide (
{})
Par exemple :
curl --location --request POST ’webhookUrl’ \N --header ’Authorization : Bearer bearerToken’ \N-header ’Content-Type : application/json’ \N --data-raw ’{}’