Knowledge base GetMyBot

Progetti e canali

Come creare un progetto, collegare un bot e controllarne lo stato. Più canali, cambio del token, pausa e ripristino dopo un blocco del piano.

In questa pagina

Un progetto riunisce impostazioni, reazioni e dati di un bot o servizio. Un canale lo collega a un luogo di conversazione preciso: un bot Telegram, la chat del sito o un altro servizio di messaggistica. Per esempio, una scuola può usare un progetto con due canali, Telegram e il sito web.

Crea il progetto in Progetti, poi aggiungi il canale. Per Telegram serve il token di @BotFather, che permette di gestire il bot. Puoi passare da un progetto all'altro nel selettore in alto nel pannello.

Un bot non è limitato a Telegram: puoi collegare anche WhatsApp e VK e gestire tutti i canali con le stesse reazioni. Trovi una panoramica in Canali e le istruzioni per WhatsApp in WhatsApp.

Collegare un bot

  1. Se non hai un progetto, apri Progetti e premi Aggiungi progetto. Nella scheda del progetto premi Aggiungi canale e scegli Telegram. Per il primo bot puoi anche usare la procedura guidata iniziale.
  2. Incolla il token di @BotFather e premi Verifica. GetMyBot mostra il @username trovato, così puoi controllare di aver incollato il token giusto.
  3. Premi Connetti. Il token viene conservato in forma cifrata e la ricezione degli aggiornamenti inizia subito.

Telegram compare nella scheda del progetto accanto agli altri canali. La scheda mostra nome del progetto, @username del bot, numero di utenti, reazioni attive e richieste di oggi. Puoi controllare il saldo delle richieste in Fatturazione o Statistiche.

Più bot

Un account può gestire più progetti e bot contemporaneamente. Il numero dipende dal piano, alla voce «numero massimo di bot». Cambia progetto dal selettore in alto o dalla pagina Progetti: Reazioni, Chat e Statistiche mostreranno i dati del progetto selezionato.

Come il bot riceve i messaggi

Dopo il collegamento, GetMyBot riceve gli eventi di Telegram: messaggi, clic sui pulsanti, ingressi nelle chat e pagamenti. Non serve configurare separatamente la ricezione: basta un token valido. Secondo la configurazione del server, Telegram invia gli eventi all'indirizzo della piattaforma (webhook) oppure la piattaforma li richiede periodicamente a Telegram (long polling).

Attivare e disattivare il bot

Ogni bot può essere attivo o disattivato, tramite la scheda Stato del bot nelle Impostazioni. Un bot disattivato non reagisce ai messaggi. Il cambio ha effetto subito, senza doverlo ricollegare.

Stato del progetto e disponibilità del canale

Nell'elenco Progetti, il progetto ha uno stato proprio: Attivo, In pausa o Bloccato. Questo stato non verifica la consegna dei messaggi Telegram. Ogni canale ha una propria etichetta: Online, Nessun segnale, Configurato, Disattivato o Progetto inattivo. Così un progetto attivo con la chat web, ma senza Telegram, non risulta fermo.

Se un progetto attivo ha un solo canale Telegram abilitato, Online indica che il processo che lo gestisce ha dato un segnale recente; altrimenti appare Nessun segnale. Se ha più canali Telegram abilitati, appare Configurato, perché il segnale comune al progetto non può essere attribuito con certezza a uno di essi. Anche per gli altri canali abilitati, Configurato indica un collegamento, non garantisce la consegna di ogni messaggio.

La piattaforma usa più processi equivalenti. Ciascuno segnala ogni 30 secondi che sta gestendo il bot. Un segnale resta recente per un minuto e mezzo, così la mancanza di un singolo aggiornamento non fa oscillare lo stato.

In pratica:

  • L'etichetta può comparire in ritardo. Dopo il collegamento o il riavvio della piattaforma, Online può apparire entro quella finestra, non necessariamente subito.
  • Se Nessun segnale persiste per più di un paio di minuti con Telegram abilitato, controlla il token e la scheda Bot health nelle Impostazioni. Il progetto resta attivo finché non lo metti in pausa o la piattaforma non lo blocca per il piano.
  • Il segnale è condiviso tra i processi: non dipende dal server che ha risposto alla tua richiesta e, con più canali Telegram, non prova la disponibilità di ciascuno.

Che cosa succede quando il bot è offline

Ogni minuto la piattaforma controlla i segnali. Se non ce n'è uno recente per un bot abilitato, apre un incidente: individua la causa e prova a rimettere il bot in funzione.

