Creare un Bot Telegram

Questa guida ti accompagna nella creazione di un bot Telegram usando BotFather. Ci vogliono circa 2 minuti.

Passo 1: Apri BotFather

1. Apri Telegram (app o web)
2. Cerca @BotFather
3. Avvia una chat con BotFather

Importante: Assicurati di chattare con il @BotFather ufficiale (verificato con un segno di spunta blu).

Passo 2: Crea un Nuovo Bot

1. Invia il comando /newbot
2. BotFather ti chiederà un nome per il tuo bot
3. Inserisci un nome amichevole come “My Channel Tracker”

Passo 3: Scegli un Username

1. BotFather chiede uno username
2. Deve terminare con “bot” (es. mychanneltracker_bot)
3. Deve essere unico su Telegram

Consigli per gli username:

• Tienilo corto e memorabile
• Usa il nome del tuo brand + il suffisso _bot
• Esempi: brandname_bot, mychannel_tracker_bot

Passo 4: Copia il Token del Bot

Dopo la creazione, BotFather ti invia un messaggio con il token del bot. Ha un aspetto simile a:

1234567890:ABCdefGHIjklMNOpqrsTUVwxyz123456789

Mantieni questo token segreto! Chiunque abbia il token può controllare il tuo bot.

Passo 5: Aggiungi il Token ad AdTarget

1. Vai alla tua dashboard AdTarget 
2. Apri il sito che vuoi tracciare
3. Vai su Settings e seleziona la scheda Bots
4. Clicca Add bot
5. Incolla il token del bot nel campo di input

AdTarget verificherà automaticamente il token, collegherà il tuo bot e registrerà il suo webhook. Vedrai una notifica di successo con l’username del tuo bot una volta collegato.

Impostazioni del Bot (Opzionale)

Puoi personalizzare il tuo bot tramite BotFather:

Imposta un’Immagine del Profilo

1. Invia /setuserpic a BotFather
2. Seleziona il tuo bot
3. Carica un’immagine (idealmente il logo del tuo brand)

Imposta una Descrizione

1. Invia /setdescription a BotFather
2. Seleziona il tuo bot
3. Inserisci una descrizione che gli utenti vedono quando avviano il bot

Una Nota sulla Modalita Privacy

Non hai bisogno di cambiare la modalita privacy del bot. AdTarget configura il webhook per ascoltare gli eventi chat_member e my_chat_member, che Telegram consegna indipendentemente dall’impostazione privacy. L’impostazione privacy controlla solo se un bot riceve messaggi di testo normali nei gruppi — non ha alcun effetto sul tracciamento delle iscrizioni ai canali.

Buone Pratiche di Sicurezza

Proteggi il tuo token:

• Non condividere mai pubblicamente il token del bot
• Non inserirlo nel controllo versione
• Ruota il token se compromesso

Per rigenerare un token:

1. Invia /revoke a BotFather
2. Seleziona il tuo bot
3. BotFather genera un nuovo token
4. Elimina il vecchio bot in AdTarget e aggiungi il nuovo token tramite Settings → Bots → Add bot

Risoluzione dei Problemi

BotFather non risponde?

• Assicurati di scrivere al @BotFather verificato
• Prova a chiudere e riaprire la chat
• Controlla la tua connessione internet

Username già preso?

• Prova una variazione più unica
• Aggiungi numeri o underscore
• Usa il nome completo del tuo brand

Il token non funziona in AdTarget?

• “This bot is already connected to another account” — I token dei bot sono esclusivi per account AdTarget. Se hai usato questo token su un account diverso in precedenza, rimuovilo prima da li.
• “Maximum bots reached” — Ogni account AdTarget può avere fino a 20 bot. Elimina un bot inutilizzato prima di aggiungerne uno nuovo.
• Nessuna risposta quando incolli il token — Assicurati di aver copiato il token completo inclusi i numeri prima dei due punti (es. 1234567890:ABC...) senza spazi extra. La validazione automatica si attiva solo quando il formato corrisponde.
• Se il token è valido ma non funziona, prova a rigenerarlo con /revoke in BotFather e incolla quello nuovo.

Prossimi Passi

Ora che il tuo bot è creato, collegalo al tuo canale Telegram.