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.
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 |
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) |
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.
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.
Mis à jour le : 17/03/2026
Merci !