Documentazione

Tutto quello che ti serve per configurare StayHelp nella tua struttura.

1

Crea un account

Vai alla pagina di registrazione, inserisci il nome della struttura, email e password. I 60 giorni di prova gratuita iniziano subito.

Registrati ora
2

Crea il tuo bot Telegram

Apri Telegram, cerca l'utente @BotFather (lo strumento ufficiale di Telegram per creare bot) e avvia una chat con lui.

  1. Invia il comando /newbot
  2. Scegli un nome visualizzato (es. "Villa Bellavista Concierge")
  3. Scegli uno username che finisca con "bot" (es. villabellavistabot)
  4. BotFather ti risponderà con un token. Tienilo segreto.
123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
3

Collega il bot a StayHelp

Nella tua dashboard vai su Setup e incolla il token ricevuto da BotFather. Verifichiamo il token e registriamo il webhook automaticamente. Da quel momento ogni messaggio inviato al tuo bot arriva in StayHelp.

4

Addestra il bot chattando

Apri una chat con il tuo bot su Telegram. Invia un messaggio presentandoti come proprietario, poi descrivi la tua struttura.

/train

Poi invia messaggi tipo:

  • "Il check-in è dalle 14:00 alle 22:00. Avvisami su WhatsApp quando arrivi."
  • "La colazione si serve in cucina dalle 8:00 alle 10:30."
  • "WiFi: rete VILLA_GUEST, password welcome2025."
  • "Il parcheggio è gratuito, usa i posti contrassegnati con una B."

Il bot classifica ogni messaggio automaticamente (check-in, wifi, colazione, regole...) e lo normalizza. Puoi rivedere e modificare le voci dal pannello.

5

Aggiungi stanze e stampa i QR code

Per ogni stanza aggiunta, StayHelp genera un QR code univoco pronto da stampare.

  • Vai su Dashboard -> Stanze
  • Clicca "Aggiungi stanza" e inserisci codice (es. 101) e nome
  • Clicca "Scarica QR" per ottenere il PNG, stampalo e mettilo in camera
6

Gestisci le escalation

Quando il bot non riesce a rispondere con sicurezza, inoltra la domanda a te su Telegram (con un ID escalation di 8 caratteri). Tu rispondi una volta, StayHelp traduce la risposta nella lingua dell'ospite.

/reply a1b2c3d4 Il supplemento per check-in tardivo è 20 euro.
7

Comandi del bot

Tutti i comandi dell'host girano nella chat Telegram con il bot. L'ospite non li vede mai.

Comando Descrizione
/trainAttiva modalità addestramento
/stopEsci dalla modalità addestramento
/listMostra le voci della knowledge base
/delete [id]Elimina una voce
/roomsElenca le stanze
/addroom [code] [name]Aggiungi una stanza
/qr [code]Ricevi il QR code di una stanza
/statsStatistiche di utilizzo
/escalationsElenca le escalation in attesa
/reply [id] [text]Rispondi a un'escalation
/translation on|offAttiva/disattiva traduzione automatica
/welcome [text]Imposta il messaggio di benvenuto
/addadmin [id]Aggiungi un collaboratore (tramite Telegram ID)
/helpMostra tutti i comandi
8

Upgrade e fatturazione

Hai 60 giorni gratis, nessuna carta richiesta. Al termine scegli il piano che corrisponde al numero di stanze. Cambio piano, aggiornamento carta e scaricamento fatture avvengono tramite il portale cliente Stripe, accessibile dalla pagina Fatturazione della dashboard.

Vedi i piani