Enruta alertas de AlertHub a Discord con embeds

Enruta alertas de AlertHub a Discord con embeds

Los equipos indie y los productos cercanos a gaming ya viven en Discord. Cablear Stripe, Shopify y CI cada uno a su webhook de Discord implica rotar tres URLs cuando cambia el canal.

AlertHub es el último salto: las fuentes publican una vez, y Discord (más Slack, Telegram, WhatsApp, Teams) comparte el mismo flujo warning/critical. AlertHub detecta la URL de Discord y envía un embed con formato, no un JSON crudo.

Cómo llega a Discord

  1. Creas un incoming webhook en Discord (URL del canal).
  2. Lo pegas en el proyecto: Connections → Webhooks.
  3. AlertHub reconoce Discord y publica un embed: nombre del proyecto, nivel, título, descripción.
  4. Critical usa color rojo; warning, naranja.

Solo warning y critical salen del panel. Las alertas info se quedan en el feed para que #ops no se llene con cada cron correcto.

Configuración (una sola vez)

  1. Crea un proyecto en app.thealerthub.com si no tienes uno.
  2. En Discord: Server Settings → Integrations → Webhooks → New Webhook. Elige el canal y copia la URL.
  3. En AlertHub: Connections → Webhooks → pega la URL y guarda.

Docs: destino Discord. Luego envía cualquier fuente (API, Shopify, GitHub Actions, email).

Alerta 1: Fallos de CI en #deploys

Usa un paso de fallo de GitHub Actions con ah_level: critical. Discord recibe el embed; no mantienes una segunda Action de Discord.

Combínalo con Netlify o Vercel si el host es la fuente de verdad.

Alerta 2: Tienda y pagos en #revenue

Los pedidos Shopify y los fallos de Stripe ya tienen guías. Apunta esas fuentes al mismo proyecto:

Discord es solo otro destino. Cambiar #revenue de canal es rotar la URL en AlertHub, no editar el Admin de Shopify.

Alerta 3: Separar canales con dos proyectos — o uno

Los destinos de AlertHub son por proyecto. División típica:

ProyectoCanal DiscordFuentes típicas
prod-ops#incidentsCI, uptime, disco, Stripe critical
prod-shop#pedidosShopify, WooCommerce

Si solo tienes un servidor de comunidad, un proyecto y un webhook bastan. Filtra el panel por origen cuando necesites historial.

Ideas para sacarle más partido

  • No pegues la URL de Discord en cada SaaS. Rótala una vez en AlertHub.
  • Separa Discord de clientes y ops. Los webhooks de ops van a un canal solo para staff.
  • WhatsApp para el fundador, Discord para el equipo de comunidad. Misma alerta, dos destinos.
  • Salida genérica. Si dejas Discord, añade Microsoft Teams sin tocar las fuentes.

Preguntas frecuentes

¿Tengo que hospedar un bot de Discord?
No. Los incoming webhooks bastan. AlertHub formatea el embed.

¿Cada alerta info llega a Discord?
No. Info es solo panel. Sube la fuente a warning o critical cuando alguien deba enterarse.

¿Puedo personalizar los campos del embed?
El título y la descripción salen de la alerta (ah_title, ah_description, incluidos {{placeholders}}). El envoltorio del embed (usuario AlertHub, color por nivel) se aplica solo.

Siguientes pasos

Sigue la configuración de Discord, pega el webhook y envía un warning de prueba con la API de ingestión.

Relacionado: alertas Microsoft Teams · alertas Google Chat