Notificaciones — correo, Telegram, webhook
Actualizado el 08 oct. 2026Castreon puede avisarle por sí solo cuando algo va mal en un canal: se ha caído, ha pasado a una fuente de respaldo, muestra una imagen negra o congelada, se ha quedado sin sonido. Los mensajes salen por correo, por Telegram o hacia un webhook, y cuando el problema termina también recibe el mensaje de recuperación.
Disponible desde Castreon 1.2.0, en todos los planes.
Configuración
Abra Ajustes → Notificaciones, active Enviar notificaciones y luego los destinos que quiera. Cada destino tiene su botón Enviar una prueba, que envía en el acto un mensaje con los datos del formulario (antes de guardar) y muestra el resultado o el error exacto.
Correo (SMTP)
- Servidor SMTP y Puerto, Seguridad: STARTTLS (587), TLS (465) o Sin cifrado (25).
- Usuario y Contraseña — deje Usuario vacío si el servidor no pide autenticación. La contraseña solo se envía por una conexión cifrada.
- De — la dirección del remitente; Para — una o varias direcciones separadas por comas (como máximo 10).
Telegram
- En Telegram, cree un bot con @BotFather — recibe el Token del bot.
- Añada el bot al grupo o canal donde quiera los mensajes (a un canal, como administrador), o escríbale usted una vez.
- ID del chat: su propio ID para un chat privado, el ID del grupo (empieza por
-100…) o el nombre del canal (@nombre).
Webhook (JSON)
Castreon envía un POST con un cuerpo JSON a la Dirección del webhook. El cuerpo también contiene el mensaje ya redactado, en los campos text y content, así que funciona directamente con los servicios de chat que solo muestran un texto.
{
"source": "castreon",
"server": "nodo-1",
"sent_at": "2026-10-08T10:01:20Z",
"test": false,
"title": "Canal caído",
"events": [
{"type": "down", "family": "down", "channel_id": "…", "slug": "canal-1", "channel": "Canal 1",
"message": "…", "since": "2026-10-08T10:00:00Z", "at": "2026-10-08T10:01:20Z", "duration_s": 80}
],
"text": "…",
"content": "…"
}
type es down, up, failover, primary, alert o resolved; en las alertas, code indica cuál (por ejemplo black_picture).
Firma. Con un Secreto de firma (16–200 caracteres; Generar crea uno), cada petición lleva las cabeceras X-Castreon-Timestamp y X-Castreon-Signature: sha256=…. La firma es el HMAC-SHA256 de timestamp + "." + cuerpo con su secreto. Compruébela en su lado y rechace las peticiones demasiado antiguas.
La dirección del webhook se guarda en el servidor y no se vuelve a mostrar: muchos servicios ponen la clave de acceso en la dirección.
Qué se avisa
En Qué avisar elige las familias:
| Familia | Cuándo |
|---|---|
| Canal caído | el canal no funciona durante más tiempo que el umbral (error, reinicios, fuente caída con la imagen «sin señal» en emisión) — y cuando vuelve |
| Cambio a respaldo | el canal funciona con una fuente de respaldo — y cuando vuelve a la principal |
| Imagen y sonido | imagen negra o congelada, audio en silencio, salida sin segmentos nuevos — vea Calidad de imagen y sonido |
| Fuente DVB | los huecos de programa del operador, un servicio desaparecido del mux |
| Salidas push | salidas RIST / SRT / UDP / RTMP que no llegan a su destino |
| Recursos y estabilidad | memoria alta, retraso respecto al tiempo real, reinicios demasiado frecuentes |
| Información | el mismo programa en varios canales, HDR transcodificado a SDR — desactivada por defecto |
Un canal que usted detiene desde el panel, desactiva o elimina no avisa de nada.
Sin avalancha de mensajes
- Avisar solo lo que dure más de — 60 segundos por defecto. Los huecos cortos y los reinicios rápidos no envían nada.
- Avisar también la recuperación — solo de los problemas que se avisaron.
- El mismo problema en el mismo canal como máximo una vez cada — 30 minutos por defecto.
- Lo que ocurre en los mismos 20 segundos sale en un solo mensaje agrupado (por ejemplo «17 canales: …»).
- Como máximo 20 mensajes por hora y destino. Los mensajes retenidos se cuentan y se mencionan en el siguiente.
Idioma y enlaces
- Idioma de los mensajes: Como el panel, o inglés, rumano, alemán, italiano, español.
- Nombre del servidor en los mensajes — vacío = el nombre de la máquina. Útil si tiene varios servidores.
- Dirección del panel (opcional) — con ella, cada mensaje lleva un enlace directo a la página del canal.
Últimos mensajes muestra los últimos 20 envíos: hora, destino, qué se envió y si salió. Cada destino muestra además su último error y cuántos mensajes envió en la última hora.
Seguridad
La contraseña SMTP, el token de Telegram, la dirección del webhook y el secreto de firma se guardan en el servidor y nunca se vuelven a mostrar: tras guardar, el campo solo indica que hay un valor guardado. Déjelo vacío para conservarlo o escriba un valor nuevo. No aparecen en las respuestas de la API, en el registro de auditoría ni en el informe de diagnóstico.
Problemas frecuentes
- Correo: el servidor rechaza el inicio de sesión o cierra la conexión: revise la pareja puerto + Seguridad — 587 con STARTTLS, 465 con TLS. Muchos proveedores exigen una contraseña de aplicación.
- Telegram:
chat not found: el bot no se ha añadido al grupo o al canal, o nadie le ha escrito todavía en un chat privado. - Webhook: HTTP 4xx / 5xx: el mensaje muestra el código devuelto por su servicio; la prueba envía exactamente lo mismo que un mensaje real.
- La prueba funciona, pero durante una caída no llega nada: compruebe que la familia está marcada y que el problema duró más que el umbral.