Skip to main content
Les webhooks sont des messages automatisés envoyés par Qwoty lorsqu’un événement se produit dans notre système. Ils contiennent un payload spécifique pour chaque action qu’ils signalent et sont envoyés sous forme de requêtes HTTP POST vers un endpoint HTTPS sur votre serveur. Les webhooks vous aident à intégrer votre application avec Qwoty et à réagir aux événements en temps réel.

​
Ajouter un endpoint webhook

Pour commencer à écouter les messages webhook envoyés par Qwoty, accédez aux paramètres de webhook dans le tableau de bord, cliquez sur Ajouter un webhook, fournissez une URL HTTPS publique que vous contrôlez, et sélectionnez les types d’événements que vous souhaitez recevoir. Vous pouvez ajouter plusieurs endpoints si vous souhaitez séparer les événements par destination.

​
Types d’événements

Qwoty prend en charge une variété de types d’événements webhook pour des entités telles que les clients, les devis et bien plus encore. Lorsqu’un événement se produit, Qwoty envoie un POST webhook à votre endpoint avec un payload JSON contenant :

​
Consommer des webhooks

Les livraisons de webhooks sont toujours des requêtes HTTP POST en HTTPS contenant un corps JSON. Votre endpoint doit :
  1. Retourner rapidement un statut de succès 2xx avant d’effectuer une logique complexe afin d’éviter les délais d’expiration.
  2. Vérifier les signatures et les horodatages des webhooks pour garantir leur authenticité et se prémunir contre les attaques par rejeu.

​
Meilleures pratiques

  • Traitement idempotent : Protégez-vous contre les événements en double en vous assurant que la logique de votre gestionnaire peut traiter le même événement plusieurs fois sans problème.
  • Récupérer l’état le plus récent de l’entité : Étant donné que les événements peuvent être retentés avec des données obsolètes, envisagez de récupérer l’état le plus récent de l’objet concerné après la réception d’un webhook.
  • Liste blanche d’adresses IP statiques : Si votre endpoint webhook est derrière un pare-feu, autorisez le trafic provenant des adresses IP du serveur webhook de Qwoty.

​
Gérer les webhooks

Qwoty prend en charge des opérations API pour :
  • Créer des endpoints webhook
  • Lister les endpoints webhook
  • Récupérer un endpoint webhook spécifique
  • Mettre à jour des endpoints webhook
  • Supprimer des endpoints webhook

​
Livraison des événements et calendrier de nouvelle tentative

Lorsque Qwoty tente de livrer des événements webhook :
  • Si votre endpoint répond avec un statut non-2xx, Qwoty retentera la livraison selon un calendrier défini (par exemple, à quelques secondes, minutes ou heures d’intervalle).
  • La livraison des événements n’est pas garantie dans un ordre strict, aussi concevez votre logique de traitement en conséquence.