À propos du connecteur HTTP Webhook

Configurez le connecteur HTTP Webhook dans Integration Service pour recevoir des rappels en temps réel et générés par événements de la part d’applications externes sans interrogation.

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 de Webhook sont traitées de la même manière que tous les autres événements de déclencheur. Le connecteur prend également en charge l’authentification facultative basée sur l’en-tête, qui permet au fournisseur de s’authentifier auprès d’UiPath lors de chaque livraison de webhook à l’aide d’une valeur d’en-tête configurée.

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

Pour de plus amples informations sur la façon de créer une connexion et de configurer la vérification des défis, si le fournisseur l'exige, consultez la section Authentification HTTP Webhook.

Sécurité

Le connecteur HTTP Webhook offre deux mécanismes de sécurité complémentaires, tous deux configurés au moment de la création de la connexion:

Mécanisme	Ce qu’il fait	Quand l'utiliser
Vérification des défis	Permet au fournisseur de confirmer que votre URL de Webhook UiPath est valide avant d’envoyer des événements.	Lorsque le fournisseur nécessite un processus d'établissement de liaison (Slack, Meta, etc.).
Authentification basée sur l’en-tête	Valide chaque demande de Webhook entrant à l’aide d’une clé secrète partagée portée dans un en-tête HTTP (par exemple, X-API-Key). Les requêtes qui ne comportent pas la valeur d'en-tête configurée sont rejetées avec HTTP 401.	Lorsque vous souhaitez empêcher les appelants non autorisés de publier sur votre URL Webhook, et que votre fournisseur vous permet de configurer un en-tête personnalisé sur les livraisons Webhook sortantes.

Pour plus de détails sur la configuration, consultez Authentification HTTP 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.
• La taille maximale de charge utile du webhook prise en charge est de 14 Mo. Les demandes dépassant cette limite sont rejetées et aucun événement déclencheur n’est envoyé.

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.

Puis-je demander au fournisseur de s’authentifier lors de l’envoi d’événements de Webhook à UiPath?

Oui. Activez l’authentification basée sur l’en-tête lors de la création ou de la modification de la connexion, puis configurez l’en-tête correspondant dans les paramètres du webhook du fournisseur. Pour obtenir des instructions de configuration, consultez HTTP Webhook authentication.

Mon fournisseur utilise son propre schéma de signature (par exemple, X-Hub-Signature-256). Puis-je toujours utiliser l’authentification basée sur l’en-tête?

Non. L’authentification basée sur l’en-tête utilise une valeur d’en-tête statique pré-partagée. Les fournisseurs basés sur les signatures calculent un nouveau HMAC sur chaque demande à l’aide de la charge utile et d’une clé secrète partagée - UiPath ne valide pas actuellement les signatures spécifiques aux fournisseurs. Pour ces fournisseurs, les mécanismes de sécurité disponibles sont la clé secrète de l'URL et l'établissement de la liaison de vérification des défis du fournisseur.