(IT) Guida rapida per il gestore

I più sentiti ringraziamenti per avere scelto di usare zweb booking bot, il bot di Telegram che semplifica le prenotazioni di spazi e servizi in affitto a tempo.

Questa guida è pensata per fornire una panoramica delle caratteristiche del software associato al bot e delle modalità di interazione con il bot. Buona lettura.

Versione del software a cui si riferisce la guida: R32 (settembre 2024).

Funzionalità

Per l'utente

Si dà a seguire una lista con descrizione sintetica di ciò che offre il servizio di prenotazione di Zweb Booking Bot. Come utente, con questo bot puoi:

Per il gestore del servizio

In aggiunta a tutte le funzionalità precedenti, il gestore del servizio può anche:

Il gestore del servizio sarà riconosciuto dal sistema automaticamente, in base all'id Telegram impostato nella configurazione.

Per il configuratore del servizio (sviluppatore) e/o il gestore

E' utile sapere che la configurazione manuale del bot, da effettuarsi generalmente al primo avvio del servizio editando un apposito file di testo di configurazione, permette inoltre di:

Ricette ed esempi

D: Come creo una regola per i turni di esercizio di un giorno specifico della settimana, ad esempio il martedì, affinché siano effettivi a partire dal 5 giugno e fino al 30 agosto 2024?

R: Scrivere nel campo di testo della chat:

.imposta turni Mar 09:30/13:00,15:00/22:30 05-06-2024 30-08-2024

Di norma, i giorni della settimana sono Lun, Mar, Mer, Gio, Ven, Sab, Dom. Come si può vedere, gli intervalli di orario devono essere scritti senza spazi, e separati fra loro solo da una virgola. A seguire, si inserisce il giorno mese e anno di inizio della regola e di fine della regola, con le parti della data separate da trattino.

D: E se i servizi che offro hanno turni di esercizio diversi?

R: Supponiamo di avere più servizi, e che il servizio con un turno diverso abbia come short_name nella configurazione il nome campo1. Scrivere ad esempio nel campo di testo della chat:

.imposta servizio turni Mar 12:00/19:30 05-06-2024 30-08-2024 campo1

Questo farà sì che la regola per il servizio campo_1 abbia la priorità quando un utente prenota, e sia usata al posto di quella precedente (che ha validità generale)

D: E se volessi una regola attiva da subito?

Basta mettere, nella scrittura precedente, una qualsiasi data nel passato (anteriore a oggi), et voilà!

D: Ho sbagliato nell'inserire una regola. E adesso?

R. Per eliminare l'ultima regola inserita è possibile scrivere:

.cancella ultima regola

Attenzione: se questo comando viene usato più volte, ogni volta eliminerà una regola.

In alternativa, poiché l'ultima regola inserita relativa a un certo giorno della settimana è quella valida, sarà sufficiente impostarne una nuova. Se ad esempio si inserisce una nuova regola per lo stesso servizio, con lo stesso giorno della settimana e la stessa data, il sistema utilizzerà l'ultima inserita, ignorando tutte le precedenti.

D: Come visualizzo tutte le regole attive per i turni della settimana?

R: Scrivendo in chat:

.mostra turni attivi

D: Come recupero le ultime 50 prenotazioni inserite?

R: Scrivere nel campo di testo della chat:

.ottieni ultime 50

Al posto di 50, puoi inserire il numero che preferisci.

D: Come ottengo le prenotazioni attive in questo momento?

R: Premi il pulsante "/prenotazioni_attive" nella tastiera di Telegram, e le riceverai in formato Excel (.xlsx).

D: Come ottengo le prenotazioni di aprile 2024?

R: Scrivere nel campo di testo della chat:

.ottieni prenotazioni 2024-04

Prima l'anno, poi il mese, separati da un trattino.

D: Come recupero l'archivio integrale in .csv con tutte le prenotazioni inserite / annullate?

R: Scrivere nel campo di testo della chat:

.ottieni tutto

Nota: questo file, col tempo, potrebbe diventare relativamente voluminoso se il tuo volume di affari è importante. La ragione per cui l'archivio è in formato 'csv' è questa: il file si manterrà di dimensioni più contenute, il formato è universale, e il sistema lo aggiornerà ad ogni prenotazione e cancellazione, tenendolo già pronto nel caso tu lo richieda.

D: Come cancello una specifica prenotazione? Non posso accettarla!

R: Recupera prima di tutto le prenotazioni con uno dei metodi già visti. Sègnati il valore nel campo rid della riga di quella prenotazione. Quindi scrivi in chat:

.cancella 1234, sostituendo a "1234" il rid corrispondente. Attenzione: questa operazione non può essere annullata, se non rifacendo la stessa prenotazione!

Nota: Per ragioni di privacy e spam, il bot non può avvisare l'utente che la sua prenotazione è stata cancellata: sarebbe gentile che gli scrivessi tu per avvisarlo!

