Notifiche — e-mail, Telegram, webhook
Aggiornato il 08 ott 2026Castreon può avvisarvi da solo quando qualcosa non va su un canale: è caduto, è passato a una sorgente di riserva, mostra un'immagine nera o bloccata, è rimasto senza audio. I messaggi partono per e-mail, su Telegram o verso un webhook, e quando il problema passa ricevete anche il messaggio di ripristino.
Disponibile da Castreon 1.2.0, in tutti i piani.
Configurazione
Aprite Impostazioni → Notifiche, attivate Invia notifiche, poi attivate le destinazioni che volete. Ogni destinazione ha il pulsante Invia una prova, che manda subito un messaggio con i dati del modulo (prima del salvataggio) e mostra il risultato o l'errore esatto.
E-mail (SMTP)
- Server SMTP e Porta, Sicurezza: STARTTLS (587), TLS (465) o Nessuna cifratura (25).
- Utente e Password — lasciate Utente vuoto se il server non chiede autenticazione. La password viaggia solo su una connessione cifrata.
- Da — l'indirizzo del mittente; A — uno o più indirizzi separati da virgole (al massimo 10).
Telegram
- In Telegram create un bot con @BotFather — ricevete il Token del bot.
- Aggiungete il bot al gruppo o al canale dove volete i messaggi (in un canale, come amministratore), oppure scrivetegli voi una volta.
- ID della chat: il vostro ID per una chat privata, l'ID del gruppo (inizia con
-100…) o il nome del canale (@nome).
Webhook (JSON)
Castreon invia un POST con un corpo JSON all'Indirizzo del webhook. Il corpo contiene anche il messaggio già scritto, nei campi text e content, quindi funziona direttamente con i servizi di chat che mostrano solo un testo.
{
"source": "castreon",
"server": "nodo-1",
"sent_at": "2026-10-08T10:01:20Z",
"test": false,
"title": "Canale non disponibile",
"events": [
{"type": "down", "family": "down", "channel_id": "…", "slug": "canale-1", "channel": "Canale 1",
"message": "…", "since": "2026-10-08T10:00:00Z", "at": "2026-10-08T10:01:20Z", "duration_s": 80}
],
"text": "…",
"content": "…"
}
type è down, up, failover, primary, alert o resolved; per gli avvisi, code dice quale (per esempio black_picture).
Firma. Con un Segreto per la firma (16–200 caratteri; Genera ne crea uno), ogni richiesta porta le intestazioni X-Castreon-Timestamp e X-Castreon-Signature: sha256=…. La firma è l'HMAC-SHA256 di timestamp + "." + corpo con il vostro segreto. Verificatela dalla vostra parte e rifiutate le richieste troppo vecchie.
L'indirizzo del webhook resta sul server e non viene più mostrato: molti servizi mettono la chiave di accesso nell'indirizzo.
Cosa viene segnalato
In Cosa segnalare scegliete le famiglie:
| Famiglia | Quando |
|---|---|
| Canale non disponibile | il canale non funziona per più della soglia (errore, riavvii, sorgente caduta con l'immagine «nessun segnale» in onda) — e quando torna |
| Passaggio alla riserva | il canale va su una sorgente di riserva — e quando torna su quella principale |
| Immagine e audio | immagine nera o bloccata, audio muto, uscita senza nuovi segmenti — vedete Qualità di immagine e audio |
| Sorgente DVB | i vuoti di programma dell'operatore, un servizio sparito dal mux |
| Uscite push | uscite RIST / SRT / UDP / RTMP che non raggiungono la destinazione |
| Risorse e stabilità | memoria alta, ritardo rispetto al tempo reale, riavvii troppo frequenti |
| Informazioni | lo stesso programma su più canali, HDR transcodificato in SDR — disattivate per impostazione predefinita |
Un canale fermato dal pannello, disattivato o eliminato non segnala nulla.
Niente valanga di messaggi
- Segnala solo ciò che dura più di — 60 secondi per impostazione predefinita. I vuoti brevi e i riavvii rapidi non inviano nulla.
- Segnala anche il ripristino — solo per i problemi già segnalati.
- Stesso problema sullo stesso canale al massimo una volta ogni — 30 minuti per impostazione predefinita.
- Ciò che succede negli stessi 20 secondi parte in un solo messaggio raggruppato (per esempio «17 canali: …»).
- Al massimo 20 messaggi all'ora per destinazione. I messaggi trattenuti vengono contati e citati nel messaggio successivo.
Lingua e collegamenti
- Lingua dei messaggi: Come il pannello oppure inglese, rumeno, tedesco, italiano, spagnolo.
- Nome del server nei messaggi — vuoto = il nome della macchina. Utile quando avete più server.
- Indirizzo del pannello (facoltativo) — con questo, ogni messaggio ha un collegamento diretto alla pagina del canale.
Ultimi messaggi mostra gli ultimi 20 invii: ora, destinazione, cosa è stato inviato e se è partito. Ogni destinazione mostra anche l'ultimo errore e quanti messaggi ha inviato nell'ultima ora.
Sicurezza
La password SMTP, il token di Telegram, l'indirizzo del webhook e il segreto per la firma restano sul server e non vengono mai più mostrati: dopo il salvataggio, il campo indica solo che c'è un valore salvato. Lasciatelo vuoto per mantenerlo, oppure scrivete un nuovo valore. Non compaiono nelle risposte dell'API, nel registro di audit né nel rapporto diagnostico.
Problemi frequenti
- E-mail: il server rifiuta l'accesso o chiude la connessione: controllate la coppia porta + Sicurezza — 587 con STARTTLS, 465 con TLS. Molti fornitori richiedono una password per le app.
- Telegram:
chat not found: il bot non è stato aggiunto al gruppo o al canale, oppure nessuno gli ha ancora scritto in una chat privata. - Webhook: HTTP 4xx / 5xx: il messaggio mostra il codice restituito dal vostro servizio; la prova invia esattamente ciò che invia un messaggio reale.
- La prova funziona, ma durante un guasto non arriva nulla: controllate che la famiglia sia spuntata e che il problema sia durato più della soglia.