<aside> <img src="/icons/light-bulb_blue.svg" alt="/icons/light-bulb_blue.svg" width="40px" />

Les webhooks sortants envoient des notifications JSON signées (HMAC) vers votre outil (n8n, script, API). Inclus dans le plan Essentiel.

</aside>

Contexte

Un webhook sortant est une URL HTTPS vers laquelle Qwease envoie des requêtes POST JSON signées. Vous les configurez dans l’administration, puis vous les déclenchez via une automatisation (ex. à la création d’un ticket).

Avant de commencer

• Compte administrateur Qwease.
• Côté réception : une URL HTTPS qui accepte un POST et peut lire le corps brut de la requête (nécessaire pour vérifier la signature).

Créer un webhook

1. Connectez-vous à Qwease.
2. Ouvrez Espace Administration → Intégrations → Webhooks.
3. Cliquez sur Nouveau webhook.
4. Renseignez Nom, URL (endpoint complet) et, si besoin, Description.
5. Cliquez sur Créer.
6. Copiez la clé secrète affichée : elle ne sera plus visible ensuite. Conservez-la dans un gestionnaire de secrets.

Tester le webhook (obligatoire)

Tant qu’un webhook n’a pas réussi un test, il ne peut pas être utilisé dans une automatisation.

1. Sur la fiche webhook, cliquez sur Tester.
2. Qwease envoie un POST signé avec "event": "webhook.test".
3. Votre endpoint doit répondre HTTP 2xx.
4. Le statut passe à Test OK : le webhook est utilisable.

En cas d’échec, corrigez l’URL ou la configuration côté récepteur, puis relancez le test.