Configurar alertas de Upptime con Echobell
Envía las notificaciones de caída de Upptime a Echobell mediante un webhook personalizado para recibir avisos instantáneos por push o llamada.
Configurar alertas de Upptime con Echobell
Puedes dirigir los eventos de caída y recuperación de Upptime a Echobell para que tu equipo reciba avisos sensibles al tiempo o llamadas sin montar otra infraestructura. Esta guía se centra en la parte de Echobell; para opciones propias de Upptime, consulta la documentación oficial de notificaciones.
Por qué usar Echobell con Upptime
- Escala fallos críticos a llamadas y mantén revisiones rutinarias como pushes estándar o sensibles al tiempo
- Plantillas y variables para mostrar sitio afectado, estado, código de respuesta y enlace al issue de GitHub
- Sin servicios extra: basta el webhook seguro de cada canal de Echobell
Requisitos
- Un repositorio de Upptime con GitHub Actions activado
- Permiso para añadir secretos del repositorio
- Un canal de Echobell con URL de webhook (en la app, abre el canal y copia el webhook)
Paso 1: Prepara el canal en Echobell
- Crea o abre un canal en Echobell y elige el estilo de notificación (estándar, sensible al tiempo o llamada).
- Copia el webhook del canal:
https://hook.echobell.one/t/<channel-token>. - (Opcional) Define una plantilla con
{{site}},{{status}},{{code}},{{url}}y{{issue}}para mantener las alertas estructuradas.
Paso 2: Añade los secretos de Upptime para Echobell
En tu repositorio de Upptime ve a Settings → Secrets and variables → Actions y añade:
NOTIFICATION_CUSTOM_WEBHOOK=trueNOTIFICATION_CUSTOM_WEBHOOK_URL=https://hook.echobell.one/t/<channel-token>?site=$SITE_NAME&status=$STATUS&url=$SITE_URL&issue=$ISSUE_URL&code=$RESPONSE_CODE&emoji=$EMOJI- (Opcional)
NOTIFICATIONS_DOWN_MESSAGE=$EMOJI $SITE_NAME is $STATUS ($RESPONSE_CODE) – $ISSUE_URL - (Opcional)
NOTIFICATIONS_UP_MESSAGE=$EMOJI $SITE_NAME is back up – $SITE_URL
Notas:
- Los parámetros de consulta llevan los datos estructurados a Echobell; Upptime rellenará las variables y Echobell las guardará como variables de plantilla (
site,status,url,issue,code,emoji). - Si personalizas el texto, mantén la URL codificada (espacios como
%20) para evitar errores en la petición. - El resto de proveedores o estrategias sigue configurándose en Upptime; aquí solo añadimos lo necesario para Echobell.
Paso 3: Mapea variables en Echobell
Usa una plantilla breve para que las alertas sean legibles:
Title: {{emoji}} Upptime: {{site}} is {{status}}
Body: Response {{code}} · {{url}}
External link: {{issue}}Para sitios críticos, cambia el tipo de notificación del canal a “sensible al tiempo” o “llamada”; los demás pueden quedar como pushes estándar.
Paso 4: Prueba la integración
- Apunta temporalmente una URL monitorizada a un endpoint inexistente o detén el servicio para provocar un fallo.
- Comprueba que la alerta llega a Echobell con los campos de la plantilla.
- Restaura el servicio y confirma el mensaje de recuperación.
Resolución de problemas
- Verifica la ortografía de
NOTIFICATION_CUSTOM_WEBHOOKyNOTIFICATION_CUSTOM_WEBHOOK_URL. - Si cambias el token del canal en Echobell, actualiza el secreto.
- Para errores de Upptime o más proveedores, consulta la documentación oficial y los registros de GitHub Actions.