Echobell

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

  1. Crea o abre un canal en Echobell y elige el estilo de notificación (estándar, sensible al tiempo o llamada).
  2. Copia el webhook del canal: https://hook.echobell.one/t/<channel-token>.
  3. (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=true
  • NOTIFICATION_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_WEBHOOK y NOTIFICATION_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.