À propos du connecteur HTTP Webhook

Les Webhooks permettent aux applications d'informer les systèmes externes en temps réel, ce qui réduit la nécessité d'effectuer des sondages fréquents et de minimiser les appels d'API. Au lieu de vérifier périodiquement les mises à jour, le système reçoit des rappels basés sur les événements uniquement lorsque des changements pertinents se produisent.

Le connecteur UiPath HTTP Webhook vous permet de déclencher des workflows directement à partir des applications des fournisseurs. Vous pouvez créer des déclencheurs instantanés pour les événements de toute application tierce qui prend en charge les notifications de Webhook sortant, même si elle ne fait pas partie du catalogue de connecteurs.

Vous pouvez également appliquer des filtres de données d'événement pour spécifier les conditions exactes dans lesquelles un événement Webhook doit déclencher un workflow.

Mode de fonctionnement

Le déclencheur HTTP Webhook génère une URL de rappel publique dynamique. Copiez et configurez cette URL dans les paramètres du webhook de l’application fournisseur uniquement après la création de votre déclencheur dans Orchestrator.

Lorsqu’un événement se produit dans le système du fournisseur :

1. Le fournisseur envoie la charge utile de l'événement à l'URL configurée.
2. Integration Service reçoit la charge utile et l’évalue par rapport à vos filtres de données d’événement configurés.
3. Si une correspondance est trouvée, Integration Service déclenche l'exécution du workflow via Orchestrator.

Les charges utiles du Webhook sont traitées de la même manière que tous les autres événements déclencheurs.

Pour de plus amples informations, consultez la section Utiliser le connecteur Webhook.

Si le fournisseur a besoin d’établir une liaison, configurez la vérification du défi. Pour de plus amples informations, consultez la section Vérification des défis Webhook.

Limites de débit

Les événements déclenchés par Webhook sont soumis aux limites suivantes :

• 500 événements par minute et par locataire
• 100 événements par minute et par connexion

Limitations

• Le débogage du déclencheur de phase de conception n’est pas disponible actuellement.
• Seules les requêtes au format JSON sont prises en charge.

Questions fréquemment posées

J'ai collé l'URL du Webhook dans l'interface utilisateur du fournisseur. Pourquoi la vérification ne passe-t-elle pas ?

La vérification ne réussira qu'après la création du déclencheur dans Orchestrator et à condition que vous ayez configuré le défi correctement. Notez qu'UiPath n'effectue aucune vérification de défi de notre côté : la validation se fait entièrement du côté du fournisseur, afin d'établir une relation de confiance avec la destination.

J’ai configuré le défi de manière incorrecte. Pourquoi ma connexion est-elle toujours créée avec succès ?

UiPath ne valide pas actuellement l'étape de défi/vérification du fournisseur. Cette validation est entièrement gérée par le fournisseur. Par conséquent, la connexion dans UiPath peut apparaître active même si la vérification des difficultés du fournisseur a réellement échoué de son côté.

Comment utiliser la réponse provenant d'un Webhook créé dans Orchestrator ?

Utilisez l’activité Obtenir la sortie d’événement de déclencheur dans votre workflow et passez UiPathEventObjectId (type de données=Texte) comme argument d’entrée. Cette activité renverra à la fois le corps et les en-têtes reçus du Webhook.

La réponse du webhook est une chaîne JSON. Comment dois-je utiliser certaines parties de celui-ci dans mon workflow ?

Utilisez l’activité Désérialiser JSON pour convertir la chaîne en un JObject, après quoi vous pourrez facilement accéder aux champs individuels.