Les webhooks sortants font partie des Agences, une fonctionnalité Enterprise. Leurs réglages sont réservés au rôle OWNER (Propriétaire).
Événements
report.weekly
Le rapport hebdomadaire d’un workspace.
export.ready
Un export de données est terminé et prêt à être téléchargé.
webhook.test pour valider votre endpoint avant d’activer l’envoi.
Configurer l’envoi
1
Ouvrez Marque blanche
Ouvrez Gestion de l’équipe > Marque blanche et repérez la carte Webhooks sortants.
2
Ajoutez l’URL de votre endpoint
Saisissez une URL
https publique et enregistrez-la. Les adresses privées et les URL http sont refusées. Un secret de signature est généré et affiché une seule fois : copiez-le et conservez-le.3
Envoyez un événement de test
Cliquez sur Envoyer un événement de test pour vérifier que Qwairy atteint votre endpoint et que votre contrôle de signature passe.
4
Activez l’envoi
Activez Envoyer par webhook. Les événements ci-dessus partent alors vers votre endpoint au lieu d’être envoyés par email.
Contenu
Chaque requête est unPOST avec une enveloppe JSON :
data dépend de l’événement. Traitez-le comme évolutif : de nouveaux champs peuvent apparaître, ignorez donc ceux que vous n’utilisez pas au lieu de rejeter le contenu.
En-têtes
Vérifier la signature
La signature est un HMAC-SHA256 calculé avec votre secret de signature. Son entrée est<timestamp>.<body>, avec les octets bruts de la requête avant l’analyse JSON.
Comportement de l’envoi
- Qwairy attend une réponse
2xx. Les réponses non2xx, les délais dépassés et les redirections comptent comme des échecs. - Un envoi de rapport hebdomadaire en échec est retenté à l’exécution planifiée suivante ; l’email correspondant n’est pas envoyé à sa place.
- L’événement d’export prêt n’est envoyé qu’une fois : en cas d’échec, l’export reste disponible dans l’espace Exports de votre workspace.