Nella scheda Bot health delle Impostazioni sono indicate quattro possibili cause:

  • webhook: Telegram non invia gli aggiornamenti all'indirizzo della piattaforma, che prova a registrarlo di nuovo;
  • token revocato: getMe restituisce 401. In questo caso non si tenta il riavvio: devi sostituire il token in @BotFather e inserirlo con Cambia token;
  • nessun server in funzione: nessun processo gestisce gli aggiornamenti e la piattaforma riavvia il bot;
  • causa sconosciuta: Telegram non ha risposto al controllo.

Il riavvio esegue le stesse operazioni del pulsante Sincronizza: verifica il token con getMe e registra nuovamente il webhook. I tentativi avvengono con pause crescenti. Ognuno viene registrato nel registro dei riavvii dell'incidente, con data, esito ed eventuale errore. Nella scheda vedi il registro e l'ora del prossimo tentativo.

Se il bot resta senza segnale oltre la soglia della scheda Bot health (5 minuti per impostazione predefinita), il proprietario riceve l'avviso «Bot offline» nella campana del pannello e via email. Le chat scelte come destinatarie degli avvisi ricevono un messaggio dal bot. Viene inviato un solo avviso per incidente. Quando riprendono i segnali, arriva «Bot di nuovo online» con la durata dell'interruzione. Nella stessa scheda resta l'elenco degli incidenti precedenti, con durata e causa.

Blocco dovuto al piano

Oltre allo stato attivo o disattivato, un bot può essere bloccato. È la piattaforma a bloccarlo quando il piano non copre più tutti i bot collegati. Ci sono solo due cause:

  • limite di bot superato: sei passato a un piano che consente meno bot di quanti ne hai collegati;
  • abbonamento non rinnovato: il piano a pagamento è terminato e si applica il limite del piano gratuito.

Un bot bloccato non riceve messaggi: la ricezione degli aggiornamenti viene disattivata. Dati, reazioni e iscritti restano intatti; il blocco è reversibile.

Come sbloccarlo. Attiva un piano a pagamento che copra il numero di bot necessario. Al momento dell'attivazione, la piattaforma ripristina automaticamente i bot a partire dai più vecchi, fino a raggiungere il limite del nuovo piano. Non puoi scegliere quali ripristinare. Se vuoi mantenere bot diversi, elimina prima i collegamenti superflui e poi attiva il piano.

Esiste anche il blocco dell'intero account, distinto da quello di un singolo bot. In tal caso tutti i bot e le diffusioni sono sospesi e nel pannello appare il banner «Account bloccato». Solo l'assistenza può rimuoverlo. Consulta Pagamenti e saldo.

Profilo e sincronizzazione

Il pulsante Sincronizza nelle Impostazioni aggiorna il nome del bot da Telegram, per esempio dopo che l'hai cambiato in @BotFather. La foto del profilo del bot si aggiorna automaticamente.

Cambiare il token

Se hai rigenerato il token in @BotFather (Bot Settings → Revoke / New token), aggiornalo in Impostazioni → Canali → Telegram 🔑. Il nuovo token deve appartenere allo stesso bot (con lo stesso ID interno Telegram) — in questo modo vengono mantenuti tutte le reazioni, gli iscritti e i dati. Se il canale Telegram non viene visualizzato, scegli «Cambia token» nella stessa finestra.

Trasferire il bot a un altro account

Impostazioni → Cambia proprietario invia per email un invito a trasferire il progetto a un altro account GetMyBot. L'invito è valido per 72 ore. Finché il destinatario non lo accetta, il progetto rimane tuo e puoi annullare il trasferimento. Dopo l'accettazione cambia il proprietario e perdi l'accesso al progetto. Usa questa funzione quando consegni il progetto a un cliente o a un collega.

Modelli di bot

Un modello è una copia delle impostazioni e di tutte le reazioni del bot che puoi applicare a un altro bot:

  • Crea modello, nelle Impostazioni, salva il bot attuale con un nome.
  • Applica modello sostituisce le impostazioni del bot selezionato con quelle del modello e aggiunge le reazioni del modello a quelle già presenti.

Puoi usarlo per riprodurre una configurazione standard in più progetti.

Il catalogo usa una procedura guidata. Inserisci i parametri, verifica la compatibilità e i collegamenti necessari, poi esamina l'elenco delle risorse che verranno create. Dopo l'installazione, completa i passaggi rimanenti e prova il flusso con una richiesta di test.

Questa procedura è diversa dall'applicazione di un modello del bot. Il controllo prima dell'installazione segnala parametri o funzioni mancanti. Il completamento di un passaggio nell'elenco non dimostra che il servizio esterno funzioni.

Risultati della soluzione pronta

Scegli il periodo da valutare per la soluzione installata. Per un confronto, seleziona una modalità disponibile e controlla la dimensione del campione e i dati diagnostici. Dati insufficienti e assenza di confronto non equivalgono a un risultato pari a zero.

Prossimi passi