De webhook a notificaciones push: guía

6 de agosto de 2026 · LogsNinja

El workflow falló#deploys ·

Un webhook que ya recibes

Stripe, GitHub, Supabase y la mayoría de las herramientas SaaS ya envían un payload JSON a un endpoint que tú controlas en el momento en que algo pasa. Ese payload suele acabar en un log, o se ignora en silencio hasta que algo se rompe. Los campos que necesitas para una alerta ya están ahí: solo hay que reenviarlos.

Tres pasos dentro del handler que ya tienes

Verifique la firma

Asocie los campos

Envíe el evento

DEL WEBHOOK AL EVENTO

Un payload de GitHub Actions, reenviado como evento

Verifica la firma, extrae la conclusión y el nombre del repositorio del payload, y envía una llamada HTTP: la misma idea se aplica a Supabase, Stripe o tu propio backend.

$ curl -X POST https://api.logsninja.com/v1/events \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{
    "project": "YOUR_PROJECT_ID",
    "stream":  "deploys",
    "title":   "Workflow failed",
    "content": "deploy.yml on main",
    "emoji":    "🚨",
    "metadata": {"repo": "org/app"},
    "notify":   true
  }'

✓ Event received
✓ Push sent to 2 devices
# feed and chart updated

Fuentes de webhook habituales

Stripe

Pagos, facturas y cambios de suscripción.

GitHub

Despliegues, pull requests y fallos de workflow.

Supabase

Cambios en la base de datos y eventos de autenticación.

Su propio backend

Cualquier evento interno que ya emita como webhook.

Despliéguelo con seguridad

Verifique antes de confiar

Comprueba la cabecera de firma del proveedor antes de procesar nada: GitHub, Stripe y Supabase firman cada uno sus payloads.
Mantén tu secreto de firma del webhook y tu token de API de LogsNinja fuera del código del lado del cliente.
Reenvía solo los campos que realmente necesitas para la alerta o el gráfico, no el payload completo.

Gestione los reintentos

La mayoría de los proveedores reintentan los webhooks no entregados: devuelve 200 rápido y procesa de forma asíncrona si hace falta.
Usa el ID de entrega del proveedor como clave de idempotencia para que un webhook reintentado no cree una alerta duplicada.
Pon notify en false para los eventos de alto volumen que solo quieres en un gráfico, no como push.

Construye esto en tu panel

Cada widget de abajo lee los mismos eventos que acaba de empezar a enviar, sin una segunda integración.

Despliegues hoyActualizado

Workflows fallidosActualizado

Migraciones de base de datosActualizado

Valores de ejemplo mostrados a modo ilustrativo.

Preguntas frecuentes

¿Necesito un endpoint nuevo para esto?

No. Añade una llamada HTTP a LogsNinja dentro del handler que ya recibe el webhook, después de verificar su firma.

¿Funciona esto para webhooks distintos de GitHub?

Sí. Los mismos tres pasos (verificar, mapear los campos, enviar el evento) se aplican a Stripe, Supabase o cualquier proveedor que envíe un payload JSON firmado.

¿Y si solo quiero que algunos eventos de webhook generen alerta, no todos?

Pon notify en false para los que solo quieres en un gráfico, y en true para los que merecen un push: ambos leen el mismo payload.

De webhook a notificación push en una llamada HTTP