Utilisation du connecteur Webhook

Créer une connexion

1. Recherchez le connecteur HTTP Webhook dans le catalogue Integration Service.

2. Sélectionnez Se connecter à HTTP Webhook.

3. Dans l'écran de connexion, vous devez fournir l'application, par exemple, UiPath Forum.

   

4. Dans Studio, démarrez votre workflow à partir d’un événement Webhook. Sélectionnez Événement du webhook réussi comme déclencheur de votre automatisation.

Remarque :

Une connexion est simplement une référence qui peut être réutilisée dans les workflows. Elle est liée à la même URL publique. Vous pouvez créer cette connexion dans un dossier, afin que d'autres puissent également créer des workflows basés sur les mêmes événements Webhook entrants.

Copiez l'URL exposée dans votre application fournisseur

Une fois qu'une connexion est créée, l'activité d'événement affiche l'URL du Webhook. Vous devez copier cette URL dans l'application du fournisseur.

Définir des filtres

Les applications fournisseur envoient différentes structures de charge utile ou types de charge utile, selon l'événement traité. Tous peuvent être envoyés via la même URL indiquée par l'activité de déclencheur. Vous différenciez les charges utiles en définissant des filtres au début de votre processus.

Par exemple, pour une charge utile comprenant un event_type pour new_post, updated_post, admin_removal sur le forum, vous pouvez déclencher des workflows spécifiques publiés ou en ignorer d'autres. Le filtrage offre un accès complet au corps et aux en-têtes envoyés par le fournisseur sur le Webhook.

Remarque :

Définissez les filtres corps et en-tête à l'aide de minuscules et de guillemets.

Définir les charges utiles de débogage

Cette étape est facultative. Vous pouvez simuler une exécution parfaite au moment de la conception en ajoutant un exemple de charge utile JSON pour le corps et/ou les en-têtes. Cette charge utile est enregistrée en tant que sortie de l'activité et peut être utilisée ultérieurement en tant que variables.

Publier

Publiez votre workflow à partir d'un événement HTTP Webhook pour activer l'URL publique. Vous pouvez ensuite tester cela en déclenchant des événements dans l'application du fournisseur ou en envoyant une commande curl directe à l'URL :

Automation Cloud :

curl -X POST https://cloud.uipath.com/{entity_url} -d "example             curl call"

Automation Cloud pour le secteur public :

curl -X POST https://govcloud.uipath.us/{entity_url} -d "example            curl call"

Lorsque Integration Service accepte l'événement, il répond avec la charge utile JSON suivante :

{ "webhookEventId": "wr-4ad55717e1.a7bbf1e8-72a1-4371-82d2-d{example}", "correlationId": "384d496c-2f6d-{example}" }

Remarque :

Cette charge utile est utile pour les tests, mais n'est nécessaire nulle part dans votre workflow.