Aller au contenu
AurionAI

Webhooks de notification

4 min de lecturePar Emmanuel Yazbeck

Un webhook de notification envoie les événements de notification AurionAI vers un autre système, par exemple un outil de messagerie. AurionAI publie chaque événement sous forme de corps JSON à l'adresse que vous saisissez.

Disponibilité : Profils Helpdesk et AI Voice + Helpdesk. Administrateurs uniquement.

Prérequis

  • Vous avez le rôle Propriétaire ou Administrateur. Les autres utilisateurs voient Accès refusé.
  • Votre organisation utilise le profil Helpdesk ou AI Voice + Helpdesk.
  • Une adresse HTTPS publique qui accepte les requêtes POST avec un corps JSON.

Ouvrir les webhooks de notification

  1. Dans la barre latérale, sélectionnez Paramètres.
  2. Ouvrez la catégorie Système.
  3. Sélectionnez Webhooks de notification.

La page Webhooks de notification avec la liste des webhooks.

Ajouter un webhook

  1. Sélectionnez Ajouter un webhook.
  2. Dans Nom, saisissez un nom.
  3. Dans URL, saisissez l'adresse. Elle doit commencer par https://.
  4. Facultatif : dans Secret (optionnel), saisissez un secret. AurionAI signe alors chaque requête. Laissez ce champ vide pour envoyer des requêtes non signées.
  5. Choisissez les événements :
    • Pour recevoir tous les événements de notification, activez S'abonner à tous les événements.
    • Sinon, sélectionnez les événements dans la liste.
  6. Sélectionnez Créer.

Le message Webhook créé s'affiche. Un nouveau webhook est Activé.

Tester le webhook

  1. Sur le webhook, sélectionnez Tester.
  2. Dans la boîte de dialogue Envoyer un événement de test ?, sélectionnez Envoyer le test.

AurionAI envoie immédiatement un événement webhook.test. Le message Payload de test envoyé avec succès ou Échec de l'envoi du payload de test s'affiche.

Vérifier la signature

Lorsque le webhook possède un secret, chaque requête contient deux en-têtes supplémentaires :

  • X-Webhook-Timestamp : l'heure de la requête, en secondes depuis le 1er janvier 1970 (UTC).
  • X-Webhook-Signature : sha256= suivi de la signature.

Pour vérifier une requête, calculez un HMAC-SHA256 du timestamp, d'un point et du corps brut, avec votre secret. Écrivez le résultat en hexadécimal. Il doit être égal à la partie après sha256=.

Modifier, désactiver ou supprimer un webhook

  • Pour modifier un webhook, sélectionnez Modifier le webhook, modifiez les champs et sélectionnez Enregistrer. Laissez le secret vide pour le conserver, ou sélectionnez Supprimer le secret pour envoyer des requêtes non signées.
  • Pour suspendre les livraisons temporairement, ouvrez Modifier le webhook et basculez le commutateur sur Désactivé. Enregistrez ensuite.
  • Pour supprimer un webhook, sélectionnez Supprimer. Dans la boîte de dialogue Supprimer ce webhook ?, sélectionnez Supprimer le webhook. Cela supprime également son historique de livraison et son secret. Cette action est irréversible.
  • Pour consulter les livraisons passées, sélectionnez Historique sur le webhook. Chaque ligne affiche Livré, Échec ou Ignoré, avec la raison de l'échec le cas échéant.

Résultat

AurionAI envoie chaque événement sélectionné au moment où il se produit. Si votre adresse ne répond pas, ou répond avec un statut 5xx, AurionAI réessaie immédiatement, jusqu'à trois tentatives au total. Une réponse 4xx est définitive : AurionAI ne réessaie pas.

En cas de problème

  • L'URL doit commencer par https://. Commencez l'adresse par https://.
  • Les points de terminaison de métadonnées cloud sont toujours bloqués. ou un message indiquant qu'une adresse IP se trouve dans une plage bloquée. AurionAI n'envoie pas de webhooks vers des adresses privées ou internes. Utilisez une adresse publique.
  • Un message indique que la résolution DNS a échoué. Le nom d'hôte n'existe pas ou ne possède aucun enregistrement DNS. Vérifiez l'adresse.
  • Sélectionnez au moins un événement ou choisissez « S'abonner à tous les événements ». Sélectionnez au moins un événement, ou activez S'abonner à tous les événements.
  • Échec de l'envoi du payload de test Lisez la raison, le statut HTTP et le nombre de tentatives dans le message. Vérifiez que votre récepteur est en ligne et répond avec un statut 2xx.
  • Ce webhook est désactivé Activez d'abord le webhook. Si vous sélectionnez Envoyer quand même, AurionAI enregistre uniquement une tentative ignorée.
  • Une livraison affiche Ignoré. Le webhook était désactivé, ou l'adresse n'a pas passé la vérification de sécurité avant l'envoi. Lisez la raison dans l'historique.
  • Impossible de charger les webhooks ou Impossible de charger les événements de notification Sélectionnez Réessayer.

Articles connexes

Besoin d’aide supplémentaire ? Envoyez une demande ou .