---
title: Integración con Upptime - Notificaciones de Monitoreo de Uptime con GitHub
sidebarTitle: Upptime
description: 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.
---

import { Step, Steps } from "fumadocs-ui/components/steps";

# 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](https://upptime.js.org/docs/notifications).

## 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)

<Steps>
<Step>
### 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.
</Step>
<Step>

### 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.
</Step>
<Step>

### 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.

</Step>
<Step>
### 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.
</Step>
</Steps>

## 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](https://upptime.js.org/docs/notifications) y los registros de GitHub Actions.