Ir al contenido

El canal webhook permite que LoadFocus envíe un HTTP POST con cuerpo JSON a cualquier URL que controles cuando una verificación monitorizada cambia de estado. Es el canal más flexible: cualquier cosa que acepte webhooks JSON entrantes, como Zapier, n8n, Make o tu propio servicio, puede recibir alertas de LoadFocus. PagerDuty tiene su propio canal (planes de pago) que envía el formato que PagerDuty espera.

  1. Ve a Canales de alerta y haz clic en Nuevo canal de alerta.
  2. Elige Webhook.
  3. Asigna un nombre (se muestra en la lista de canales) y pega la URL HTTPS que recibirá el POST.
  4. Haz clic en Guardar canal, habilita el canal en cualquier verificación y elige qué eventos recibirá con los selectores de enrutamiento por canal.

LoadFocus hace POST a tu URL en estos eventos:

Evento valor event Cuándo se dispara
Verificación fallida check.failed Una verificación pasa al estado fallido (assertion, error o timeout).
Verificación recuperada check.recovered Una verificación antes fallida vuelve a pasar.
Verificación degradada check.degraded El tiempo de respuesta supera el umbral de degradación sin fallar.
Caducidad SSL ssl.expiry 14, 7 y 3 días antes de que caduque un certificado HTTPS monitorizado, y el día de la caducidad.
Caducidad de dominio domain.expiry El registro de un dominio monitorizado está a punto de caducar.
SLA incumplido sla.breach El consumo del presupuesto de errores del SLO de la verificación supera el Budget consumed % que fijaste en Alert on breach en la página SLA / SLO.
SLA recuperado sla.recovered Tras una alerta de incumplimiento, el consumo del presupuesto de errores de la verificación vuelve a bajar del Budget consumed % que fijaste.
Prueba test Haces clic en el botón Test junto al canal.

Cuáles de estos eventos llegan a un canal lo controlan los selectores Fail / Recover / Degraded / SSL / Domain bajo el canal en la página de edición de la verificación. Todos están habilitados por defecto. Los eventos de SLA no tienen selector: solo se envían para las verificaciones con Alert on breach activado. El evento test se envía siempre que haces clic en Test.

El cuerpo del POST es application/json, enviado con la cabecera User-Agent: LoadFocus-Webhook/1.0:

{
"source": "loadfocus",
"event": "check.failed",
"check": {
"id": "75be9e45e858177eea4a18bbdc765472",
"name": "Checkout API",
"url": "https://api.example.com/checkout"
},
"status": "failed",
"location": "us-east-1",
"timestamp": "2026-06-07T12:00:00.000Z"
}

Referencia de campos:

  • source: siempre loadfocus. Úsalo para reconocer el remitente.
  • event: uno de check.failed, check.recovered, check.degraded, ssl.expiry, domain.expiry, sla.breach, sla.recovered, test.
  • check.id / check.name / check.url: el monitor que disparó la alerta (null en un evento test).
  • status: el estado de la verificación al enviar (failed, passed, degraded o null en eventos de SSL, dominio y prueba).
  • location: la región desde la que se ejecutó la verificación (null en eventos de SSL, dominio, SLA y prueba).
  • timestamp: hora ISO-8601 UTC del evento.

Los eventos de caducidad SSL añaden un objeto details, los de caducidad de dominio añaden uno con domain, daysRemaining, expiresAt y source, y un evento test tiene un texto details.message. Los eventos de SLA añaden un objeto details con slaTarget, slaWindow, consumedPct, remainingMs y state (breached o recovered). El ejemplo de SSL:

{
"source": "loadfocus",
"event": "ssl.expiry",
"check": { "id": "...", "name": "...", "url": "https://..." },
"status": null,
"location": null,
"timestamp": "2026-06-07T12:00:00.000Z",
"details": { "daysRemaining": 7, "validTo": "Jun 14 23:59:59 2026 GMT" }
}
  • Solo HTTPS. Las URLs de webhook deben empezar por https://. Las URLs http se rechazan.
  • Las direcciones privadas se bloquean. Para evitar server-side request forgery, LoadFocus resuelve tu hostname y no llama a direcciones privadas, loopback, link-local o CGNAT (por ejemplo 10.0.0.0/8, 127.0.0.1, 169.254.0.0/16, 192.168.0.0/16). Tu endpoint debe ser accesible en la internet pública.
  • Sin redirecciones. LoadFocus no sigue redirecciones HTTP en las llamadas webhook, así que apunta el canal a la URL final.
  • Timeout. Cada llamada expira a los 10 segundos. No hay reintento automático, así que tu receptor debe aceptar y encolar el payload rápidamente.
  • Verifica que funciona. Usa el botón Test para enviar un evento test antes de depender del canal. Un servicio gratuito como webhook.site sirve para inspeccionar el payload exacto.
  • Zapier / Make / n8n: inicia un flujo con un trigger "Catch Hook" o de webhook y ramifica según el campo event para publicar en un chat, crear tickets o actualizar una página de estado.
  • Tu propio servicio: acepta el POST, comprueba source === "loadfocus" y actúa según event.
  • PagerDuty: usa su propio canal de alerta (planes de pago), no el canal webhook.
  • Canales de alerta: resumen de todos los tipos de canal y el enrutamiento de eventos por canal.