> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/automate-protect-and-extend/fr/automatisation/webhooks.md). # Webhooks Les webhooks permettent l’envoi de messages en mode push vers des systèmes externes lorsque des événements spécifiques se produisent. Lorsqu’un événement déclencheur a lieu, un webhook envoie une requête HTTP (généralement un POST) vers une URL prédéfinie. Ce mécanisme push est plus efficace que l’interrogation périodique, tant pour les notifications que pour l’automatisation des workflows, car le système récepteur n’a pas besoin de vérifier régulièrement les mises à jour. ## Exemples d’utilisation des webhooks Les webhooks VergeOS offrent une grande configurabilité pour la communication pilotée par événements avec des systèmes tiers, offrant un large éventail de possibilités de simplification. Les exemples de base suivants illustrent des alertes possibles et l’automatisation de workflows à l’aide de webhooks : * Envoyer une notification Slack à un canal d’administration lorsqu’un travail de synchronisation produit une erreur * Publier dans un système comptable lorsqu’un locataire VergeOS se met en ligne, déclenchant ainsi une facturation automatique * Déclencher un workflow Zapier lorsqu’une machine virtuelle spécifique démarre, initiant des actions interapplications (par ex. rapports, e-mails, notifications, etc.) ## Étapes de configuration Pour mettre un webhook en action, suivez ces étapes : * [**Créer un webhook**](#create-a-webhook): définit l’URL cible, la méthode d’authentification et tous les en-têtes personnalisés requis par le système externe * [**Créer une tâche**](#create-a-task): définit la charge utile à livrer * [**Créer un événement**](#create-an-event): désigne une occurrence qui activera la tâche {% hint style="success" %} **Conception modulaire** Le *Moteur de tâches VergeOS* permet une orchestration flexible des webhooks, des tâches et des événements. Vous pouvez attribuer plusieurs tâches ou événements à un seul webhook, et une même tâche peut être déclenchée par plusieurs événements distincts. Cette architecture mix-and-match prend en charge des workflows évolutifs et réutilisables, adaptés aux besoins de votre système. {% endhint %} ## Créer un webhook 1. Accédez à **Système** > **Tableau de bord des tâches**. 2. Cliquez sur **Nouveau webhook** dans le menu de gauche. 3. Configurer le webhook : * **Nom**: Fournissez un nom descriptif pour le webhook. * **URL**: Saisissez le point de terminaison API exposé par le système concerné pour accepter les requêtes HTTP POST. {% hint style="success" %} **En général, vous devrez accorder explicitement à votre système VergeOS l’accès à ce point de terminaison sur le système cible** **Type d’autorisation** * *Jeton Bearer* - Saisissez uniquement la chaîne du jeton Bearer (n’incluez pas le mot « Bearer ») * *Clé API* - Saisissez uniquement la chaîne brute de la clé API. (N’incluez aucun préfixe ni mot-clé) * *Basic* - Saisissez le nom d’utilisateur et le mot de passe dans les champs fournis. * *Aucune* **En-têtes** {% endhint %} Par défaut, un en-tête est inclus pour spécifier une charge utile *content-type: application/json*. Cet en-tête peut être supprimé ou modifié selon les besoins, et des en-têtes supplémentaires peuvent être configurés si nécessaire ou pris en charge par le système cible (par ex. modifier le type de contenu, le routage des événements, la limitation de débit, la priorité, etc.) - Pour modifier l’ordre des en-têtes personnalisés : sélectionnez la case à cocher de l’en-tête ou des en-têtes souhaités et utilisez les boutons fléchés Haut/Bas - Utilisez le bouton Plus pour ajouter des en-têtes supplémentaires - Le bouton crayon bascule entre la saisie par paire clé/valeur d’en-tête et la saisie manuelle de la syntaxe complète de l’en-tête * **Autoriser les certificats non sécurisés**: Cette option est destinée à prendre en charge les certificats auto-signés pour les environnements de test/développement. **L’utilisation de certificats non sécurisés pour les systèmes et données de production (en particulier les URL publiques) est risquée et déconseillée.** * **Délai d’attente dépassé**: Définit le nombre maximal de secondes à attendre une réponse du système cible (doit être de 3 ou plus) * **Réessais**: Nombre de nouvelles tentatives à effectuer lorsqu’aucune réponse ou qu’une erreur est renvoyée par le système cible 4. Cliquez sur **Soumettre** pour enregistrer le webhook. ## Créer une tâche 1. Accédez à **Système** > **Tableau de bord des tâches**. 2. Cliquez sur **Nouvelle tâche** dans le menu de gauche. 3. Configurer la tâche : * **Nom**: Fournissez un nom descriptif pour la tâche. * **Description (facultatif)**: Des informations supplémentaires peuvent être stockées pour la tâche, par ex. son objectif, le résultat attendu, etc. * **Supprimer la tâche après exécution**: définit une activation unique ; le système supprimera automatiquement la tâche après sa première exécution. * **Type d'objet**: *Webhook* * **Objet :** Sélectionnez le webhook créé à l’étape précédente. * **Action**: *Envoyer* * **Message**: Définissez la charge utile à envoyer au système externe. - La charge utile par défaut inclut une paire clé-valeur de base avec la chaîne « Webhook » comme valeur ; supprimez-la ou modifiez-la selon les besoins pour créer la charge utile souhaitée. {% hint style="success" %} **Des variables peuvent être utilisées dans la charge utile du message :** * **${DATE}** - date/heure actuelle au format de chaîne complet, par ex. *Thu, 16 Oct 2025 11:38:07 EDT* * **${TIMESTAMP}** - date/heure actuelle sous forme de valeur numérique (temps Unix), par ex. *1760629087* * **${RANDOM}** - entier généré aléatoirement * **${NAME}** - nom de l’objet VergeOS concerné {% endhint %} 4. Cliquez sur **Soumettre** pour enregistrer la tâche. ## Créer un événement 1. Accédez à **Système** > **Tableau de bord des tâches**. 2. Cliquez sur **Nouvel événement** dans le menu de gauche. 3. Configurer l’événement : * **Type**: Sélectionnez la zone applicable du système VergeOS où le déclencheur se produira. * **Événement**: La liste des événements changera en fonction du type sélectionné ci-dessus. Sélectionnez l’événement souhaité qui servira de déclencheur. * **Sélectionner une instance d’objet spécifique ou une balise** pour déclencher l’événement : (certains types sélectionnés, tels que *Alarmes* s’appliquent à un niveau générique et ne proposent pas d’options pour les balises ou les objets spécifiques.) * Sélectionnez une instance spécifique du type d’objet dans la liste déroulante (Par exemple, « Users » est le type sélectionné - choisissez un utilisateur particulier dans le *Utilisateur* liste déroulante ; le type sélectionné est « Virtual Machines » - choisissez une VM particulière dans la *Machines virtuelles* liste déroulante.) **OU** * Activez le **Utiliser l'étiquette** et sélectionnez une étiquette disponible dans la liste déroulante pour baser l'événement sur les objets portant cette étiquette correspondante. (Par exemple, si « Virtual Machines » est le type sélectionné et que « production » est sélectionné dans la *Étiquette* liste déroulante, le déclencheur d'événement correspond à toutes les VM auxquelles l'étiquette « production » est attribuée.) * **Tâche**: Sélectionnez la tâche créée à l’étape précédente. 4. Cliquez sur **Soumettre** pour enregistrer l’événement. *** **Compatibilité de version**: Cette fonctionnalité est disponible dans VergeOS 26.0 et versions ultérieures. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.verge.io/automate-protect-and-extend/fr/automatisation/webhooks.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.