Webhook HTTP

Set up an HTTP Webhook, as a trigger or a wait step, with its fields and the request data it outputs.

HTTP Webhook connecte un workflow à n'importe quelle application qui peut envoyer un Webhook, une requête que l'application envoie à une adresse Web lorsque quelque chose se produit. Le nœud vous donne cette adresse. Vous le collez dans l'autre application, et chaque requête qu'il envoie atteint le workflow.

Le nœud apparaît à deux endroits et fonctionne de la même manière dans les deux endroits:

• En tant que déclencheur, dans la liste Modifier le déclencheur : chaque requête démarre une nouvelle exécution.
• En tant qu’étape d’attente, dans Ajouter un nœud > Attendre l’événement: l’exécution est suspendue au nœud jusqu’à ce qu’une demande arrive, puis se poursuit.

Configurer

1. Ajoutez le nœud, en tant que déclencheur ou en tant qu'étape d'attente.
2. In Connection, select an HTTP Webhook connection, or create one. Connection describes its fields.
3. Copiez l'URL du Webhook dans la zone située en haut du panneau et collez-la dans les paramètres du Webhook de l'autre application.
4. Vous pouvez également ajouter un filtre afin que seules les requêtes correspondantes comptent:
   1. Sélectionnez Ajouter une condition ou Ajouter un groupe.
   2. Choisissez Tout (ET) ou N’importe lequel (OU).
5. Déployez le workflow. Les requêtes ne lui sont fournies qu’après son déploiement.

Champs

Champ	Requis	Description
URL du webhook	—	Adresse à coller dans l'autre application. Chaque nœud a le sien.
Connexion (Connection)	Oui (Yes)	La connexion HTTP Webhook qui reçoit les requêtes. L’activité Actualiser le schéma recharge la forme des données entrantes.
Filtrer (Filter)	Non (No)	Conditions qu'une requête doit respecter. Les requêtes qui ne correspondent pas sont ignorées.
Arguments d'entrée	Non (No)	Déclencheur uniquement. Des valeurs que d'autres nœuds lisent sous $vars.<node ID>.output.

Connexion (Connection)

An HTTP Webhook connection receives the requests of one app. The webhook URL is created with the connection, so the node shows it only after the connection exists. Create a connection describes how to create a connection from the node. On the Connect to HTTP Webhook page, fill in these fields:

Champ	Indique ce qu’il faut saisir
Folder in which connection is stored	The folder that holds the connection.
What application is this webhook for?	A name for the app that sends the requests, such as Stripe-prod. It also becomes the connection identifier.
Type d’authentification	None, or Header Based Authentication to accept only requests that carry a header and value that you choose. Set the same header in the other app.
Emplacement du défi	No challenge, or where the app sends its verification challenge: Header, Body, or Query parameter.

With Header Based Authentication, a request without the matching header is rejected with the HTTP status 401.

Some apps, such as Slack, WhatsApp, and Stripe, check the webhook URL before they send events. They send a challenge, a value that the URL must return. If the app does this, select where the challenge arrives in Challenge location, then fill in the fields that appear, as the webhook documentation of the app describes. WhatsApp, for example, sends the challenge in the hub.challenge query parameter, and expects it back as plain text.

Sortie

The node's output is the request that the other app sent. Until the first request arrives, the node doesn't know its shape, so send one test request before you reference its fields in later nodes.

Prochaines étapes

• Déclencheurs: les autres façons de démarrer un workflow.
• Retard: suspendez plutôt l'exécution pendant une durée définie.
• Déployer un workflow: rendez le webhook actif.
• Community (Communauté): posez des questions et partagez des workflows avec d'autres développeurs sur le forum UiPath.