> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.anghello.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Configurer les webhooks

Les webhooks permettent à Anghello d'envoyer automatiquement des notifications à vos applications quand un événement se produit (arrivée d'un visiteur, départ, etc.). Ce guide vous montre comment les créer et les gérer.

**Audience :** Administrateurs
**Application :** Admin (app.anghello.co)
**Temps estimé :** 10 minutes

## Avant de commencer

* Vous devez avoir un **compte Administrateur** sur Anghello
* Le module **« API & Webhooks »** doit être inclus dans votre abonnement
* Vous devez disposer d'une **URL de réception** (endpoint HTTPS) dans votre application

## Créer un webhook

**1. Accédez à la page Webhooks**

Dans le menu à gauche, cliquez sur la case qui contient votre prénom tout en bas puis cliquez sur **API Keys**. Enfin, cliquez sur l'onglet **Webhooks**.

![](https://storage.crisp.chat/users/helpdesk/website/-/2/0/a/6/20a671ba57d61a00/screenshot15xpostspark2026-03-_6da8vv.png)

**2. Ajouter un webhook**

Cliquez sur le bouton **Add a webhook**.

**3. Configurez le webhook**

| Champ | Obligatoire | Description |
| ---- |
| **URL de l'endpoint** | Oui | L'adresse HTTPS qui recevra les données (doit commencer par `https://`) |
| **Description** | Non | Un texte libre pour décrire l'usage de ce webhook |
| **Site** | Non | Si sélectionné, le webhook ne se déclenche que pour les événements de ce site. Sinon, il se déclenche pour tous les sites. |
| **Événements** | Oui | Les types d'événements qui déclenchent le webhook (voir ci-dessous) |

![](https://storage.crisp.chat/users/helpdesk/website/-/2/0/a/6/20a671ba57d61a00/screenshot15xpostspark2026-03-_prw4if.png)

**4. Enregistrez**

Cliquez sur **Enregistrer**. Une fenêtre vous montre le secret du webhook (**à absolument garder**) qui devient actif immédiatement.

## Événements disponibles

Sélectionnez un ou plusieurs événements parmi :

* **Visiteur enregistré** — Un visiteur vient de s'enregistrer
* **Visiteur sorti** — Un visiteur a enregistré son départ
* **Visite pré-enregistrée** — Une visite a été planifiée
* **Visite annulée** — Une visite pré-enregistrée a été annulée

## Consulter les détails d'un webhook

Cliquez sur un webhook dans la liste pour voir :

* L'**URL** de l'endpoint
* La **clé secrète** (utilisée pour vérifier l'authenticité des requêtes)
* L'**historique des envois** (succès, échecs)

## Activer ou désactiver un webhook

Vous pouvez désactiver temporairement un webhook sans le supprimer :

**1.** Ouvrez le webhook concerné.

**2.** Modifier le webhook en cliquant sur l'icône crayon.

**2.** Désactivez/activez le toggle **Enable Webhook**.

**3.** Enregistrez.

## Limites

| Limite | Valeur |
| ---- |
| Nombre maximum de webhooks | 5 par organisation |
| Nombre maximum par événement | 3 webhooks par type d'événement |

### Bon à savoir

> 💡 **Astuce :** Chaque webhook reçoit une **clé secrète** unique. Utilisez-la pour vérifier que les requêtes proviennent bien d'Anghello.

> 💡 **Astuce :** Si votre endpoint est temporairement indisponible, les webhooks en échec sont affichés dans l'historique des envois. Anghello ne retente pas automatiquement les envois échoués.

||  **Important :** L'URL de l'endpoint doit utiliser le protocole **HTTPS**. Les URLs HTTP ne sont pas acceptées.

## En cas de problème

| Problème | Solution |
| ---- |
| La page Webhooks n'apparaît pas | Le module « API & Webhooks » n'est pas inclus dans votre abonnement. Contactez notre équipe. |
| Le webhook ne se déclenche pas | Vérifiez que le webhook est actif et que l'événement est bien sélectionné. Consultez l'historique des envois. |
| L'endpoint retourne une erreur | Vérifiez que votre serveur est accessible et que l'URL est correcte. Les erreurs sont affichées dans l'historique. |
| La limite de webhooks est atteinte | Supprimez un webhook existant ou désactivez ceux que vous n'utilisez plus. |

Si le problème persiste, contactez notre équipe via le chat en bas à droite de votre écran ou à support@anghello.co.