Webhook

Le déclencheur Webhook reçoit du JSON et d'autres données dans le corps d'un message de requête HTTP POST, PUT ou DELETE.

Pour que le webhook reçoive un corps de requête au format JSON, vous devez configurer le schéma de message pour qu'il corresponde aux données attendues (voir Attributs de sortie, ci-dessous).

Le déclencheur Webhook dispose de deux ports de sortie. Le port du succès (✔) peut envoyer un message si le déclencheur démarre avec succès. Le port d'échec (x) peut envoyer un message si le déclencheur ne parvient pas à s'initialiser.

Paramètres

• URL du webhook: L'URL du webhook. Ce paramètre est généré automatiquement lorsque vous enregistrez le workflow. Une fois généré, vous pouvez cliquer sur l'icône du presse-papiers pour copier.
• Nécessite une authentification: Si coché, l'utilisateur qui accède auURL du webhook doit avoir des Webhooksautorisation sur le déclencheur Webhook.

Attributs de sortie

Voir aussi

• Travailler avec les attributs de sortie dans les workflows d'automatisation.

Configuration du schéma Webhook

Pour que le webhook reçoive un corps de requête au format JSON, vous devez configurer le schéma de message pour qu'il corresponde aux données attendues, comme suit :

1. Sous leAttributs de sortie onglet, clicImporter des paramètres depuis JSON.
2. Dans la boîte de dialogue Importer les paramètres depuis JSON, entrez un schéma JSON valide et cliquez surAnalyser.
NoteL'analyseur analyse uniquement les clés de niveau supérieur. Pour accéder au contenu des tableaux et objets imbriqués à partir d'unworkspace, utilisez des transformateurs de manipulation JSON.

Les paramètres importés apparaissent sous « Attributs Webhook », préfixés par lewebhookpropriété parente.

Autres attributs

Attribut	Description
temps	Heure de l'événement
source	Type d'événement
type d'erreur	(Port d'échec uniquement) Type d'erreur : Message invalide:Une erreur s'est produite lors de la configuration de ce composant, telle que des valeurs manquantes ou mal formées. Lettre morte:Une erreur s'est produite lors de la connexion à une ressource externe. Les exemples peuvent inclure des problèmes de connexion, des informations d’identification non valides ou des exceptions de ressources externes génériques.
message d'erreur	(Port d'échec uniquement) Message d'erreur
message	(Port de réussite uniquement) Contenu du message
en-têtes de webhook	(Port de réussite uniquement) Les en-têtes de la requête HTTP, sous la forme d'une chaîne JSON.
méthode webhook	(Port de réussite uniquement) La méthode de requête HTTP qui a déclenché le webhook : POST, PUT ou DELETE.

Travailler avec des données non JSON

En plus des données au format JSON, les déclencheurs webhook peuvent recevoir du texte, du XML et d'autres données. Le tableau suivant explique comment les données non JSON sont formatées pour générer des attributs.

Type de contenu	Codage des messages
texte/*	Reste dans le texte aumessageattribut.
application/xml	Formaté sous forme de texte aumessageattribut.
application/x-www-form-urlencoded	Formaté sous forme de texte aumessageattribut.
application/* ou autre	Base64 aumessageattribut.