Webhooks

Si vos paramètres réseau restreignent l'accès aux connexions entrantes, vous devez autoriser le trafic entrant provenant d'adresses IP à recevoir des événements Webhook de Samsara.

Vous pouvez consulter la liste des adresses IP statiques dans le tableau de bord Samsara (Paramètres > Webhooks).

En savoir plus sur la gestion de l'accès réseau pour les Webhooks sur notre site des développeurs.

Samsara attend de votre point de terminaison de webhook qu'il renvoie un code d'état HTTP 2xx pour confirmer la réception de chaque notification. Tout état 2xx, y compris 202 Accepted, constitue une livraison réussie. Samsara ne retente pas une livraison réussie.

Si votre point de terminaison ne répond pas dans les 10 secondes ou renvoie un état HTTP de 400 ou plus, Samsara considère la tentative comme une erreur de livraison. Samsara retente la même notification avec un délai d'attente exponentiel, jusqu'à cinq tentatives. Après cinq tentatives infructueuses, Samsara ne retente pas cette notification.

Si votre point de terminaison renvoie une redirection (HTTP 3xx), Samsara considère la tentative comme une erreur de livraison et ne retente pas la notification.

Vous pouvez afficher l'activité du webhook dans Métriques des développeurs.

Dans l'onglet Trafic des webhooks, vous pouvez consulter les tentatives de livraison des 7 derniers jours, y compris les codes d'état HTTP. Vous pouvez filtrer par code d'état, nom du webhook et source des données utiles. La fréquence de réussite correspond au pourcentage de réponses 2xx.

Si une livraison expire, la tentative est enregistrée avec le code d'état 499.

Vous pouvez désactiver ou réactiver un webhook depuis Paramètres > Webhooks.

Lorsqu'un webhook est désactivé, Samsara n'envoie pas de nouveaux événements à ce webhook. Après avoir réactivé le webhook, Samsara reprend la livraison des nouveaux événements. Les événements survenus pendant que le webhook était désactivé ne sont pas envoyés.