Collega Telegram: guida passo passo
Invia avvisi in caso di errore (uno per test con NEXUS_TELEGRAM_NOTIFY=true) e i report e i file che scegli di condividere, tramite un tuo bot. Non esiste un bot condiviso. Questa guida ti accompagna da zero fino alla verifica della connessione ed elenca gli errori che potresti incontrare, con le relative cause e soluzioni.
Ultimo aggiornamento:
Mantieni riservate le tue credenziali. Non incollare mai token, chiavi, password o URL di webhook in una chat. Inseriscili solo in Studio → Impostazioni → Integrazioni, dove vengono salvati nel file .env del tuo spazio di lavoro e visualizzati come puntini. Lo stesso vale per un assistente IA: può accompagnarti lungo questa guida, ma non ha mai bisogno del tuo token.
Cosa serve
- Un account Telegram.
- Un tuo bot, creato una sola volta con @BotFather, e il relativo token.
- Un telefono o l'app Telegram per scansionare il codice QR di abbinamento.
- Prima di attivarlo: Telegram può ricevere file come report e PDF, che vengono inviati ai suoi server. In un ambiente regolamentato, consulta prima il team responsabile della conformità.
Ottieni le credenziali
- In Telegram, apri https://t.me/BotFather e invia /newbot. Assegna al bot un nome e un nome utente.
- BotFather risponde con il token del bot (ad esempio 123456:ABC…). Copialo.
- Tienilo negli appunti. Non incollarlo da nessuna parte tranne che nello Studio (passaggio successivo).
Collegalo nello Studio
- In Studio, apri Impostazioni → Integrazioni → Collega Telegram.
- Incolla il token del bot e salva. Viene visualizzato il codice QR di abbinamento.
- Scansiona il codice QR con il telefono e tocca Avvia in Telegram. Entro pochi secondi Studio mostra "gli avvisi vengono inviati alla chat …" e il bot risponde "Connesso a Nexus StudioQA."
- Attiva
TELEGRAM_ENABLED. Per ricevere un avviso per ogni test non riuscito, attiva ancheNEXUS_TELEGRAM_NOTIFY.
Verifica che funzioni
- Dopo la scansione, il bot invia "Connesso a Nexus StudioQA. I test non riusciti verranno segnalati qui." nella tua chat.
- Studio mostra "gli avvisi vengono inviati alla chat" con la chat parzialmente nascosta.
Errori comuni
| Cosa vedi | Causa | Soluzione |
|---|---|---|
| "Telegram è disattivato" | TELEGRAM_ENABLED è false e deve essere attivato per l'abbinamento. | Attiva TELEGRAM_ENABLED e premi di nuovo Collega Telegram. |
| "Token del bot assente" | TELEGRAM_TOKEN è vuoto. | Incolla il token di BotFather in Impostazioni → Integrazioni e salva. |
| "Telegram: Non autorizzato" (o "Non trovato") | Il token del bot è errato, è stato revocato in BotFather o è stato troncato durante la copia. | Invia /token a BotFather per ottenere di nuovo il token (o crea un nuovo bot), quindi salvalo. |
| "Il codice QR è scaduto prima della scansione" | Il codice QR è valido solo per pochi minuti. | Premi Collega Telegram per crearne uno nuovo e scansionalo subito. |
| Il codice QR è stato scansionato ma Studio è ancora in attesa | La scansione ha aperto la chat ma non è stato toccato Avvia, oppure la finestra di Studio è stata chiusa. | Tocca Avvia nella chat del bot. Se Studio è ancora in attesa, crea un nuovo codice QR. |
| "impossibile raggiungere Telegram (ENOTFOUND)" o "nessuna risposta entro 20 s" | Questo PC non riesce a raggiungere api.telegram.org: una VPN, un firewall o un proxy impedisce l'accesso, oppure manca la connessione di rete. | Controlla la connessione di rete dallo stesso PC e riprova. |
| Non arriva alcun avviso dopo un errore | TELEGRAM_ENABLED è impostato su false, non è associata alcuna chat oppure gli avvisi per singolo test sono disattivati (NEXUS_TELEGRAM_NOTIFY). | Associa una chat e attiva entrambi gli interruttori. |
Chiavi di configurazione
| Chiave | Cosa fa | Valore valido | Come verificarlo |
|---|---|---|---|
TELEGRAM_ENABLED | Invia avvisi a Telegram | true o false | Deve essere attivo per usare il codice QR di associazione. |
TELEGRAM_TOKEN | Codice di accesso del bot Telegram (segreto, salvato solo su questo computer) | Il token del bot fornito da BotFather, come 123456:ABC…, su una sola riga | Il codice QR appare solo se Telegram lo accetta. |
TELEGRAM_CHAT_ID | Chat Telegram per gli avvisi | Compilato tramite l'associazione con codice QR; non digitarlo | Studio mostra "gli avvisi vengono inviati alla chat …". |
NEXUS_TELEGRAM_NOTIFY | Avviso Telegram per ogni errore | true o false | Arriva un avviso per ogni test non riuscito. |
Approfondimenti: tutte le integrazioni, la guida alle impostazioni, risoluzione dei problemi. Altre guide: Jira Cloud, Azure Boards, Slack, Microsoft Teams, GitHub Issues.
Non riesci ancora a risolvere? Scrivi a [email protected] riportando l'esatta riga di errore mostrata da Studio. Non includere token.