Prueba gratis

Integración · Desarrolladores

Alertas firmadas vía webhooks

Cada alerta como JSON a tu propio endpoint, firmada con HMAC-SHA256 para que puedas demostrar que viene de Uptimecheck.

Prueba gratis Prueba la demo en vivo

14 días de prueba gratis · Después, gratis con 5 monitores · Sin tarjeta de crédito

Lo que obtienes

  • Peticiones firmadas

    Cada POST incluye x-uptimecheck-timestamp y x-uptimecheck-signature: un HMAC-SHA256 del timestamp y el cuerpo, con el secreto de firma del canal como clave.

  • Nombres de eventos claros

    monitor.down, monitor.up, monitor.slow, certificate.expiring, dns.changed y más, para que tu código decida según un solo campo.

  • Un incidente, en ambos lados

    monitor.down y monitor.up llevan el mismo ID de incidente, así que puedes abrir y cerrar el registro correspondiente en tu lado.

  • Reintentos incluidos

    Cualquier respuesta que no sea 2xx en 10 segundos se reintenta a los 30 segundos, 2, 10 y 30 minutos. Un 410 Gone detiene los reintentos.

Cómo conectar Webhooks

  1. Abre Alert channels en la barra lateral y elige Add channel.

  2. Elige Webhook e introduce la Endpoint URL.

  3. Elige Add channel y copia el secreto de firma que aparece. Solo se muestra una vez.

  4. Elige Send test para enviar un evento de prueba a tu endpoint.

Todos los campos y una versión en Python de la comprobación están en la referencia de la API.

Incluido en todos los planes, también en el plan Free.

Configúralo Cómo configurar y verificar alertas por webhook

Qué llega

monitor.down
Una caída confirmada
monitor.up
La recuperación, con el tiempo de caída
monitor.slow
Respuestas por encima de tu límite
monitor.fast
De nuevo por debajo del límite
certificate.expiring
Un certificado TLS caduca pronto o ha caducado
domain.expiring
El registro de un dominio caduca pronto o ha caducado
dns.changed
Registros DNS cambiados, con el antes y el después
server.rebooted
Un servidor con el agente se ha reiniciado
site.issues
Nuevos enlaces rotos o contenido mixto
site.performance_dropped
La puntuación de velocidad móvil de una página ha bajado de tu límite
domain.email_issues
Nuevos problemas en la configuración de correo de un dominio
test
Enviado con Enviar prueba

POST a tu endpoint

x-uptimecheck-timestamp: 1792120324
x-uptimecheck-signature: sha256=5d2c…e81f

{
  "event": "monitor.down",
  "workspace": "Northwind",
  "monitor": {
    "id": "mon_9xk2m1q8w4",
    "name": "Checkout",
    "target": "https://northwind.shop/checkout",
    "url": "https://app.uptimecheck.com/w/northwind/monitors/mon_9xk2m1q8w4"
  },
  "incident": {
    "id": "inc_7b3t9r2m5c",
    "url": "https://app.uptimecheck.com/w/northwind/incidents/inc_7b3t9r2m5c"
  },
  "cause": "HTTP 502",
  "regions": ["eu-north"],
  "at": "2026-10-16T03:12:04.000Z",
  "downtimeSeconds": null,
  "explanation": null
}
Un evento monitor.down. monitor.up lleva el mismo ID de incidencia y el tiempo de inactividad en segundos.

Preguntas

¿Cómo verifico la firma?

Calcula HMAC-SHA256 sobre el valor de x-uptimecheck-timestamp, un punto y el cuerpo sin procesar de la petición, con el secreto de firma como clave. Compáralo en tiempo constante con el valor hexadecimal tras sha256= en x-uptimecheck-signature y rechaza los timestamps antiguos.

¿Qué eventos se envían?

monitor.down, monitor.up, monitor.slow, monitor.fast, certificate.expiring, domain.expiring, dns.changed, server.rebooted, site.issues, site.performance_dropped, domain.email_issues y test.

¿Qué pasa cuando mi endpoint está caído?

Una petición que no recibe una respuesta 2xx en 10 segundos se reintenta cuatro veces más, a los 30 segundos, 2 minutos, 10 minutos y 30 minutos. Después, el canal muestra “Not delivering” con el último error. Responder 410 Gone detiene los reintentos al momento.

¿Puedo volver a ver el secreto de firma?

No. Se muestra una sola vez, al añadir el canal, y nunca cambia. Para un secreto nuevo, añade un nuevo canal webhook y elimina el antiguo.

¿Pueden los suscriptores de nuestra página de estado seguirlo también aquí?

Sí. Los visitantes de una página de estado de Uptimecheck pueden seguirla en Slack, Microsoft Teams, Discord o por webhook, para toda la página o solo los componentes que elijan, y recibir allí tus actualizaciones de estado.

¿Está incluido en todos los planes?

Sí. Todos los canales de alerta excepto SMS están en todos los planes, también en el plan Free; los SMS necesitan un plan de pago y usan créditos (incluidos en Professional y Business, paquetes comprados en Start). Los planes se diferencian en cuántos canales de alerta puedes añadir: 3 en Free, 25 en Start, 75 en Professional y 250 en Business.

Funciona bien con

Todas las integraciones

Las caídas son cosa del pasado.

Configura tu primer monitor en menos de un minuto, o echa antes un vistazo a la demo en vivo.

Prueba gratis Comparar planes

14 días de prueba gratis · Después, gratis con 5 monitores · Sin tarjeta de crédito