> ## 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.

# Configuration des webhooks

> Configurez l'URL, les événements, le secret de signature et les contacts d'un webhook Bodyguard, et comprenez les statuts d'un webhook.

Cette page décrit les champs à renseigner lorsque vous enregistrez un webhook dans le dashboard (**Settings** > **Webhooks** > **Add webhook +**).

## URL de l'endpoint

L'URL qui reçoit les notifications. Il doit s'agir d'une URL `https` publique avec un certificat TLS valide, non auto-signé. Bodyguard refuse les webhooks enregistrés avec une URL `http`.

## Événements

Un webhook est déclenché par un ou plusieurs événements auxquels vous vous abonnez :

| Type d'événement | Déclenché lorsque |
| - | - |
| [`message.updated`](https://docs.bodyguard.ai/fr/api-reference/reference/webhooks/payloads#message-updated) | Un Message est mis à jour dans un Canal. |
| [`author.updated`](https://docs.bodyguard.ai/fr/api-reference/reference/webhooks/payloads#author-updated) | Le statut d'un Auteur change dans une Source. |

Un même webhook peut s'abonner à plusieurs événements. Vous pouvez aussi ajouter un autre webhook avec une URL différente pour traiter d'autres événements séparément.

> [!NOTE]
>
> Bodyguard envoie aussi un événement [`webhook.validate`](https://docs.bodyguard.ai/fr/api-reference/reference/webhooks/payloads#webhook-validate), auquel vous ne pouvez pas vous abonner. Votre endpoint doit y répondre avec un code de statut `2xx` lorsque vous créez le webhook ou modifiez son URL.

Pour le contenu de chaque événement, consultez [Payloads](https://docs.bodyguard.ai/fr/api-reference/reference/webhooks/payloads.md).

## Secret de signature

Bodyguard génère un secret de signature pour chaque webhook. Il commence par `whsec_`, suivi d'une valeur encodée en base64. Le dashboard ne l'affiche qu'une seule fois, à la création du webhook : copiez-le à ce moment-là. Consultez [Connecter votre webhook](https://docs.bodyguard.ai/fr/documentation/how-to/connect-webhook.md).

Bodyguard l'utilise pour signer chaque requête, et vous l'utilisez pour vérifier qu'une requête provient de Bodyguard et n'a pas été altérée. Voir [Démarrage rapide](https://docs.bodyguard.ai/fr/api-reference/webhooks/quick-start.md).

> [!WARNING]
>
> Traitez le secret de signature comme un mot de passe. Conservez-le dans un gestionnaire de secrets ou une variable d'environnement, et ne l'exposez jamais dans du code côté client.

## Contacts

Chaque nouveau webhook nécessite au moins un contact. Bodyguard envoie des alertes à chaque contact s'il rencontre des problèmes pour joindre votre endpoint, comme les e-mails décrits dans [Gérer les erreurs](https://docs.bodyguard.ai/fr/api-reference/webhooks/handling-errors.md#e-mails).

Chaque contact doit être un utilisateur enregistré dans votre organisation sur le dashboard.

## Statuts du webhook

Chaque webhook a un statut qui décrit son état actuel :

| Statut | Description |
| - | - |
| `ENABLED` | Le webhook est actif et prêt à recevoir des notifications. |
| `DISABLED` | Le webhook est inactif et aucune notification n'est envoyée. Vous pouvez définir cette valeur depuis le dashboard. |
| `ERROR` | Le webhook est en erreur et aucune notification n'est envoyée. Bodyguard a tenté plusieurs fois de notifier votre endpoint sans succès. |

Le statut `ERROR` est défini automatiquement. Tant qu'un webhook est `DISABLED` ou `ERROR`, Bodyguard n'envoie pas ses événements, et ils ne peuvent pas être renvoyés lorsque vous réactivez le webhook. Pour réactiver un webhook en erreur, corrigez le problème, puis activez-le manuellement depuis le dashboard. Voir [Gérer les erreurs](https://docs.bodyguard.ai/fr/api-reference/webhooks/handling-errors.md).

## Étapes suivantes

> [card] [Payloads](https://docs.bodyguard.ai/fr/api-reference/reference/webhooks/payloads.md)
>
> En-têtes, structure du payload et un exemple pour chaque type d'événement.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.