Telegram e avvisi amministratore

Dove nel pannello di controllo: System › Settings › Admin alerts (/settings/alerts). Scorciatoie di supporto: Customers › Support › Tickets (/support/tickets), scheda Settings.

Descrizione

NexCMP avvisa te — l'operatore — quando qualcosa richiede attenzione, e quando un cliente si registra o un deposito viene accreditato. Gli avvisi vengono inviati a uno o più canali: Telegram, un webhook o e-mail.

Gli eventi inviati ai canali amministrativi includono: errore di distribuzione, VM mancante, rete non attiva, IP liberi inferiori a 30, un elemento in scadenza (avviso di 1 ora), una controversia Stripe, un worker non attivo, RAM del cluster superiore alla soglia, nuova registrazione di un cliente e depositi accreditati. Gli eventi dei clienti vengono accodati in modo persistente e ripetuti con ritardo crescente (da 30 secondi fino a 1 ora) finché Telegram non li accetta.

Requisiti

Elemento	Requisito
Telegram	Un bot creato con @BotFather (token) e il chat ID del gruppo o dell'utente che deve ricevere i messaggi
Rete	HTTPS in uscita verso api.telegram.org
Webhook (alternativa)	Un endpoint HTTPS che accetta il payload dell'avviso

Prepara Telegram

1. Su Telegram apri @BotFather, invia /newbot, scegli un nome; copia il bot token (123456789:AA...).
2. Crea un gruppo, aggiungi il bot al gruppo e invia un messaggio qualsiasi.
3. Trova la chat ID: apri https://api.telegram.org/bot<token>/getUpdates in un browser e leggi chat.id (gli ID dei gruppi iniziano con -).

Collega in NexCMP

1. Apri System › Settings › Admin alerts.
2. In Add channel scegli Type: Telegram, imposta Destination sulla chat ID e Secret (bot token) sul token. Fai clic su Add.
3. Assicurati che l'interruttore Send admin Telegram (VM module) sia attivo; la riga VM module status (read-only) mostra "on".

Verifica

Il canale appare sotto Configured channels. Attiva un evento (ad esempio registra un cliente di prova) e il messaggio arriverà nel gruppo. Se nessun canale è configurato, la pagina avvisa "Without a channel, attacks will go unnoticed" e, nel log, gli eventi di Telegram vengono registrati solo localmente.

Scorciatoie di supporto per i clienti

Il widget di supporto per i clienti può mostrare i pulsanti Telegram e Zalo. Rimangono nascosti finché non vengono configurati nelle impostazioni di supporto: inserisci un https://t.me/... link per Telegram e il link o QR di Zalo. Sono accettati solo i link https://. La chat di supporto può anche notificare al tuo gruppo Telegram la domanda e una bozza di risposta — vedi AI Chat.

Limiti e note

• Il bot token viene memorizzato con il canale e non viene più mostrato.
• Gli eventi di Telegram utilizzano il primo canale Telegram abilitato che dispone sia di una destinazione che di un token.

Troubleshooting

Sintomo	Causa	Soluzione
Nessun messaggio in arrivo	Chat ID errata, bot non presente nel gruppo o nessun messaggio inviato in precedenza al bot	Verifica nuovamente l'ID con getUpdates; invia prima un messaggio al bot o al gruppo.
Funziona per un po' e poi si ferma	Token revocato in BotFather	Crea un nuovo token e aggiorna il canale.
Telegram: no channel nei log	Nessun canale Telegram abilitato	Aggiungine uno come descritto sopra.