Netlify es una plataforma increíble para el despliegue continuo de aplicaciones web modernas. Sin embargo, estar al tanto de los builds fallidos o los despliegues exitosos es crucial para cualquier equipo de desarrollo.
En esta guía, te mostraremos cómo conectar Netlify a AlertHub para recibir notificaciones instantáneas en tus canales favoritos (Slack, Telegram, Email, etc.) siempre que ocurra un evento de despliegue.
Paso 1: Crear un Proyecto en AlertHub
Si aún no lo has hecho, el primer paso es configurar tu proyecto en AlertHub.
- Inicia sesión en AlertHub.
- Haz clic en Nuevo Proyecto.
- Dale un nombre reconocible, como “Mi App en Netlify”.
- Una vez creado, aterrizarás en el panel del proyecto.
Paso 2: Configurar tus Canales de Notificación (Opcional)
Antes de empezar a enviar alertas, decide dónde quieres recibirlas. Ve a la pestaña Conexiones en tu proyecto:
- Telegram: Conecta el bot para recibir alertas en tu móvil.
- Slack: Vincula un canal para tu equipo.
- Email: Añade tu dirección de correo para resúmenes importantes.
Puedes saltarte esto por ahora y solo revisar el panel, pero recomendamos configurar al menos un canal.
Paso 3: Configurar el Webhook en Netlify
Ahora, vamos a decirle a Netlify que envíe un evento a AlertHub cuando suceda algo.
- Inicia sesión en tu cuenta de Netlify y selecciona tu sitio.
- Ve a Configuración del sitio > Build & deploy > Notificaciones de despliegue.
- Haz clic en Añadir notificación.
- Elige Webhook.
Paso 4: Configurar la URL del Webhook usando el Generador de AlertHub
Aquí es donde ocurre la magia. Necesitamos una URL que le diga a Netlify dónde enviar los datos. Netlify envía un payload con detalles sobre el build (mensaje del commit, estado, rama, etc.).
Podemos usar el Generador de Webhooks Personalizados de AlertHub para crear una URL que formatee automáticamente estos detalles en un mensaje legible usando Placeholders Dinámicos.
- Vuelve a la página de detalles de tu Proyecto en AlertHub.
- Busca la sección Credenciales de Acceso.
- En la tarjeta Webhook Personalizado, rellena lo siguiente:
- Título:
Notificación de Netlify - Descripción:
Estado del despliegue: {{state}} en la rama {{branch}}.\nMensaje: {{title}} - Nivel:
info - Fuente:
Netlify
- Título:
- Copia la URL generada en la parte inferior de la tarjeta.
La URL se verá algo así:
https://api.thealerthub.com/sendAlert?ah_key=TU_CLAVE&ah_title=Netlify...
Pega esta URL en el formulario de configuración del Webhook de Netlify que abriste en el Paso 3. Puedes elegir activar esto en “Deploy started” (Despliegue iniciado), “Deploy succeeded” (Despliegue exitoso) o “Deploy failed” (Despliegue fallido). Te recomendamos crear webhooks separados para “éxito” y “fallo” si quieres diferentes niveles de alerta (por ejemplo, usando el nivel critical para los fallos).
Paso 5: ¡Recibe tus Alertas!
Activa un nuevo despliegue en Netlify (por ejemplo, haciendo push de un commit).
AlertHub recibirá el webhook, reemplazará {{title}}, {{state}}, etc., con los datos reales de Netlify, y reenviará la notificación a tus canales conectados inmediatamente.
¡Mantente al tanto de tu pipeline CI/CD sin tener que revisar constantemente el panel!
Los crashes en runtime dentro de una Function son otro evento — captúralos en código: alertas de fallos de Netlify Functions.