Paramètres d'affichage

Choisissez un thème pour personnaliser l'apparence du site.

Notifications BAN

La gestion de vos abonnements notifications BAN se fait depuis votre espace Mon compte.

Guide d'utilisation - Comprendre et configurer les webhooks

Qu'est-ce qu'un webhook ?

Un webhook est un mécanisme de notification HTTP qui permet à une application d'envoyer automatiquement des données vers une autre application lorsqu'un événement se produit.

Dans le contexte des Bases Adresses Locales (BAL), les webhooks permettent d'être alerté instantanément lorsqu'une BAL est publiée, ou si elle rencontre un problème et doit être corrigée puis republiée.

Workflow

Cas d'erreur

BAL publiée → Validation échoue → BAL bloquée → Webhook d'alerte envoyé → Équipe technique notifiée → Investigation et correction → Nouvelle soumission

Cas de validation réussie

BAL publiée → Validation réussie → BAL acceptée → Webhook informatif envoyé → Équipe notifiée

Objectif : Réduire le délai entre la détection d'un problème et sa résolution pour maintenir la qualité des données adresses en continu.

Configuration du webhook

Intégrations

Canaux de notification

Messageries d'équipe :

  • Microsoft Teams : Connecteur webhook → Canal dédié SIG/Adressage
  • Slack : Incoming Webhooks → Canal technique
  • Mattermost : Webhook entrant → Équipe BAL

Test

Validation avec webhook.site
  1. Accédez à webhook.site
  2. Copiez l'URL endpoint générée
  3. Saisissez cette URL dans le formulaire de création d'abonnement
  4. Sélectionnez vos communes à surveiller
  5. Choisissez les types d'alertes (erreurs, avertissements, succès)

Permet de visualiser en temps réel les notifications reçues pour comprendre le format des données.

Scénarios d'usage

Service communal

Contexte : Gestion directe des BAL pour 50 communes
Configuration : Webhook → Canal Teams "Adressage"
Workflow : Alerte reçue → Agent vérifie la BAL → Correction → Republication
Bénéfice : Résolution sous 24h au lieu de plusieurs semaines

Prestataire technique (GeoPal, etc.)

Contexte : Gestion BAL pour plusieurs collectivités clientes
Configuration : Webhook → Système de tickets automatique
Workflow : Problème détecté → Ticket créé → Technicien assigné → Correction client → Republication
Bénéfice : Suivi proactif et amélioration de la qualité de service

Spécifications techniques

Format des notifications
{
 "type": "ban-alert",
 "status": "error",
 "commune": {
   "code": "76734",
   "nom": "Vergetot"
 },
 "revision": {
   "id": "A39HFQCTA",
   "publishedAt": "2024-09-09T11:23:00Z"
 },
 "message": "BAL bloquée - updateDate manquant",
 "timestamp": "2024-09-09T11:23:00Z"
}
Types d'alertes

  • ERREUR

    BAL bloquée - Action requise

  • AVERTISSEMENT

    Problème détecté - BAL bientôt bloquée

  • SUCCÈS

    BAL publiée avec succès

  • INFORMATION

    Information sur le traitement
Prérequis techniques
  • URL endpoint HTTPS et accessible publiquement