Cosa sa fare il bot

  • Prenotazione di un servizio: scelta di data e ora, conferma e promemoria il giorno prima.
  • Risposte alle domande frequenti e passaggio delle domande complesse a una persona.
  • Ricezione delle richieste con salvataggio in una tabella e notifica al titolare.
  • Invii di massa e promemoria programmati.
  • Raccolta di dati dai siti, per esempio prezzi o nuovi annunci, e invio di un riepilogo.
  • Mini app di Telegram: un’interfaccia completa con pulsanti e moduli dentro il messenger.

Passo 1. Crea il bot con BotFather

  1. Su Telegram apri il bot ufficiale @BotFather e invia il comando /newbot.
  2. Scegli un nome e un nome utente per il bot: quest’ultimo deve finire con «bot».
  3. BotFather ti invierà un token, una lunga stringa del tipo 123456:ABC…. È la chiave del bot: non pubblicarla e non mostrarla a nessuno.

La cosa migliore è mettere il token in un file .env nella cartella del progetto (con la riga BOT_TOKEN=…) e dire all’agente dove si trova. Così il token non finisce né nel codice né nella conversazione.

Passo 2. Descrivi lo scenario

Descrivi cosa fa il bot dal punto di vista del cliente: cosa scrive, cosa vede in risposta, cosa succede dopo. Per esempio:

Crea un bot Telegram per le prenotazioni di un barbiere. Il cliente preme /start, sceglie il servizio (taglio, barba, completo — prezzi in prices.txt), una data nei prossimi 14 giorni e un orario libero dalle 10 alle 21. Dopo la prenotazione il bot invia una conferma e, 2 ore prima, un promemoria. A me, come titolare, arriva un messaggio per ogni nuova prenotazione. Il token è in .env.

Passo 3. Avvia e prova

L’agente scriverà il codice, installerà le librerie necessarie e avvierà il bot nel terminale integrato: vedi ogni comando e il suo output. Apri il bot su Telegram e segui lo scenario come se fossi un cliente. Se qualcosa non va, descrivi cosa hai fatto e cosa hai visto: l’agente troverà la causa nei log e la correggerà.

Passo 4. Mini app (facoltativa)

Se i pulsanti nella chat non bastano, chiedi una mini app di Telegram: un catalogo, un carrello o un modulo di prenotazione con calendario. Nella sezione «App» di NEO puoi aprirla in modalità Telegram, con i parametri di avvio e il tema del messenger, e provarla senza uscire da NEO.

Passo 5. Perché il bot funzioni 24 ore su 24

Finché il bot gira sul tuo computer, funziona solo quando il computer è acceso. Per farlo funzionare 24/7 va messo su un server: l’agente ti suggerirà le opzioni e preparerà tutto per l’avvio. I piani NEO prevedono un hosting proprio: con Pro un progetto è attivo 24 ore su 24, con Max tre.

Sicurezza

  • Il token è come una password. Se è trapelato, revocalo in @BotFather con il comando /revoke e generane uno nuovo.
  • Raccogli solo i dati dei clienti che ti servono e spiega a cosa servono.
  • Prima di aprire il bot a tutti, segui tu stesso lo scenario dall’inizio alla fine, anche con gli errori: data sbagliata, doppio clic, annullamento.