Guida
Come creare un bot Telegram
Collega i tuoi giocatori alla dashboard in pochi minuti
GENKAI usa un bot Telegram per comunicare con i giocatori. Puoi inviare messaggi, immagini, handout e file direttamente dalla dashboard, e ricevere le risposte dei giocatori in tempo reale. Questa guida ti mostra come configurare tutto.
Parte 1: Creare il bot su Telegram
- Apri Telegram sul telefono o sul computer
- Cerca @BotFather nella barra di ricerca e apri la chat
- Invia il comando
/newbot - BotFather ti chiede il nome del bot — scegli quello che vuoi (es. "Avventura Genkai" o "Il Tavolo di Marco")
- Poi ti chiede lo username — deve finire con "bot" (es.
avventura_genkai_botoil_tavolo_di_marco_bot) - BotFather ti risponde con il token: una stringa lunga tipo
123456789:ABCdefGHIjklMNOpqrSTUvwxYZ. Copiala.
Parte 2: Configurare il bot nella dashboard
- Apri GENKAI GM Dashboard e carica il tuo progetto
- Clicca sull'icona Impostazioni nella barra in alto
- Vai alla sezione Telegram
- Incolla il token nel campo "Incolla il token qui"
- Clicca "Verifica e salva" — se il token è valido, vedrai il nome del bot confermato
- Apparirà un codice sessione a 6 cifre (grande, ben visibile) — questo è il codice che i giocatori useranno per unirsi
- Clicca "Avvia bot" per attivare la ricezione dei messaggi
Parte 3: Collegare i giocatori
Ora i giocatori devono unirsi. Condividi con loro queste istruzioni:
- Apri Telegram e cerca il bot usando lo username che hai scelto (es.
@avventura_genkai_bot) - Premi Avvia (o invia
/start) - Invia
/joinseguito dal codice sessione — es./join 847291 - Il bot mostra la lista dei personaggi — il giocatore sceglie il suo
- Fatto! Il giocatore è collegato al suo personaggio
Cosa puoi fare con Telegram
Una volta collegati, dalla dashboard puoi:
- Inviare messaggi — testo libero a uno o più giocatori
- Inviare file — click destro su un file nell'Explorer → "Invia via Telegram"
- Inviare selezioni di testo — seleziona un passaggio, click destro → "Invia via Telegram"
- Inviare eventi automatici — collega un evento del calendario a Telegram e si invia da solo quando avanzi alla data giusta
- Leggere i messaggi — la chat nella barra in alto mostra i messaggi ricevuti con badge per i non letti
- Usare l'AI — se attivi l'assistente AI su Telegram, i giocatori possono fare domande con
/ai
Stato della connessione
Nella sezione Telegram delle impostazioni puoi vedere:
| Indicatore | Significato |
|---|---|
| 🟢 Attiva | Il bot è in ascolto e riceve messaggi |
| 🔴 Non attiva | Il bot è fermo, nessun messaggio in arrivo |
| 🟢 accanto a un giocatore | Giocatore collegato e attivo |
| 🟣 accanto a un giocatore | Giocatore collegato ma non attivo |
Problemi comuni
"Il token non è valido"
Assicurati di aver copiato l'intero token da BotFather, senza spazi prima o dopo. Il formato è: numeri, due punti, lettere e numeri.
"Il giocatore non riesce a unirsi"
Verifica che il bot sia avviato (stato 🟢 Attiva) e che il giocatore stia usando il codice sessione corretto. Il codice cambia ogni volta che riavvii la dashboard.
"I messaggi non arrivano"
Controlla che il bot sia attivo e che il giocatore abbia un Chat ID assegnato (visibile nelle impostazioni del personaggio). Se il giocatore ha bloccato il bot su Telegram, i messaggi non verranno consegnati.