Guía completa para integrar Upptime con Echobell para alertas instantáneas de caída. Recibe notificaciones push móviles o llamadas para interrupciones web con monitoreo de uptime basado en GitHub Actions, webhooks personalizados y notificaciones de página de estado.

Integración con Upptime

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)

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.

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.

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.

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.

Integración con Upptime - Notificaciones de Monitoreo de Uptime con GitHub