D: Come recupero la lista in formato Excel degli utenti registrati?

R: Scrivere nel campo di testo della chat:

.ottieni utenti

D: Ho individuato un utente fraudolento: come bloccarlo?

R: Prima recupera gli utenti come scritto sopra, e segnati il suo "id". Si può disattivare un utente specifico scrivendo in chat:

.disabilita utente {id}, inserendo l'id numerico dell'utente (senza parentesi) al posto di "{id}". Se l'utente era già bloccato, non saranno operate modifiche. Una volta bloccato l'utente, lo sarà anche la sua procedura di prenotazione.

Nota: Se l'utente, nell'istante in cui viene bloccato, stava eseguendo una prenotazione, potrebbe effettuarla ugualmente. Da quel momento, però, non gli sarà più possibile farne di nuove.

D: E se volessi riammetterlo?

R: Basta scrivere:

.abilita utente {id}, inserendo l'id numerico dell'utente (senza parentesi) al posto di "{id}". Se l'utente era già abilitato, non saranno operate modifiche.

D: Un cliente mi chiede di poter prenotare il servizio per due mesi tutti i lunedì, dalle 16 alle 18. Posso eseguire una prenotazione ripetuta?

R. Dalla versione R20 beta, questo è possibile per il solo gestore, su base settimanale. Supponiamo che il primo lunedì sia il 22 aprile 2024 e che il servizio abbia lo shortname "Palestra2". Ogni lunedì per due mesi significa almeno 8 prenotazioni. Si userà il seguente comando:

.prenota 8 volte 22-04-2024 16:00/18:00 Palestra2

D: Un cliente mi chiama e vuole effettuare una prenotazione. Come aggiungo la prenotazione al bot?

R. Devi semplicemente scrivere una riga di messaggio contenente tutti i dati necessari per la prenotazione, compreso un nome alla fine del messaggio. Questo nome ti aiuterà a ricordare la prenotazione, ma il sistema memorizzerà anche l'ID telegramma del custode, così saprai che hai prenotato per conto di qualcun altro. Esempio di prenotazione veloce:

.p 20-06-2024 18:00/20:00 Padel_court John Doe

Si prega di notare che:

Auto-prenotazione

A partire dalla versione R 24, il gestore del servizio può prenotare per conto terzi anche con la procedura guidata a pulsanti di Telegram usata dagli altri utenti; al termine della procedura, si dovrà, in aggiunta, inserire un nominativo della persona per conto della quale si prenota (di default, il nominativo dovrà essere preceduto dal prefisso .utente (con uno spazio alla fine del prefisso).

Foglio informativo

Queste sono le strutture dei comandi di testo standard con parametri racchiusi tra parentesi graffe. Non è necessario mettere le parentesi graffe quando si scrive un comando nel campo di testo della chat di Telegram, proprio come mostrato negli esempi sopra: le parentesi graffe vanno scritte solo nel file di configurazione per indicare un parametro; il parametro è un segna-posto, quando si scrive un comando in chat, va sostituito con il valore che si intende dare a quel parametro. Il nome del parametro può essere cambiato (usando di preferenza solo lettere minuscole e trattini bassi ( _ ) ), ma il cambiamento non altera il comportamento del software.

Nome interno del comando Struttura del comando con parametri
get_all_csv .ottieni tutto
get_latest_excel .ottieni ultime {n_prenotazioni}
cancel_one .annulla {id_prenotazione}
set_day_shift .imposta turni {giorno_settimana_abbrev} {intervalli_tempo} {data_inizio} {data_fine}
set_service_day_shift .imposta servizio turni {giorno_settimana_abbrev} {intervalli_tempo} {data_inizio} {data_fine} {short_name_servizio}
get_active_shifts .mostra turni attivi
get_service_shifts .mostra turni servizio {short_name_servizio}
delete_last_inserted_rule .cancella l'ultima regola
enable_registered_user .abilita utente {id_utente}
disable_registered_user .disabilita utente {id_utente}
delete_registered_user .elimina utente {id_utente}
get_registered_users .ottieni utenti registrati
reservations_by_month .ottieni prenotazioni {year_dash_month}
multiple_reservation .prenota {x} volte {mm_gg_aaaa} {intervallo_tempo} {short_name_servizio} {nome_cliente}
fast_reservation .p {mm_gg_aaaa} {intervallo_tempo} {short_name_servizio} {nome_cliente}

Ricorda!

Configurazione

Attraverso ulteriori parametri di configurazione, è possibile decidere:

Per modificare questi parametri, è richiesto l'accesso allo spazio web che ospita il codice dell'applicazione, una minima esperienza di programmazione. I parametri di configurazione permettono di personalizzare l'esperienza d'uso del chatbot, specialmente nella fase iniziale.

Limitazioni

Il software al momento presenta alcune limitazioni alle funzioni appena viste: