Aller au contenu

Être notifié avec les webhooks

Envoyez un message signé à une autre application chaque fois qu’une facture est émise, qu’un paiement est comptabilisé, que le stock devient bas, et plus encore.

5 min de lecture Vrais écrans, données d'exemple fictives Mis à jour le 22 octobre 2026

Sur cette page

Un webhook est un message que nous envoyons en POST à l’adresse de votre application lorsqu’un événement se produit dans votre entreprise, afin que l’autre application n’ait pas à interroger sans cesse.

  1. Étape 1 : Ajouter un point de terminaison

    Dans Administration → Paramètres → API et webhooks, sous Webhooks, cliquez sur Ajouter un point de terminaison.

  2. Étape 2 : Saisir l’adresse

    Renseignez l’URL du point de terminaison (il doit s’agir d’une adresse https:// publique) et une Description facultative.

  3. Étape 3 : Choisir les événements

    Sous Événements, cochez ceux dont vous avez besoin, ou Tous les événements, y compris ceux ajoutés ultérieurement.

  4. Étape 4 : Copier le secret de signature

    Après l’enregistrement, le Secret de signature s’affiche une seule fois. Copiez-le dans l’application réceptrice afin qu’elle puisse vérifier que chaque message provient bien de nous.

  5. Étape 5 : Le tester

    Cliquez sur Envoyer un événement de test et consultez le Journal des livraisons.

Événements disponibles

  • Contacts : un contact a été créé ou modifié.
  • Factures : émise, entièrement payée, annulée. Devis : accepté.
  • Paiements : un paiement ou un encaissement a été comptabilisé.
  • Factures fournisseurs : reçue (comptabilisée), entièrement payée. Dépenses : une dépense a été enregistrée.
  • Stock : un article est descendu au niveau de réapprovisionnement ou en dessous.
  • Congés : une demande de congé a été créée.

Livraisons et nouvelles tentatives

  • Votre application doit répondre avec un statut 2xx dans les 10 secondes. Toute autre réponse est considérée comme un échec.
  • Les livraisons en échec sont retentées automatiquement, jusqu’à six tentatives sur plusieurs heures, avec des délais de plus en plus longs.
  • Ouvrez un point de terminaison avec Gérer pour voir le Journal des livraisons : chaque événement avec sa Charge utile, la Réponse de votre serveur et un statut Livré, Échoué ou En attente. Cliquez sur Renvoyer pour en envoyer un à nouveau.
  • Décochez Envoyer les événements à ce point de terminaison pour le suspendre, ou cliquez sur Supprimer pour le supprimer. Un point de terminaison qui échoue de façon répétée pendant longtemps est désactivé automatiquement.

Vérifier la signature

Chaque livraison comporte l’en-tête X-Webhook-Signature: t=<timestamp>,v1=<signature>. Calculez le HMAC-SHA256 de « <timestamp>.<raw body> » avec votre secret de signature et comparez-le à v1 ; rejetez les horodatages de plus de 5 minutes. X-Webhook-Id reste identique d’une tentative à l’autre ; utilisez-le pour ignorer les doublons.

Posez une question sur le produit

Demandez ce que le logiciel sait faire, comment fonctionne une tâche, ou quels pays et langues il prend en charge. Les réponses proviennent de ces guides.

Réflexion…

L’assistant IA n’est pas disponible pour le moment. Consultez les guides ou contactez notre équipe. Contacter le support

L’IA peut se tromper. Consultez les guides en lien.

Toujours besoin d'aide ?

Notre équipe support lit chaque message et répond dans un langage clair.

Contacter le support
Discuter avec l’IA