Configuration des Webhooks

Les webhooks vous permettent de recevoir des mises à jour de données en temps réel de notre plateforme en envoyant des requêtes HTTP à vos points de terminaison spécifiés. Ce guide vous aidera à configurer et à paramétrer des webhooks pour vos capteurs.

Page de configuration

La page de configuration du webhook est accessible via un onglet sur la vue de votre capteur :

Ajouter un webhook

Cliquez sur le bouton + Add Webhook pour ajouter un nouveau webhook à votre capteur :

Voici la liste des paramètres que vous pouvez configurer sur votre webhook :

1. URL : le point de terminaison http(s) où nous devons envoyer les données.
2. Actions : l'événement déclencheur que nous utilisons pour envoyer le message à votre webhook (soit Keep alive ou Payload transfer)
   • Keep alive : Un webhook est déclenché toutes les 10 minutes avec l'état de santé de l'appareil. vous pouvez consulter le format du payload ici
   • Payload transfer : Un webhook est déclenché chaque fois que l'état de votre application subit des modifications pertinentes. vous pouvez consulter le format du payload ici et les intervalles de déclenchement spécifiques en fonction de votre type d'application.
   • Alert : Un webhook est déclenché chaque fois que votre application détecte une condition d'alerte. Voir la page Alert Format pour plus de détails. Les messages d'alertes utilisent les mêmes champs de premier niveau et incluent le tableau alert décrit sur la page dédiée.
3. Méthod : le verbe HTTP utilisé pour envoyer les données (généralement POST, pourrait également utiliser GET pour les payloads Keep Alive)
4. Headers : une liste d'en-têtes HTTP à ajouter à la requête. cela est utile pour sécuriser la communication (utilisation d'un en-tête de jeton)
5. Params : une liste de paramètres "query strings" à ajouter à la requête.
6. Active : cochez cette case si vous souhaitez que votre webhook soit activé directement.

Bonnes pratiques de sécurité

• Utilisez toujours HTTPS pour garantir que les données sont transmises de manière sécurisée.
• Validez la signature du payload pour vérifier l'authenticité de la requête.
• Limitez les adresses IP autorisées à envoyer des requêtes à votre point de terminaison.