---
title: Telegram e avvisi amministratore
description: Invia avvisi operativi ed eventi di registrazione e deposito a un gruppo Telegram, webhook o e-mail, e configura le scorciatoie di supporto per i clienti.
url: https://nexcmp.com/it/docs/administration/telegram-notifications/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Telegram e avvisi amministratore {#telegram-and-admin-alerts}

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

## Descrizione {#what-it-does}

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 {#requirements}

| 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 {#prepare-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 {#connect-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".

![La pagina Admin alerts con il modulo Add channel impostato su Telegram](https://nexcmp.com/it/docs/images/administration/telegram-notifications-01-channel.webp)

## Verifica {#verify}

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 {#support-shortcuts-for-customers}

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](https://nexcmp.com/it/docs/ai/ai-chat/).

## Limiti e note {#limits-and-notes}

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