Canales de alerta

HelloCron puede notificarte sobre eventos de monitores (fallos, ejecuciones no realizadas, timeouts, recuperaciones) a través de varios canales. Puedes configurar cualquier número de canales y elegir qué tipos de evento recibe cada uno.

Todos los canales se gestionan en el panel bajo Configuración -> Canales de notificación. Cada canal tiene un botón Probar que envía una notificación de prueba solo a ese canal, para que puedas verificar la configuración antes de depender de ella.

Email

El canal más simple. Deja el campo de dirección vacío para usar el email de tu cuenta, o introduce una dirección distinta (por ejemplo, un alias de equipo).

Telegram

Las alertas de Telegram son gratuitas e instantáneas, y conectarse lleva un clic.

1. En el panel, añade un canal de tipo Telegram y haz clic en Conectar Telegram.
2. Escanea el código QR con el móvil (o haz clic en Abrir en Telegram) y pulsa Iniciar en el chat que se abre. Para un grupo, usa Añadir a un grupo y elige el grupo.
3. El formulario se rellena solo y muestra «Conectado». Guarda el canal y haz clic en Test.

Las alertas las entrega el bot oficial de HelloCron. Sin tokens, sin chat ID, sin buscar nada.

Avanzado: tu propio bot. Si prefieres que las alertas lleguen desde un bot bajo tu control, despliega Avanzado: tu propio bot en el formulario: crea un bot con @BotFather (/newbot, copia el token con formato 123456789:AAF...), obtén el chat ID en https://api.telegram.org/bot<TOKEN>/getUpdates (los ID de grupos son negativos) y rellena ambos campos. Un canal con token propio siempre envía a través de ese bot. HelloCron guarda el token solo para la entrega y nunca lo incluye en los logs.

Discord

Las alertas de Discord usan webhooks de canal, no se necesita ningún bot.

1. En Discord, abre la configuración del canal objetivo: Integraciones -> Webhooks -> Nuevo Webhook.
2. Copia la URL del webhook (empieza con https://discord.com/api/webhooks/).
3. En el panel, añade un canal de tipo Discord y pega la URL.
4. Haz clic en Probar. Las alertas llegan como embeds, verdes para las recuperaciones y rojas para los fallos.

Slack

1. Crea un webhook entrante en tu espacio de trabajo de Slack.
2. En el panel, añade un canal de tipo Slack y pega la URL del webhook (empieza con https://hooks.slack.com/services/).
3. Haz clic en Probar.

PagerDuty

Las alertas de PagerDuty usan la Events API v2: los fallos abren incidentes y las recuperaciones los resuelven automáticamente.

1. En PagerDuty, crea un servicio (o abre uno existente) y añade una integración Events API v2: Service -> Integrations -> Add integration -> Events API v2.
2. Copia la Integration Key (también llamada routing key, 32 caracteres).
3. En el panel, añade un canal de tipo PagerDuty y pega la clave.
4. Haz clic en Test.

Cómo se mapean los eventos:

• Failed, Missed y Timeout disparan un incidente con severidad critical; Degraded y Still failing usan warning.
• Recovered resuelve el incidente abierto para ese monitor mediante una clave de deduplicación compartida, así que un monitor inestable nunca acumula incidentes.
• Cada incidente incluye un enlace al monitor en el panel de HelloCron.

Webhook

Envía un payload JSON a cualquier endpoint HTTP, útil para integrarse con tus propios sistemas, herramientas de guardia o automatizaciones.

{
  "id": 123,
  "type": "failed",
  "monitor_name": "db-backup",
  "message": "Monitor db-backup failed",
  "metadata": {},
  "occurred_at": "2026-07-24T18:00:00+00:00"
}

• Método: POST (por defecto) o GET (payload como parámetros de consulta).
• Cabeceras personalizadas: una por línea como Header-Name: value, por ejemplo una cabecera Authorization para tu endpoint.
• Las URLs de webhook de Slack y Discord se rechazan aquí a propósito: sus API esperan un formato de payload distinto. Usa en su lugar el tipo de canal dedicado de Slack o Discord.

Grupos de notificaciones

Un grupo de notificaciones es un conjunto de canales con nombre. Un monitor asignado a un grupo alerta solo a los canales de ese grupo; los monitores sin grupo mantienen el comportamiento predeterminado y alertan a todos los canales activos de la cuenta.

Configuración típica: un grupo «backups» apuntando a un chat de Telegram dedicado y un grupo «www» apuntando al webhook de guardia. Como una cuenta puede tener varios canales del mismo tipo, cada grupo puede apuntar a su propio chat de Telegram.

Gestiona los grupos en Ajustes -> Canales de notificación -> Gestionar grupos: crea un grupo, marca sus canales y adjunta monitores (ping y checks HTTP/SSL) en la misma página. También puedes elegir el grupo al editar un monitor.

Dos detalles importantes:

• Un grupo sin canales silencia sus monitores fuera del panel (la campana de la aplicación sigue funcionando). El panel lo advierte.
• Eliminar un grupo no borra nada más: sus monitores vuelven a todos los canales de la cuenta.

En los manifiestos de config-as-code, el grupo viaja como notification_group (el nombre del grupo). Omitir la clave desvincula el grupo; los nombres desconocidos se rechazan con el código de error notification_group_invalid.

Tipos de evento

Cada canal se suscribe a un subconjunto de tipos de evento: