> ## Documentation Index > Fetch the complete documentation index at: https://docs.bodyguard.ai/llms.txt > Use this file to discover all available pages before exploring further. # Connecter votre webhook > Enregistrez un webhook dans le dashboard Bodyguard pour recevoir des notifications sur votre endpoint. Un webhook notifie votre endpoint lorsque des événements se produisent dans Bodyguard, comme la mise à jour d'un message ou d'un auteur. Cette page vous guide pour en enregistrer un dans le dashboard. Pour comprendre le fonctionnement des webhooks, consultez l'[introduction aux webhooks](https://docs.bodyguard.ai/fr/api-reference/webhooks/introduction.md). ## Prérequis Vous avez besoin d'un endpoint HTTPS public, prêt à recevoir des notifications. Bodyguard refuse les webhooks enregistrés avec une URL `http`. Consultez le [Démarrage rapide](https://docs.bodyguard.ai/fr/api-reference/webhooks/quick-start.md) pour créer votre endpoint et vérifier la signature de chaque requête. ## Étapes **1. Ajouter un webhook** 1. Cliquez sur l'icône d'engrenage dans le menu de gauche pour ouvrir **Settings**, sélectionnez **Webhooks**, puis cliquez sur **Add webhook**. ![Page Webhooks avec l'icône d'engrenage Settings (1), l'entrée Webhooks (2) et le bouton Add webhook (3) en surbrillance](https://mintcdn.com/bodyguardai/oGCRxEeuFI_d_hrR/images/how-to/connect-webhook/01-open-webhooks-page.png?fit=max\&auto=format\&n=oGCRxEeuFI_d_hrR\&q=85\&s=71ad72d9f89c307321eb2981a9acf4c9) Settings > Webhooks 2. Remplissez le formulaire. Les numéros correspondent à la capture d'écran ci-dessous. **1.** Saisissez l'**Endpoint URL** qui reçoit les notifications. Elle doit être accessible publiquement en HTTPS.\\ **2.** Ajoutez au moins un **Alert contact**. Bodyguard prévient vos contacts lorsque les envois vers cet endpoint échouent. Chaque contact doit être un utilisateur enregistré dans votre organisation sur le dashboard.\\ **3.** Choisissez les **Sources** auxquelles le webhook s'applique. Dans cet exemple, **All the organization's API sources** est sélectionné.\\ **4.** Sélectionnez les **Events** auxquels vous vous abonnez : `message.updated` (lorsqu'un message est mis à jour par Bodyguard) et `author.updated` (lorsqu'un auteur est mis à jour par Bodyguard).\\ **5.** Cliquez sur **Create webhook**. ![Fenêtre New webhook avec les champs Endpoint URL (1), Alert contact (2), Sources (3) et Events (4), et le bouton Create webhook (5) en surbrillance](https://mintcdn.com/bodyguardai/oGCRxEeuFI_d_hrR/images/how-to/connect-webhook/02-new-webhook-form.png?fit=max\&auto=format\&n=oGCRxEeuFI_d_hrR\&q=85\&s=b3c06997e442288a625613943e370d37) Formulaire de création d'un webhook Consultez [Configuration](https://docs.bodyguard.ai/fr/api-reference/webhooks/configuration.md) pour le détail de chaque champ et [Payloads](https://docs.bodyguard.ai/fr/api-reference/reference/webhooks/payloads.md) pour le contenu de chaque événement. > [!NOTE] > > Lorsque vous créez le webhook, Bodyguard envoie un événement [`webhook.validate`](https://docs.bodyguard.ai/fr/api-reference/reference/webhooks/payloads#webhook-validate) à votre endpoint. Votre endpoint doit y répondre avec un code de statut `2xx`. **2. Copier votre secret de signature** Bodyguard génère un secret de signature lorsque vous créez le webhook et l'affiche dans la fenêtre **Webhook created**. Copiez-le avec l'icône de copie et conservez-le en lieu sûr, puis cliquez sur **Done**. Le secret commence par `whsec_`. ![Fenêtre Webhook created avec le champ du secret de signature et son icône de copie en surbrillance](https://mintcdn.com/bodyguardai/oGCRxEeuFI_d_hrR/images/how-to/connect-webhook/03-signing-secret.png?fit=max\&auto=format\&n=oGCRxEeuFI_d_hrR\&q=85\&s=3c03ea994fe4205b5afd49160524df63) Secret de signature affiché à la création > [!WARNING] > > Le secret de signature n'est affiché qu'une seule fois. Vous ne pourrez plus le consulter après avoir fermé la fenêtre. Traitez-le comme un mot de passe et ne l'exposez jamais dans du code côté client. Vous utilisez le secret de signature pour vérifier que chaque requête provient bien de Bodyguard. Consultez le [Démarrage rapide](https://docs.bodyguard.ai/fr/api-reference/webhooks/quick-start.md). **3. Activer et tester votre webhook** Votre webhook est créé avec le statut `Disabled`. Activez-le lorsque votre endpoint est prêt à recevoir des événements. Cliquez sur le menu **⋮** à la fin de la ligne du webhook pour ouvrir ses actions : ![Liste des webhooks avec le bouton trois points de la ligne du webhook (1) et son menu d'actions en surbrillance, affichant Send test event, Edit webhook, Enable webhook et Delete webhook](https://mintcdn.com/bodyguardai/oGCRxEeuFI_d_hrR/images/how-to/connect-webhook/04-webhook-actions-menu.png?fit=max\&auto=format\&n=oGCRxEeuFI_d_hrR\&q=85\&s=f6f543e38882a16540b4c21afdfa074c) Menu d'actions du webhook * **Enable webhook** active le webhook. * **Send test event** vous permet de vérifier que votre endpoint reçoit des événements. * **Edit webhook** et **Delete webhook** vous permettent de modifier ou de supprimer le webhook. > [!NOTE] > > Tant qu'un webhook est désactivé, Bodyguard n'envoie pas ses événements, et ils ne peuvent pas être rejoués lorsque vous réactivez le webhook. Consultez les [statuts du webhook](https://docs.bodyguard.ai/fr/api-reference/webhooks/configuration.md#statuts-du-webhook). ## Étapes suivantes > [card] [Démarrage rapide](https://docs.bodyguard.ai/fr/api-reference/webhooks/quick-start.md) > > Créez un endpoint et vérifiez chaque requête avec une bibliothèque Standard Webhooks. > [card] [Configuration](https://docs.bodyguard.ai/fr/api-reference/webhooks/configuration.md) > > Événements, secret de signature, contacts et statuts du webhook. > [card] [Gérer les erreurs](https://docs.bodyguard.ai/fr/api-reference/webhooks/handling-errors.md) > > Ce qui se passe lorsque votre endpoint échoue, et comment rétablir la situation. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.