POST à votre endpoint lorsqu’un événement se produit dans Qwoty, par exemple lorsqu’un devis est créé ou validé. Utilisez les webhooks pour tenir vos propres systèmes à jour sans interroger l’API en continu.
Cette page explique comment configurer les webhooks dans l’application. Pour le format du payload et la liste des noms d’événements, consultez Webhooks dans la documentation développeurs.
Pour gérer les webhooks, vous avez besoin d’un rôle disposant de la permission de paramètres Développeurs. Consultez la référence des permissions.
Ouvrir la liste des webhooks
1
Ouvrir les paramètres
Cliquez sur Paramètres dans la navigation principale.
2
Ouvrir Webhook
Dans la section Développeur, cliquez sur Webhook.
Créer un webhook
1
Cliquer sur Nouveau
Cliquez sur Nouveau en haut à droite de la liste.
2
Nommer le webhook
Saisissez un Nom et, si vous le souhaitez, une Description.
3
Saisir l'endpoint
Saisissez l’URL du point de terminaison qui recevra les requêtes, par exemple
https://example.com/webhook.4
Choisir l'objet et les événements
Sélectionnez l’Objet, puis une ou plusieurs valeurs d’Événement. « Sélectionnez les événements que vous souhaitez envoyer à ce point de terminaison. »
5
Ajouter un secret (facultatif)
Saisissez un Secret. Qwoty l’inclut dans le champ
secret de chaque payload : votre endpoint peut ainsi vérifier que la requête provient bien de Qwoty.6
Enregistrer
Cliquez sur Enregistrer.
Objets et événements
Chaque webhook écoute un seul objet. Les événements disponibles dépendent de l’objet :
Pour envoyer des événements sur plusieurs objets, créez un webhook par objet.
Vérifier les livraisons
La colonne Dernière livraison affiche le résultat de la requête la plus récente :
Qwoty attend jusqu’à 10 secondes la réponse de votre endpoint.
Modifier ou supprimer un webhook
Cliquez sur le menu ⋯ en fin de ligne et sélectionnez Modifier ou Supprimer.Ressources associées
Webhooks (développeurs)
Format du payload et noms des événements.
Tokens d'API
Appelez l’API Qwoty depuis vos systèmes.
Intégrations
Connecteurs prêts à l’emploi pour les outils de CRM, de facturation et de messagerie.
Vue d'ensemble des paramètres
Toutes les sections des paramètres.