Los webhooks no llegan
Ha creado una regla de alerta con el canal Webhook, pero su servidor no recibe nada. Aquí verá cuándo envía SilentShield un webhook y qué puede detenerlo por el camino.
Cuándo envía SilentShield un webhook
Solo envían webhooks las reglas de alerta de una clave API cuyo canal es Webhook. Una vez por minuto, SilentShield comprueba cada regla activa. Si su condición se cumple dentro de la ventana de tiempo, envía una solicitud POST a la URL de webhook guardada en la página “Configuración de notificaciones”.
Causas
La regla nunca se ha activado
En la página “Reglas de alerta” de la clave, la columna “Última activación” muestra cuándo se activó una regla por última vez. Si pone “nunca”, la condición aún no se ha cumplido y no se ha enviado nada. Compare el umbral y el operador con las cifras de su analítica.
La regla espera a que pase su ventana de tiempo
Una regla se activa como máximo una vez por ventana de tiempo (5m, 15m, 1h, 24h). Después solo vuelve a comprobarse cuando ha pasado esa ventana: una regla con 24h envía como máximo una vez al día.
No hay ninguna URL de webhook guardada
La regla solo elige el canal; la dirección en sí se guarda en la página “Configuración de notificaciones”. Sin dirección, la regla se activa, pero no se envía nada. Solo puede guardar una dirección con un plan que incluya integraciones de webhook.
La dirección no es accesible desde internet
SilentShield solo entrega a direcciones públicas. Los destinos locales e internos como localhost, 127.0.0.1, 10.0.0.0/8, 192.168.0.0/16 o 172.16.0.0/12 se rechazan al guardar y de nuevo al conectar, también tras una redirección. Para pruebas locales, use un túnel con una dirección HTTPS pública.
Su servidor responde demasiado despacio
Cada intento espera como máximo 5 segundos la respuesta completa. Responda de inmediato con un estado 2xx y procese el mensaje después, por ejemplo en una cola.
Su servidor responde con un error o una redirección
Solo los códigos de estado de 200 a 299 cuentan como entregados. Tras un 5xx, 408 o 429, o si falla la conexión, SilentShield vuelve a intentarlo a los 2 y a los 8 segundos y después desiste. Otros códigos 4xx como 401, 403 o 404 no se reintentan; un cortafuegos o una protección contra bots delante de su endpoint suele responder con 403. Tras una redirección 301, 302 o 303, la solicitud continúa como GET sin cuerpo, así que indique la dirección final.
La comprobación de la firma falla en su servidor
Si ha guardado un secreto, cada solicitud lleva la cabecera X-Signature-256: sha256= seguido del HMAC-SHA256 del cuerpo en hexadecimal. Calcúlelo sobre el cuerpo sin procesar tal como llega, antes de analizar el JSON; un cuerpo analizado y escrito de nuevo tiene otra firma. Sin secreto, la cabecera no aparece.
Qué llega a su servidor
Una entrega tiene este aspecto. X-Event-ID es el mismo en todos los intentos de una entrega; úselo para detectar duplicados.
POST /your-webhook HTTP/1.1
Content-Type: application/json
X-Event-ID: 8b1f2c3d-4e5f-4a6b-9c7d-0e1f2a3b4c5d
X-Signature-256: sha256=<hex>
{
"event_id": "8b1f2c3d-4e5f-4a6b-9c7d-0e1f2a3b4c5d",
"alert_rule_id": "2a7c9e1b-3d4f-4b6a-8c0e-1f2a3b4c5d6e",
"alert_name": "bot-rate",
"api_key_id": "5c6d7e8f-9a0b-4c1d-8e2f-3a4b5c6d7e8f",
"metric": "bot_rate",
"operator": "gt",
"threshold": 0.3,
"value": 0.42,
"fired_at": "2026-11-16T10:30:00Z"
}Comprobar la firma
Ejemplo en Node.js; rawBody es el cuerpo de la solicitud sin modificar:
const crypto = require("crypto");
function isValidSignature(rawBody, header, secret) {
const expected = "sha256=" +
crypto.createHmac("sha256", secret).update(rawBody).digest("hex");
const received = header || "";
return received.length === expected.length &&
crypto.timingSafeEqual(Buffer.from(received), Buffer.from(expected));
}
// header = req.get("X-Signature-256")Cómo configurar reglas y canales: Reglas de Alerta