Integración de Webhooks

Los Webhooks de MonitorNOC te permiten conectar de forma automática los incidentes de tu infraestructura con herramientas de terceros como Slack, Microsoft Teams, Jira, PagerDuty, Discord o tus propios paneles internos de desarrollo.

---

1. Funcionamiento de Webhooks

Cada vez que un monitor cambia de estado operativo (ej. de UP → DOWN o de DOWN → UP), el motor de alertas de MonitorNOC realiza una petición HTTP POST a la URL destino configurada.

• Firma de la petición (Headers):
  • Content-Type: application/json
  • User-Agent: MonitorNOC-Alertmanager/2.0
• Timeout y Reintentos: Si tu servidor responde con un código de error (5xx) o no responde en 5 segundos, la petición se reintenta 2 veces antes de descartarse.

---

2. Estructura del Payload JSON

El cuerpo del mensaje enviado contiene información detallada del evento:

{
  "event": "incident_created", 
  "timestamp": "2026-06-16T03:30:15.123Z",
  "organization": {
    "id": 14,
    "name": "MonitorNOC NOC"
  },
  "target": {
    "id": 42,
    "name": "Servidor de Base de Datos",
    "host": "db.empresa.com"
  },
  "incident": {
    "id": 891,
    "status": "active",
    "severity": "critical",
    "impact_scope": "total",
    "check_type": "http",
    "last_error": "Connection timeout (10000ms)",
    "opened_at": "2026-06-16T22:30:15Z"
  }
}

Propiedades Clave:

• event: Puede ser incident_created (caída) o incident_resolved (recuperación).
• incident.status: El estado del incidente (active, resolved).
• incident.severity: Severidad asignada (critical, major, minor, maintenance).
• incident.impact_scope: El alcance del impacto (total, parcial, clientes_afectados, servicio_degradado).

---

3. Ejemplo de Integración en Slack (Incoming Webhook)

Para recibir alertas directamente en un canal de Slack:

1. Crea una aplicación en la consola de Slack e instala el componente Incoming Webhooks.
2. Copia la URL generada por Slack (ej: https://hooks.slack.com/services/T000/B000/XXXX).
3. Ve a Ajustes de Organización → Canales de Alerta en MonitorNOC.
4. Habilita Webhooks, pega la URL y guarda los cambios.