Skip to main content
Cette page liste les événements de webhook que Le Commis peut émettre. Aujourd’hui, un seul événement métier existe : establishment.content_updated.

​
establishment.content_updated

Émis lorsque le contenu d’un établissement change (profil, horaires, menus, Carte unifiée). C’est un signal : le payload n’embarque pas le contenu, seulement de quoi savoir quoi re-lire.
Payload
{
  "delivery_id": "whd_3f9a...",
  "type": "establishment.content_updated",
  "created_at": "2026-06-14T10:00:00Z",
  "data": {
    "establishment_slug": "au-bistrot",
    "content_revision": 67,
    "changed_resources": ["menus", "business_hours"]
  }
}

​
Champs

​
delivery_id
string
Identifiant unique de la livraison. Identique à l’en-tête X-LeCommis-Delivery. Utilisez-le pour dédupliquer les livraisons rejouées.
​
type
string
Le type d’événement, ici establishment.content_updated.
​
created_at
string (ISO 8601)
Date de création de l’événement, en UTC.
​
data
object
Données de l’événement.
Traitez toujours changed_resources comme un ensemble pouvant contenir plusieurs valeurs, et concevez votre handler pour ignorer une valeur inconnue plutôt que d’échouer : de nouvelles ressources pourront s’y ajouter à l’avenir.

​
Quel endpoint re-lire pour chaque ressource

Mappez chaque valeur de changed_resources vers l’endpoint API à rafraîchir :
changed_resourcesCe qui a changéEndpoint à re-lire
profileIdentité de l’établissement (nom, description, contact, localisation, logo…)GET /establishments/{slug}
business_hoursHoraires d’ouverture réguliersGET /establishments/{slug}/hours
special_hoursHoraires exceptionnels à venirGET /establishments/{slug}/hours
menusUn ou plusieurs menus web (liste et/ou détail)GET /establishments/{slug}/menus
master_menuLa Carte unifiée (PDF combiné de toutes les cartes)GET /establishments/{slug}/menus — champ master_menu_url
En pratique, beaucoup d’intégrations ignorent le détail de changed_resources et se contentent de comparer content_revision à la dernière valeur connue, puis re-fetchent ce dont elles ont besoin. C’est plus simple et tout aussi correct. Voir Révision de contenu.

​
Événement de test

Le bouton « test delivery » des réglages API envoie un événement establishment.webhook_test à votre URL. Il suit le même format d’en-têtes et de signature que les événements réels, ce qui vous permet de valider votre vérification de signature de bout en bout sans attendre un vrai changement de contenu.
D’autres familles d’événements arriveront (notifications de domaine au-delà du simple contenu publiable). Consultez la roadmap pour suivre les ajouts. Concevez votre handler pour ignorer poliment un type inconnu plutôt que d’échouer.