Skip to main content
Une équipe Enterprise peut envoyer les notifications prises en charge vers son propre endpoint, sous forme d’événements JSON signés. Lorsque l’envoi par webhook est activé, Qwairy n’envoie pas l’email correspondant.
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é.
Le bouton Envoyer un événement de test envoie aussi un événement 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.
Vous pouvez renouveler le secret à tout moment avec Régénérer le secret (la nouvelle valeur n’est affichée qu’une fois), et supprimer le webhook pour revenir à l’email.

Contenu

Chaque requête est un POST avec une enveloppe JSON :
L’objet 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.
Vérifiez la signature de chaque requête et rejetez tout échec. Utilisez une comparaison à temps constant, et rejetez les horodatages hors d’une courte fenêtre pour bloquer les rejeux.

Comportement de l’envoi

  • Qwairy attend une réponse 2xx. Les réponses non 2xx, 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.