Webhooks

Si la configuración de su red restringe el acceso a las conexiones entrantes, debe permitir el tráfico entrante desde direcciones IP para recibir eventos de Webhook de Samsara.

Puede ver la lista de direcciones IP estáticas en el panel de Samsara (Configuración > Webhooks).

Obtenga más información sobre cómo administrar el acceso a la red para Webhooks en nuestro sitio para desarrolladores.

Samsara espera que el punto de conexión de su webhook devuelva un código de estado HTTP 2xx para confirmar la recepción de cada notificación. Cualquier estado 2xx, incluido 202 Accepted, se considera una entrega exitosa. Samsara no vuelve a intentar una entrega exitosa.

Si su punto de conexión no responde en un plazo de 10 segundos o devuelve un estado HTTP de 400 o superior, Samsara considera el intento como un error de entrega. Samsara vuelve a intentar la misma notificación con una espera exponencial, hasta un máximo de cinco intentos. Después de cinco intentos fallidos, Samsara no vuelve a intentar esa notificación.

Si su punto de conexión devuelve una redirección (HTTP 3xx), Samsara considera el intento como un error de entrega y no vuelve a intentar la notificación.

Puede ver la actividad de los webhooks en Métricas del desarrollador.

En la pestaña Tráfico de webhooks, puede revisar los intentos de entrega de los últimos 7 días, incluidos los códigos de estado HTTP. Puede filtrar por código de estado, nombre del webhook y fuente de la carga útil. La frecuencia de éxito es el porcentaje de respuestas 2xx.

Si una entrega excede el tiempo de espera, el intento se registra con el código de estado 499.

Puede deshabilitar o volver a habilitar un webhook desde Configuración > Webhooks.

Mientras un webhook esté deshabilitado, Samsara no envía nuevos incidentes a ese webhook. Después de volver a habilitar el webhook, Samsara reanuda la entrega de nuevos incidentes. Los incidentes que ocurrieron mientras el webhook estaba deshabilitado no se envían.