Webhook

Un webhook est une notification HTTP envoyée automatiquement par AuraPOS vers une URL HTTPS que vous configurez, dès qu un événement métier se produit : vente d un ticket, modification d un client, mise à jour d un produit, création d une promotion. C est l inverse d une API REST où c est le client qui appelle le serveur — ici c est le serveur qui pousse l information.

Avantages décisifs vs polling API :

• **Latence quasi-nulle** : notification au moment exact de l événement (max 1 min)
• **Économie de ressources** : pas de requêtes inutiles toutes les minutes
• **Découplé** : votre intégration peut être down temporairement, AuraPOS retente automatiquement (**retry exponentiel** jusqu à 5 tentatives sur 12 h)
• **Sécurisé** : chaque payload est **signé HMAC-SHA256** avec un secret partagé
• **Standard de l industrie** : utilisé par Stripe, GitHub, Shopify, Slack

Événements supportés (7 au total) :

• `ticket.created` : nouveau ticket validé
• `ticket.cancelled` : ticket annulé
• `client.created` / `client.updated` : nouveau/modifié client
• `produit.updated` : produit créé ou modifié
• `promotion.created` / `promotion.updated`

Cas d usage typiques en commerce belge :

• **Notification équipe** : Webhook → Slack → message "💰 Ticket #1234 — 145 €" dans #ventes
• **Sync CRM** : `client.created` → API Mailchimp / Brevo → ajout liste "Nouveaux clients" + welcome email
• **Workflow Make / Zapier** : webhook → chaîne 5 actions (Sheets + Slack + email + Trello)
• **Push catalogue e-commerce** : `produit.updated` → POST vers Shopify/WooCommerce. Garantit que catalogue web reste à jour.
• **Dashboard BI temps réel** : webhook → Grafana / Metabase → graphique du CA en direct
• **Comptable alertée** : `ticket.created` au-dessus d un seuil → email automatique pour facture B2B

Configuration AuraPOS : Backend web > Paramètres > Webhooks. URL HTTPS, événements, secret HMAC. Historique des 50 dernières livraisons visible avec statut, code HTTP, retry count.