Webhooks

C’est quoi ?

Les webhooks permettent à Capnio d’envoyer automatiquement des informations à votre système quand un événement se produit. Par exemple : quand un employé pointe, quand un stock passe en dessous du seuil, ou quand une clôture est validée.

Caution

Les webhooks sont une fonctionnalité technique. Vous avez besoin d’un serveur capable de recevoir des requêtes HTTP POST.

Comment configurer ?

1. Allez dans Intégrations & API
2. Section Webhooks
3. Cliquez sur + Ajouter un webhook
4. Entrez l’URL de votre serveur (ex: https://votre-site.com/webhook)
5. Sélectionnez les événements à écouter
6. Cliquez sur Enregistrer

Événements disponibles

Événement	Quand il se déclenche
employee.clock_in	Un employé pointe à l’arrivée
employee.clock_out	Un employé pointe au départ
stock.low	Un produit passe en dessous du stock minimum
stock.movement	Un mouvement de stock est enregistré
finance.closure	Une clôture journalière est validée
haccp.alert	Une alerte HACCP est déclenchée
haccp.reading	Un relevé de température est enregistré

Format des données

Chaque webhook envoie une requête HTTP POST avec un corps JSON :

{
  "event": "employee.clock_in",
  "timestamp": "2026-01-15T08:02:00Z",
  "storeId": "store123",
  "data": {
    "employeeId": "emp456",
    "employeeName": "Marie Dupont",
    "time": "08:02",
    "method": "facial_recognition"
  }
}

Sécurité

Chaque webhook inclut un header X-Webhook-Signature pour vérifier que la requête vient bien de Capnio. Utilisez votre clé API pour valider la signature.

Questions fréquentes

Mon serveur ne répond pas, que se passe-t-il ? Capnio réessaie 3 fois avec un délai croissant (1 min, 5 min, 30 min). Après 3 échecs, le webhook est désactivé et vous recevez un email d’alerte.

Je peux tester les webhooks ? Oui, utilisez un service comme webhook.site pour voir les requêtes envoyées par Capnio sans avoir besoin d’un serveur.