Benvenuto in Micali.online

Ruoli utente

Ogni persona che interagisce con Micali.online rientra in uno di questi ruoli. I ruoli controllano ciò che qualcuno può vedere, modificare e approvare.

Cosa può fare ciascun ruolo

Account

Un account rappresenta un’azienda o un’organizzazione proprietaria della configurazione di prenotazione: il salone, lo studio, la clinica. Ogni account ha il proprio sottodominio pubblico (ad esempio yourname.micali.online) dove i visitatori atterrano per effettuare una prenotazione.

Un account contiene tutti gli elementi con cui interagisce un visitatore: gli abbonamenti che può acquistare, i servizi e le prestazioni che può prenotare, gli eventi a cui può iscriversi e i moduli che compila lungo il percorso.

Dove vanno le risposte

Imposti un indirizzo di risposta sull’account e ogni messaggio che Micali.online invia per suo conto lo riporta, così un visitatore che si limita a rispondere raggiunge la casella che lei consulta davvero. Lo lasci vuoto e le risposte torneranno all’indirizzo da cui è stata inviata la posta. È un’unica impostazione per tutti i suoi modelli, non qualcosa da ripetere su ciascuno.

Colori

Ci sono 28 temi di colore. Un account ne sceglie uno per tutti, e ogni persona può sostituirlo per sé stessa — la sua scelta personale prevale su quella dell’account, e quella dell’account su quella standard. Cambia l’app usata da lei e dal suo team; non modifica lo stile della sua pagina di prenotazione pubblica.

Eventi

Un evento è una fascia oraria — o una serie di fasce orarie — a cui i visitatori possono iscriversi. Utilizzi gli eventi per corsi, sessioni di gruppo, workshop, spettacoli e qualsiasi altra prenotazione legata a un orario di inizio fisso.

Eventi modello vs. eventi classici

Gli eventi esistono in due varianti:

• Evento modello — un modello riutilizzabile. I modelli non vengono mai mostrati ai visitatori; esistono perché lei possa generare molti eventi reali con le stesse impostazioni (capacità, modulo, messaggi, ecc.) senza dover reinserire tutto.
• Evento classico — un evento reale e prenotabile. Un evento classico può essere creato da zero o collegato a un modello, nel qual caso eredita la configurazione del modello.

Impostazioni chiave da conoscere

• Capacità — quanti visitatori possono partecipare a un posto e se ogni visitatore può portare degli “amici” (entità aggiuntive). Imposti un minimo e un massimo di partecipanti. La capacità viene conteggiata in posti, non in prenotazioni: un visitatore che porta due amici ne occupa tre.
• Scadenza di iscrizione — l’ultimo momento in cui un visitatore può prenotare. Se lasciato vuoto, le prenotazioni restano aperte fino all’inizio dell’evento.
• Conferma automatica — se le prenotazioni vengono accettate immediatamente o attendono l’approvazione dell’amministratore.
• Abbonamenti consentiti — limiti chi può prenotare restringendo l’evento ad abbonamenti specifici. Se lascia vuoto, chiunque può prenotare.
• Lista d’attesa — quando l’evento è al completo, i nuovi visitatori possono essere inseriti in una lista d’attesa e ricevere automaticamente una notifica quando si libera un posto.
• Messaggi — scelga quali modelli di messaggio vengono inviati per la conferma di prenotazione, i promemoria di pagamento, le cancellazioni, i promemoria di presenza e gli aggiornamenti della lista d’attesa. Ogni evento ha il proprio slot per ogni scopo, quindi può combinare modelli diversi per evento.
• Responsabile — il membro del team a cui appartiene l’evento. È a lui che Micali.online scrive quando qualcosa richiede attenzione, è lui a cui %responsible_person% fa riferimento nei suoi messaggi, ed è preselezionato per gestire le conversazioni a riguardo. Una singola data può indicare qualcun altro, ed è così che copre la settimana di un collega senza toccare l’evento stesso.
• Allegati — file che accompagnano l’evento, fino a 8 MB ciascuno. Vengono conservati esattamente come caricati: nulla viene ridimensionato o ritagliato, così una piantina o un modulo scansionato restano leggibili.

Servizi e prestazioni

I servizi sono per prenotazioni individuali in cui il visitatore sceglie un orario che gli è comodo. Pensi a un parrucchiere, a una lezione privata, a una consulenza o a un trattamento.

Come si relazionano servizi e prestazioni

• Un servizio è il contenitore: l’offerta nel suo insieme (ad esempio, “Parrucchiere del centro”). Ha un nome, una descrizione, un luogo, un indirizzo e un fuso orario.
• Una prestazione è una cosa specifica prenotabile all’interno di quel servizio (ad esempio, “Taglio — 30 minuti”, “Colore — 90 minuti”). Un servizio può avere molte prestazioni.
• La disponibilità è il calendario delle finestre temporali in cui i visitatori possono scegliere di prenotare. Si impostano per servizio.
• Spaziatura degli slot decide con quale frequenza una prenotazione può iniziare all’interno di quelle finestre — ogni 5, 10, 15, 20, 30, 60 o 120 minuti, 15 per impostazione predefinita. È un’unica impostazione per l’intero servizio: ciò che viene offerto a un visitatore e ciò in cui lei può prenotarlo sono la stessa griglia, quindi non può prenotare nulla che il visitatore stesso non avrebbe potuto prenotare.

Sulla pagina pubblica, un visitatore sceglie prima un servizio, poi una prestazione, poi un orario libero — e infine compila qualsiasi modulo richiesto.

Messaggi automatici

Ogni prestazione può essere collegata a quattro modelli di messaggio: uno per il momento in cui viene creata una prenotazione, uno per la conferma, uno per il rifiuto e un promemoria prima dell’appuntamento. Scelga i modelli per prestazione in modo che servizi diversi possano parlare con toni diversi.

Sale

Le sale sono spazi condivisi che possono prenotare solo le persone che lei approva — una sala riunioni, uno studio, una postazione, una sala prove. A differenza di un servizio, il visitatore non prenota il suo tempo per qualcosa che lei offre; prenota la sala per tutto il tempo di cui ha bisogno, nel rispetto delle regole che lei stabilisce.

Chi può prenotare: le etichette

Un'etichetta è un contrassegno che assegna alle persone — Dipendenti, Direzione, Soci. Una persona può avere più etichette, e una sala elenca le etichette autorizzate a prenotarla; ne basta una qualsiasi. Una sala senza etichetta può essere prenotata solo dal suo team.

Inviti delle persone da Sale → Accesso: incolli i loro indirizzi email, scelga le etichette e invii l'invito. Non c'è alcuna password — accedono con un codice monouso inviato a quell'indirizzo.

Un visitatore che ha effettuato l'accesso e apre una sala visibile che non può ancora prenotare può chiedere l'accesso. Le persone responsabili della sala approvano (il che gli assegna le etichette della sala) o rifiutano, e il visitatore riceve un'email in entrambi i casi.

Per uno spazio di coworking, o una sala che chiunque può usare, imposti la sala su Chiunque acceda. Tenga presente che chiunque può accedere con qualsiasi indirizzo email.

Visibile o nascosta

Una sala visibile mostra le sue foto, descrizione, capacità, orari e regole a chiunque abbia il link, ma per prenotare serve comunque accedere e avere un'etichetta. Una sala nascosta risponde “non trovata” a chiunque non possa prenotarla, così anche un link trapelato non rivela nulla. Non esiste un elenco pubblico di tutte le sale: le persone raggiungono una sala tramite la sua pagina di prenotazione o il suo link personale. Può cambiare la visibilità direttamente dall'elenco delle sale.

Impostazioni principali

• Orari — quando la sala può essere prenotata, per ogni giorno della settimana, con più fasce al giorno se necessario. Il suo team può prenotare al di fuori di questi orari.
• Preparazione e pulizia — i minuti in cui la sala resta bloccata prima e dopo ogni prenotazione (0 = nessuno).
• Griglia oraria — con quale frequenza una prenotazione può iniziare e finire, ad esempio ogni 15 minuti.
• Regole per i visitatori — la prenotazione più lunga, la pausa minima tra le prenotazioni della stessa persona (in modo che due prenotazioni consecutive di 2 ore non possano aggirare un limite di 2 ore) e con quanti giorni di anticipo. Si applicano solo alle prenotazioni che i visitatori fanno da soli.
• Conferma automaticamente — attivo: la prenotazione viene confermata subito. Disattivo: resta in attesa finché una persona responsabile non la conferma o la rifiuta.
• Calendario condiviso — disattivato, il motivo, o il motivo con i nomi. Decide cosa vedono, sugli orari occupati, le persone che possono prenotare la sala; nessun altro lo vede mai.
• Persone responsabili — i membri del team avvisati delle nuove prenotazioni, delle cancellazioni e delle richieste di accesso, e che le decidono. Se non ne sceglie nessuno, vengono avvisati gli amministratori.

Come un visitatore prenota una sala

Nella pagina della sala il visitatore accede, sceglie un giorno nel calendario, poi un orario di inizio libero — gli orari occupati restano nella griglia, in grigio — e infine la durata, a cosa serve la prenotazione e una nota facoltativa. Ogni passaggio ha un proprio indirizzo, quindi ricaricare la pagina mantiene la sua posizione. Le sue prenotazioni di sale compaiono in Le mie prenotazioni, dove può annullare fino all'inizio della prenotazione.

Gestire le prenotazioni delle sale

Sale → Calendario mostra la settimana di una sala o di tutte, con le prenotazioni in attesa di conferma in cima. Clicchi su un orario libero per prenotare per conto di qualcuno (via email) o per bloccare la sala internamente; clicchi su una prenotazione per confermarla, rifiutarla, spostarla, rinominarla o annullarla. Le sue prenotazioni non seguono le regole per i visitatori né gli orari, ma non possono mai sovrapporsi a un'altra prenotazione. Una prenotazione può ripetersi ogni giorno lavorativo, ogni settimana o ogni due settimane per un massimo di un anno — le date già occupate vengono saltate ed elencate. La pagina Visitatori ha una scheda Sale con le prenotazioni di ogni sala, e l'elenco Tutti i visitatori mostra le etichette di tutti.

Messaggi automatici

Ogni sala sceglie quale modello di messaggio viene inviato, e quando: la prenotazione attende conferma, è confermata (con un file di calendario allegato), è rifiutata, è annullata dal visitatore, è annullata da lei, è spostata a un altro orario, e un promemoria un numero prefissato di ore prima. La sua prima sala riceve modelli già pronti che può modificare.

Abbonamenti

Un abbonamento è un piano prepagato che un visitatore acquista — una card a punti, un abbonamento mensile, un abbonamento stagionale. Utilizzi gli abbonamenti per fatturare in anticipo e per controllare chi è autorizzato a prenotare determinati eventi.

Cosa definisce un abbonamento

• Prezzo e valuta — quanto paga il visitatore.
• Limiti di utilizzo — numero massimo di utilizzi e/o durata massima in giorni. Lasci un limite vuoto, oppure lo imposti a 0, e sarà considerato illimitato.
• Finestra di disponibilità — quando l’abbonamento può essere acquistato (available_from e, opzionalmente, available_to).

Come gli abbonamenti regolano l’accesso agli eventi

Di per sé, un abbonamento è solo un prodotto che i visitatori possono acquistare. Per utilizzarlo come filtro, lo colleghi a uno o più eventi come abbonamento consentito. Dopodiché, solo i visitatori in possesso di tale abbonamento potranno prenotare l’evento.

Per impostazione predefinita, un credito viene speso solo dopo che qualcuno conferma che il visitatore si è effettivamente presentato — il posto attende l’interruttore presente nell’elenco dei visitatori. Due impostazioni possono derogare a questo, a due livelli diversi: il piano può indicare che questo abbonamento consuma sempre un credito, e un singolo evento può indicare che questo evento consuma un credito anche senza presenza. Basta che una delle due sia attiva.

Quindi un’assenza costa un credito al visitatore quando il piano o l’evento lo prevedono, e non costa nulla quando nessuno dei due lo prevede — nel qual caso il credito resta semplicemente in sospeso finché un responsabile non segna il visitatore come presente.

Seguire l’abbonamento di un visitatore

Apra l’abbonamento di un visitatore e otterrà l’elenco di ogni prenotazione che ha speso un credito da esso, con la data in cui ciascuna è stata conteggiata. Quando qualcuno chiede perché gli restano tre visite invece di quattro, quell’elenco è la risposta.

Può anche modificare la dotazione di quella singola persona senza toccare il piano seguito da tutti gli altri — offrire una lezione sostitutiva dopo una cancellazione, o correggere un errore di conteggio. Imposti il suo numero di partenza, oppure aggiunga e sottragga da esso strada facendo; ogni modifica viene registrata insieme a chi l’ha effettuata, così un saldo modificato può sempre essere spiegato in seguito.

Come viene utilizzato un abbonamento

Quando un visitatore con un abbonamento valido prenota qualcosa che l’abbonamento copre, per impostazione predefinita questo viene applicato per lui — non deve ricordarsi di selezionarlo, e lei non deve collegarlo in seguito. Applicarlo non è la stessa cosa che spenderlo: il credito viene riservato in quel momento e viene conteggiato solo una volta che la presenza è stata confermata, secondo le regole descritte sopra.

Messaggi automatici di abbonamento

Gli abbonamenti possono attivare quattro modelli di messaggio:

• Dopo ogni utilizzo — conferma che è stato speso un credito e quanti ne restano.
• Prima della data di scadenza — un preavviso un numero configurabile di giorni prima della scadenza dell’abbonamento.
• Alla scadenza — inviato quando l’abbonamento termina.
• Pochi utilizzi rimanenti — inviato quando i crediti rimanenti del visitatore scendono al di sotto di una soglia che lei imposta.

Moduli

Un modulo è l’insieme di domande a cui un visitatore risponde durante la prenotazione. Lo crei una volta e lo alleghi ovunque le servano le risposte: un evento, un servizio, un abbonamento o ogni singolo partecipante di una prenotazione.

Cosa può chiedere

Ogni campo ha un’etichetta, un tipo e un nome interno. I tipi disponibili sono:

Testo e testo lungo, numero, scelta (pulsanti di opzione o un menu a discesa), e data, ora o data e ora.

Moduli per ogni partecipante

Quando una prenotazione può includere accompagnatori, un evento può richiedere i dettagli di ogni partecipante e non solo della persona che prenota. Quel modulo deve contenere un campo chiamato name — è ciò che identifica ogni partecipante nei suoi elenchi.

I visitatori abituali non devono riscrivere nulla

Quando qualcuno che ha già risposto a un modulo prenota di nuovo, le sue ultime risposte a quello stesso modulo vengono precompilate per lui. La corrispondenza avviene sul modulo, non sul luogo in cui ha risposto — così due eventi che condividono un modulo si precompilano a vicenda, e la risposta più recente prevale sempre.

Una vecchia risposta viene riutilizzata solo se corrisponde ancora al campo così come è definito oggi. Un campo che nel frattempo è stato rimosso o rinominato, una scelta che non è più nell’elenco, un numero ora fuori intervallo — tutto ciò parte vuoto anziché essere mantenuto. Riportare silenziosamente un valore simile sarebbe peggio di un campo vuoto: il visitatore non vedrebbe nulla nella casella mentre la risposta obsoleta verrebbe comunque inviata.

Modelli di messaggio

Un modello di messaggio è un testo riutilizzabile che la piattaforma invia ai visitatori al momento giusto: conferma di prenotazione, promemoria di pagamento, promemoria di presenza, avviso di scadenza e così via. Definisca un modello una sola volta a livello di account e lo richiami da ogni evento, prestazione di servizio o abbonamento che debba utilizzarlo.

Un modello, tre canali

Ogni modello ha slot per una versione email (oggetto + corpo), una versione SMS (oggetto + corpo) e una notifica push (titolo + corpo). Ne compili uno, due o tutti e tre — al salvataggio ne deve essere presente almeno uno.

Ciò che lascia in bianco semplicemente non viene utilizzato:

• Se il corpo dell’email è vuoto, non viene inviata alcuna email quando questo modello viene attivato.
• Se il corpo dell’SMS è vuoto, non viene inviato alcun SMS quando questo modello viene attivato.
• Se il corpo del push è vuoto, non viene inviata alcuna notifica push quando questo modello viene attivato.

Oltre al testo, ogni modello include un interruttore invia email e un interruttore invia SMS, entrambi attivi per impostazione predefinita. Disattivandone uno, il testo resta esattamente come lo ha scritto, ma smette di essere inviato su quel canale — utile per sospendere gli SMS per un mese senza doverli riscrivere in seguito. Può cambiarli direttamente dall’elenco dei modelli. Il push non ha interruttore: viene sempre inviato quando il modello ha un testo push, perché è l’unico canale che raggiunge un visitatore che non le ha fornito né un indirizzo email né un numero di telefono.

Un canale ha anche bisogno di una destinazione. L’email viene saltata per un visitatore senza indirizzo email e l’SMS per un visitatore senza numero di telefono, indipendentemente da come sono impostati gli interruttori.

Segnaposto che può utilizzare

I modelli supportano semplici variabili che vengono sostituite con dati reali al momento dell’invio. Può inserire uno qualsiasi di questi nell’oggetto o nel corpo, su entrambi i canali:

I segnaposto che non si applicano a un determinato messaggio (ad esempio, %event_name% in un promemoria di servizio) vengono semplicemente lasciati vuoti.

Dove vengono utilizzati i modelli

Il più delle volte un modello viene richiamato automaticamente dall’entità che attiva il messaggio. Ecco l’elenco completo degli slot.

Su un evento

• Prenotazione creata — inviato nel momento in cui un visitatore invia una prenotazione.
• Conferma — inviato quando la prenotazione viene confermata (manualmente o automaticamente).
• Conferma prima prenotazione — inviato al posto della conferma abituale quando questa è la prima prenotazione del visitatore per l’evento, così i nuovi arrivati possono ricevere un’accoglienza più calorosa rispetto agli abituali.
• Pagamento mancante — promemoria di pagamento, con uno o due intervalli configurabili (primo e secondo promemoria, in ore prima dell’evento).
• Promemoria di presenza — inviato un numero configurabile di ore prima dell’evento.
• Cancellazione — inviato quando il visitatore annulla.
• Cancellazione dall’account — inviato quando un amministratore annulla la prenotazione del visitatore.
• Lista d’attesa — aggiunto — inviato quando il visitatore viene inserito nella lista d’attesa.
• Lista d’attesa — promosso — inviato quando si libera un posto e al visitatore viene consentito prenotare.

Su una prestazione di servizio

• Prenotazione creata — inviato quando il visitatore invia la richiesta.
• Conferma — inviato quando l’appuntamento viene approvato.
• Conferma prima prenotazione — inviato al posto della conferma abituale quando questa è la prima prenotazione del visitatore per il servizio.
• Rifiuto — inviato quando la richiesta viene respinta.
• Promemoria — inviato prima dell’appuntamento.

Su un abbonamento

• Dopo ogni utilizzo — inviato ogni volta che viene speso un credito.
• Prima della data di scadenza — inviato un numero configurabile di giorni prima della scadenza dell’abbonamento.
• Alla scadenza — inviato quando l’abbonamento raggiunge la sua data di scadenza.
• Pochi utilizzi rimanenti — inviato quando il numero di crediti rimanenti scende al di sotto della soglia che lei imposta.

AI

Micali.online può rispondere alle sue domande sull’app, aiutarla a scrivere e generare i messaggi che ricevono i suoi visitatori. Tutto questo è facoltativo e nulla viene mai inviato a un visitatore senza che lei lo veda prima.

Chiedi all’AI

Un assistente all’interno dell’app che conosce sia il funzionamento di Micali.online sia il contenuto del suo account, così può chiedere “come faccio a impedire che questo evento appaia pubblicamente?” oppure “quali dei miei abbonamenti scadono questo mese?” e ottenere una risposta sulla sua configurazione. La conversazione è privata del suo account e viene conservata per sette giorni.

Quale AI fa il lavoro

Un amministratore root sceglie la connessione in AI, nelle impostazioni dell’account. Ci sono due modi per farla funzionare:

• La propria chiave — incolli una chiave API di ChatGPT o Gemini. Lei paga direttamente il proprio fornitore, e Micali.online non addebita nulla per questo.
• Integrata — usi la connessione propria di Micali.online, senza nulla da configurare.

Una chiave incollata viene memorizzata in sola scrittura: l’app le mostrerà un’anteprima mascherata e può rivelargliela di nuovo, ma non viene mai restituita tramite l’API. Può testare la connessione prima di salvare e vedere quanto ha utilizzato.

Assistente di scrittura

Accanto alla maggior parte dei campi di testo più lunghi — una descrizione di evento o servizio, la descrizione della sua attività, una risposta in chat a un cliente — si trovano due pulsanti. Rifinisci migliora ciò che ha già scritto; Genera scrive una prima bozza a partire da un breve brief. Entrambi mostrano il risultato in una finestra di dialogo che lei può accettare o rifiutare, così nulla viene mai sovrascritto silenziosamente.

Messaggi ai visitatori scritti dall’AI

Un modello di messaggio può contenere un’istruzione anziché un testo fisso, su uno qualsiasi dei suoi canali. Il testo viene quindi scritto ex novo al momento dell’invio a partire dall’istruzione più i dettagli di quella prenotazione, così ogni visitatore riceve qualcosa di specifico invece di un’unica frase con il nome inserito.

Mantenga comunque compilato il testo statico. È il ripiego: se la generazione fallisce, o l’account non ha una connessione AI, viene inviato al suo posto il testo statico e il visitatore non se ne accorge.

Claude & ChatGPT (MCP)

Micali.online gestisce un server MCP. Lo colleghi una volta a Claude o ChatGPT e potrà chiedere delle sue prenotazioni in linguaggio comune — “chi non ha pagato per sabato?” — senza aprire affatto l’app. L’assistente funziona con il suo abbonamento AI, vede solo ciò che può vedere lei stesso, e può essere scollegato dal suo profilo in qualsiasi momento.

Come connettersi

Quattro passaggi, circa un minuto, e alla fine non resta in giro nessuna chiave né password.

1. Copi l’indirizzo

   Nell’app apra Profilo → Connessioni AI e copi l’indirizzo con il pulsante Copia. È https://mcp.micali.online — l’indirizzo per intero, senza nulla dopo.

2. Lo aggiunga come connettore personalizzato

   In Claude o ChatGPT, apra le impostazioni dei connettori e aggiunga un nuovo connettore personalizzato, incollando quell’indirizzo come suo URL. Non serve altro — nessuna chiave API, nessun client id, nulla da registrare prima con noi. Qualsiasi altra cosa che parli MCP si collega allo stesso modo: Claude Code, Codex, Cursor.

3. Scelga responsabile o ospite, poi effettui l’accesso

   Si apre la nostra pagina di accesso. Scelga Responsabile per lavorare su un account che gestisce, oppure Ospite per vedere le sue prenotazioni. Digiti l’indirizzo email che usa già in Micali.online e inserisca il codice a 6 cifre che arriva. È lo stesso accesso dell’app: l’assistente non vede mai il suo codice, e lei non gli consegna mai una password.

4. Chieda qualcosa

   Il connettore compare nell’elenco degli strumenti dell’assistente ed è pronto. Una buona prima domanda è una domanda banale: “cosa ho questa settimana, e chi non ha ancora pagato?”

Cosa può chiedere come responsabile

All'assistente vengono assegnati trentasette strumenti e sceglie da sé tra loro, quindi non ci sono comandi da imparare. Ciò che vale la pena conoscere è il quadro generale di ciò a cui può accedere:

• Eventi e date — l’elenco, con quanto è piena ciascuna data, e l’intera configurazione di un evento: capacità, scadenze, pagamento, conferma.
• Prenotazioni — chi è iscritto a una data, con i contatti e lo stato confermato / pagato / presente. Può essere ristretto a una sola data, o solo a quelle non pagate o non confermate.
• Lista d’attesa — chi è in coda per un posto libero, a partire da chi aspetta da più tempo.
• Visitatori — li cerca per nome, email o telefono, e poi il profilo di una persona con i suoi abbonamenti e le prenotazioni recenti.
• Piani di abbonamento — cosa vende, a che prezzo, con quale limite, e quante persone ne possiedono uno in questo momento.
• Servizi e appuntamenti — cosa offre, e chi ha un appuntamento prenotato in un determinato periodo.
• Sale — le sale e chi può prenotarle, le prenotazioni in un periodo e quelle in attesa di conferma, le etichette di accesso e le persone che le possiedono, e le richieste di accesso. Può anche configurare una sala, prenotarla per qualcuno una volta o ripetutamente, confermare, rifiutare, spostare o annullare una prenotazione, assegnare un'etichetta a qualcuno con un invito, e approvare una richiesta.
• Moduli di prenotazione — le domande aggiuntive a cui rispondono i visitatori, campo per campo, e la creazione o riscrittura di uno a partire da una descrizione.
• Questionari di soddisfazione e i loro risultati — il sondaggio inviato dopo un evento o un appuntamento, il punteggio per ciascuna domanda, e ogni singola risposta con chi l’ha data e di cosa parlava.
• Prenotazioni in attesa di conferma — visitatori che hanno compilato il modulo ma non hanno mai cliccato sul link nella loro email, e la conferma di una per loro conto.
• Le persone che gestiscono l’account — chi sono e quale ruolo ricoprono, invitare qualcuno, cambiare un ruolo, rimuoverlo.
• La configurazione dell’account stessa — nome, contatti, indirizzo, fuso orario, lingua, formati, sottodominio di prenotazione, link social.
• Cambiare lo stato di una prenotazione — confermata, pagata, presente.
• Annullare una prenotazione per conto di un visitatore.
• Creare e modificare ciò che offre — eventi e le loro date, servizi, piani di abbonamento, moduli, questionari. Non solo leggere la configurazione, ma anche scriverla: “organizzi un corso per principianti, il lunedì alle sei per otto settimane, dodici posti” è un’unica richiesta.

Ventidue dei trentasette si limitano a leggere; quindici possono cambiare qualcosa. La distinzione conta perché il suo assistente le chiede conferma prima di eseguire qualsiasi cosa del secondo gruppo, e non chiede mai nulla per il primo — così le domande restano rapide e i cambiamenti restano ponderati.

In pratica risponde a domande come “quanti posti sono liberi la prossima settimana?”, “le restano visite sull’abbonamento?”, “chi ha saltato la lezione di venerdì scorso?”, “segna come pagato il sabato di Pietro”, “aggiungi altre tre date al corso del martedì”, “cosa ha detto la gente nei questionari il mese scorso?”. Trova da solo l’account, l’evento e la prenotazione — non deve mai indicare un identificativo.

Cosa può chiedere un visitatore

I visitatori si collegano esattamente allo stesso modo, scegliendo Ospite nella pagina di accesso, e ottengono cinque strumenti propri:

• le organizzazioni presso cui sono registrati,
• le proprie prenotazioni — eventi, appuntamenti e prenotazioni di sale, quelle future per impostazione predefinita,
• i propri abbonamenti, con le visite utilizzate e quelle rimanenti,
• una ricerca di date prenotabili, incluso quanti posti sono liberi,
• annullare la propria prenotazione — una prenotazione di evento rispettando la scadenza impostata dall'organizzatore, una prenotazione di sala in qualsiasi momento prima che inizi.

Come disconnettersi

Un accesso che non si può ritirare con un solo pulsante non è un accesso che valga la pena concedere. Ogni connessione è elencata sul suo profilo con il giorno in cui è stata creata e l’ultima volta che è stata usata.

1. Apra l’elenco

   Profilo → Connessioni AI, lo stesso posto dov’è l’indirizzo. I visitatori hanno la stessa sezione sul proprio profilo.

2. Prema Disconnetti

   Il pulsante Disconnetti accanto all’assistente che vuole tagliare fuori, poi confermi nella finestra di dialogo.

3. Sparisce immediatamente

   Quel connettore perde l’accesso all’istante. Tutto il resto resta intatto — l’app nel suo browser rimane connessa, così come qualsiasi altro assistente che ha collegato. Può aggiungere di nuovo lo stesso in seguito; basta che ripassi dall’accesso.

Una connessione che dimentica termina da sola. Il token di accesso dura cinque ore e l’assistente lo rinnova silenziosamente, ma il rinnovo si interrompe dopo 90 giorni.

Cosa l’assistente deliberatamente non può fare

Permettere a un’AI di raggiungere i dati dei visitatori è una decisione che merita limiti visibili. Questi sono i nostri.

• Non vede mai più di quanto veda lei. Ogni singola chiamata verifica di nuovo che lei amministri davvero quell’account. Non esiste un “account attualmente aperto” su cui possa fare affidamento, e quindi nessun modo di convincerlo ad accedere ai dati di qualcun altro.
• I membri del team sono disattivati per ora. Un membro del team vede solo gli eventi e i servizi a cui è assegnato, e quel limite andrebbe ricostruito separatamente all’interno di ciascuno dei ventotto strumenti. Finché non sarà integrato, il connettore rifiuta il suo accesso con un motivo chiaro, invece di fornire una visione parzialmente corretta.
• Tutto ciò che non può essere annullato è dichiarato distruttivo. Il protocollo permette a ciascuno strumento di dichiarare se si limita a leggere e se il suo effetto può essere annullato, e Claude e ChatGPT le chiedono conferma prima di eseguire qualsiasi cosa del secondo gruppo. Annullare una prenotazione è contrassegnato come distruttivo — elimina la riga, invia un messaggio al visitatore e offre il posto liberato alla prima persona in lista d’attesa — e lo stesso vale per eliminare un evento, un servizio, un piano, un modulo o un questionario, e rimuovere qualcuno dall’account. Questi strumenti istruiscono inoltre l’assistente a ripeterle a parole cosa sta per scomparire, e ad attendere un sì esplicito.
• Obbedisce alle stesse regole a cui obbedisce lei. Gli strumenti che cambiano qualcosa non portano una propria versione delle regole — eseguono esattamente lo stesso codice che l’app esegue quando lei clicca sul pulsante. Così un amministratore che non è amministratore root non può rinominare l’attività nemmeno tramite l’assistente, nessuno può rimuovere il proprio accesso, eliminare un evento continua a scrivere a tutti quelli prenotati su di esso, e un nuovo responsabile riceve comunque la normale email di invito.
• Non vediamo mai la sua conversazione. L’assistente funziona con il suo abbonamento e parla direttamente con lei. Dal nostro lato vediamo solo le singole chiamate agli strumenti che arrivano — la stessa cosa che vedremmo se stesse facendo clic nell’app. Il testo delle sue domande e delle risposte non ci raggiunge mai.

Pubblico vs. Attivo — cosa significa ogni indicatore

Eventi, servizi e abbonamenti condividono due interruttori on/off. Sembrano simili ma rispondono a due domande diverse.

Combinazioni e cosa significano

Webhook

I webhook permettono a Micali.online di notificare i suoi sistemi nel momento esatto in cui accade qualcosa all’interno di un account — un nuovo visitatore, una prenotazione, un pagamento di abbonamento. Configuri uno o più URL di ascolto per account, scelga gli eventi che le interessano e Micali.online invierà un payload JSON a ciascun URL ogni volta che si attivano. Perfetto per sincronizzare le prenotazioni con un CRM, attivare automazioni a valle o costruire dashboard sui dati delle sue prenotazioni.

Chi può configurarli

Solo i root admin possono creare, modificare ed eliminare i listener dei webhook. Gli admin e i membri del team non possono vederli né modificarli. I webhook si trovano insieme alle altre integrazioni — apra Connettori → Webhook per gestirli.

Eventi a cui può iscriversi

Ogni listener è collegato a un singolo tipo di evento. Aggiunga più listener — anche puntando allo stesso URL — per ricevere più di un tipo di evento. Il catalogo degli eventi attualmente emessi è:

• visitor.created — un nuovo visitatore si è registrato nell’account.
• visitor.updated — un profilo visitatore esistente è stato aggiornato.
• event_booking.created — un visitatore ha prenotato uno slot di evento.
• event_booking.confirmed — una prenotazione di evento è stata confermata (manualmente o automaticamente).
• event_booking.cancelled — una prenotazione di evento è stata annullata.
• service_booking.created — un visitatore ha prenotato uno slot di servizio.
• service_booking.confirmed — una prenotazione di servizio è stata confermata.
• service_booking.cancelled — una prenotazione di servizio è stata annullata.
• membership.assigned — è stato assegnato un abbonamento a un visitatore.
• membership.paid — un abbonamento del visitatore è stato segnato come pagato.
• membership.ended — un abbonamento del visitatore ha raggiunto la sua data di fine.

Cosa viene inviato

Ogni consegna è un singolo POST HTTP al suo URL con un corpo JSON. I seguenti header accompagnano sempre la richiesta:

• Content-Type: application/json — il corpo è sempre codificato in JSON.
• User-Agent: micali-webhooks/1.0 — identifica il mittente.
• X-Micali-Event: <event_type> — ripete il tipo di evento così può instradare senza analizzare il corpo.
• Authorization — presente solo quando configura l’autenticazione sul listener (vedere sotto).

Struttura del payload

Tutti i payload condividono la stessa busta:

• event — il tipo di evento (stesso valore dell’header X-Micali-Event).
• occurred_at — timestamp ISO-8601 di quando è stato eseguito il trigger.
• resource — il tipo di oggetto all’interno di data: event_booking, service_booking o visitor_membership.
• data — uno snapshot della risorsa, incluso il suo ID pubblico, i flag di stato attuali e i contatti del visitatore (email, nome e cognome, telefono). Le prenotazioni di eventi e servizi includono anche il blocco evento o servizio/prestazione collegato; i payload degli abbonamenti includono il nome dell’abbonamento e l’ID pubblico.

Identifichi gli oggetti tra le diverse consegne tramite il loro public_id — è l’identificatore stabile e condivisibile che usiamo ovunque nella piattaforma.

Autenticazione

Scelga uno schema di autenticazione in modo che il suo ricevitore possa verificare che la richiesta provenga da Micali.online:

• Nessuna — non viene inviato alcun header Authorization. Da usare solo quando il suo endpoint è già protetto in altro modo (URL firmato, lista di IP consentiti, rete privata).
• Basic — nome utente e password vengono inviati come header standard Authorization: Basic ....
• Token Bearer — il token che fornisce viene inviato come Authorization: Bearer <token>. Memorizzato cifrato a riposo e mai restituito dall’API una volta salvato.

Consegna e tentativi

La consegna è asincrona e passa attraverso la coda dei job in background della piattaforma. Se il ricevitore restituisce uno stato non-2xx (o se la richiesta fallisce del tutto), il job riprova con backoff esponenziale — partendo da 60 secondi, raddoppiando ogni volta e con un limite massimo di un’ora tra i tentativi. Dopo dieci tentativi falliti la consegna viene segnata come fallita e scartata. I listener che vengono disabilitati o eliminati tra il trigger e la consegna effettiva vengono saltati silenziosamente.

Per iniziare

Il modo più rapido per passare da un account vuoto a una pagina prenotabile è lasciare che sia il colloquio di configurazione a costruirla per lei.

Il colloquio di configurazione

A un amministratore root di un nuovo account viene proposto un colloquio che fa domande sull’attività in un linguaggio semplice — cosa offre, se le persone vengono in gruppo a un orario fisso o prenotano un proprio orario, quanto durano le cose, quando è aperto, chi lavora con lei — e poi crea l’intera configurazione in un’unica volta: i servizi e le loro prestazioni, gli orari di apertura, gli eventi e le loro date, il nome e la categoria della sua attività, il suo sottodominio pubblico, il suo indirizzo sulla mappa, se le prenotazioni devono essere approvate, quali promemoria vengono inviati e gli inviti per il suo staff.

Non deve finirlo in un’unica sessione. Le sue risposte vengono salvate man mano, quindi chiudere la scheda e tornare più tardi riprende da dove aveva interrotto. Può anche ignorare del tutto il colloquio e costruire tutto a mano — viene proposto una volta, non imposto.

Cosa controllare in seguito

Il colloquio lascia tutto attivato e pronto, ma vale la pena controllare due cose prima di inviare il link a qualcuno: apra il suo sottodominio pubblico in una finestra privata del browser per vedere esattamente cosa vede un visitatore, e scorra i modelli di messaggio che ha creato affinché il tono sembri il suo.

Se ha iniziato con una demo

La demo che può aprire dal sito senza registrarsi è un account reale e funzionante con una vita breve — viene eliminato non appena scade, insieme a tutto ciò che vi ha configurato. Confermi il suo indirizzo email e diventerà invece un account normale, mantenendo tutto ciò che ha già costruito. Se ha passato una serata a organizzare la sua settimana in una demo, lo faccia prima di chiudere la scheda.

Accesso

Nessuno in Micali.online ha una password. Tutti accedono con un codice inviato alla propria email, e i responsabili possono aggiungere un modo più rapido in più.

Responsabili

Inserisca il suo indirizzo email e arriverà un breve codice via email. Lo digiti e sarà connesso per la sessione. Se si stava dirigendo verso qualcosa di specifico — un link da una notifica, ad esempio — arriverà a quella pagina anziché alla dashboard.

Il PIN a quattro cifre

Una volta effettuato l’accesso, può impostare un PIN per il browser che sta usando. Da quel momento quel browser chiederà solo le quattro cifre invece del codice via email, per 30 giorni. È specifico per browser: impostare un PIN sul suo telefono non ha alcun effetto sul suo portatile.

Tre tentativi sbagliati e il browser smette di essere considerato attendibile — torna a chiedere un codice via email, e il solo PIN non basterà più per entrare. I 30 giorni si contano da quando lo ha impostato e non si prolungano usandolo.

Aggiungerla alla schermata Home

Sia l’app dei responsabili sia la pagina di prenotazione dei suoi visitatori possono essere aggiunte alla schermata Home di un telefono, dove si aprono come un’app. Questo è anche ciò che rende possibili le notifiche push su iPhone — lì, le notifiche funzionano solo una volta che la pagina è stata aggiunta alla schermata Home.

Visitatori

I visitatori accedono allo stesso modo, con un codice alla propria email, sul suo sottodominio. Un visitatore che non ha mai prenotato prima viene semplicemente creato al momento la prima volta che accede.

La dashboard

La prima schermata dopo l’accesso, in tre visualizzazioni. Le schede ricordano quale ha scelto, quindi scelga quella più adatta al suo modo di lavorare.

• Calendario — un’intera settimana disposta come una griglia, con ogni turno di evento e servizio al suo posto e quelli sovrapposti affiancati. Può scorrere le settimane e rendere le righe più alte o più basse per adattarsi a una giornata fitta.
• Agenda — un semplice elenco di ciò che sta arrivando, un turno dopo l’altro. È quella che funziona meglio su un telefono.
• Panoramica — schede riepilogative: cosa viene dopo, cosa richiede conferma, risposte recenti ai moduli.

Agire direttamente dal calendario

Cliccare su un turno nel calendario fa più che aprirlo. Su un turno con disponibilità può prenotarci subito un visitatore; su uno vuoto può condividerlo, aprire il suo elenco visitatori, oppure rimuovere del tutto quell’orario se non lo sta gestendo.

Gestire le prenotazioni

Tutto ciò che accade dopo che un visitatore si è iscritto: aggiungere persone lei stesso, approvarle, spostarle e registrare chi si è effettivamente presentato.

Aggiungere qualcuno lei stesso

Non tutte le prenotazioni arrivano tramite la pagina pubblica — alcune persone telefonano, oppure la incontrano di persona. Le aggiunga tramite indirizzo email: se quell’indirizzo appartiene già a uno dei suoi visitatori viene collegato a lui, e se è nuovo il visitatore viene creato. Può impostare quanti posti occupano, aggiungere i loro amici e compilare le risposte del modulo per loro conto.

Approvare e rifiutare

Se l’evento o la prestazione non confermano automaticamente, le nuove prenotazioni attendono lei. Approvarne una invia il messaggio di conferma; rifiutarla invia il messaggio di rifiuto, quando la prestazione ne ha uno impostato. Una prenotazione fatta da qualcuno senza prenotazioni precedenti può inviare un messaggio diverso, più caloroso, rispetto a quello ricevuto dai suoi clienti abituali.

Spostare una prenotazione

I piani cambiano, e un visitatore non dovrebbe dover annullare e riprenotare. Una prenotazione di evento può essere spostata su un’altra data dello stesso evento o su un evento completamente diverso; una prenotazione di servizio può essere spostata su un altro turno o un’altra prestazione. La capacità nella destinazione viene verificata di nuovo nel momento dello spostamento, e il posto che si libera va a chi è primo in lista d’attesa.

Contrassegnare chi si è presentato

Una volta che una data è iniziata, ogni prenotazione confermata pone una domanda: questa persona è venuta? Rispondere non è solo tenere un registro. Presente è ciò che spende un credito da un abbonamento, a meno che il piano o l’evento siano impostati per conteggiare la prenotazione indipendentemente dalla presenza; Non si è presentato restituisce il posto e il credito. Finché non risponde, il credito resta in sospeso e il conteggio residuo del visitatore non cambia.

Ci sono diversi posti in cui rispondere — da un’intera classe con un clic a una singola prenotazione, oppure dal lato dell’abbonamento:

• L’elenco delle prenotazioni. Apra Visitatori → Eventi, scelga l’evento e guardi le prenotazioni confermate di una data passata (l’email di promemoria porta direttamente lì). Una colonna Presenza compare non appena la data è iniziata — non c’è per le date future, perché non c’è ancora nulla a cui rispondere. Ogni riga ha un segno di spunta verde per presente e una croce rossa per non si è presentato; clicchi sulla risposta accesa per annullarla. Presente Non si è presentato
• Tutti presenti. L’intestazione di ogni data ha un pulsante Tutti presenti. Compila solo le prenotazioni che non hanno ancora una risposta, quindi chi ha già contrassegnato come assente resta assente. Tutti presenti
• Una selezione. Selezioni le righe che desidera e usi Segna selezionati come presenti o Segna selezionati come assenti — comodo quando la maggior parte della classe è venuta e solo alcuni no.
• Dal telefono. Nel pannello, la visualizzazione Agenda mostra una piccola etichetta Presenza su ogni evento che è iniziato — ambra con un numero finché mancano risposte, verde quando tutti hanno una risposta. La tocchi e si apre una finestra con l’elenco delle prenotazioni confermate, con gli stessi pulsanti presente / non si è presentato e una scorciatoia Tutti presenti, così può fare l’appello mentre le persone sono ancora in sala.
• Una singola prenotazione. Apra la prenotazione dall’elenco (l’icona a matita) e usi l’interruttore Era presente nella sua pagina di dettaglio, accanto alle risposte del modulo del visitatore e alle note.
• Dall’abbonamento. Apra Piani prepagati, scelga il piano, poi il membro — il numero nella colonna utilizzo apre la sua pagina Utilizzo iscrizione. Ogni prenotazione accettata in attesa di conferma della presenza è elencata lì con una coppia Conferma presenza / Non si è presentato, e l’elenco membri mostra quante prenotazioni di ciascun membro sono ancora in attesa. È la stessa risposta di ovunque altro, solo raggruppata per membro, il luogo naturale quando verifica quanti crediti restano a qualcuno. Conferma presenza Non si è presentato

Gli amministratori possono rispondere per qualsiasi evento. Un membro del team può rispondere solo per gli eventi di cui è responsabile — ovunque altro i pulsanti sono disattivati.

Non deve ricordarselo lei. Quando un evento è terminato e ci sono ancora prenotazioni in attesa di conferma della presenza, Micali.online invia un’email al responsabile di quella data con un link diretto all’elenco giusto — e solo per le prenotazioni in cui confermare cambia effettivamente qualcosa.

Pagamento

Le prenotazioni portano un indicatore di pagato che lei stesso attiva; Micali.online non incassa il denaro. Ciò che fa è sollecitarlo: un evento può inviare un promemoria di pagamento una o due volte prima della data, e solo ai visitatori confermati, ancora non paganti e non coperti da un abbonamento.

Portare l’elenco altrove

Le prenotazioni si esportano in un file CSV, per gli eventi e per i servizi, così può consegnare un registro a chi ne ha bisogno, sommare un mese in un foglio di calcolo, o conservare una propria copia. È l’elenco così come lo ha filtrato, non un report fisso.

In attesa di conferma

Prenotazioni che un visitatore ha compilato sulle sue pagine pubbliche senza aver effettuato l’accesso. Nulla è riservato finché non apre il link che gli abbiamo inviato via email — questa pagina è dove vede cosa è ancora in sospeso, quanta parte di esso non arriva mai a destinazione, e dove può intervenire quando il visitatore non può.

Come una prenotazione finisce qui

Un visitatore che non ha effettuato l’accesso compila tutto quanto — il turno, i posti, i propri contatti, qualsiasi modulo lei abbia allegato — e non gli viene chiesto prima alcun codice. Inviarlo mette la prenotazione in sospeso e gli invia un link di conferma monouso. Finché non apre quel link nulla esiste nel suo account: nessun visitatore, nessuna prenotazione, nessuna risposta al modulo, e nessun posto viene trattenuto. È voluto — chi digita l’indirizzo di uno sconosciuto non potrà mai riempire il suo evento.

Il link dura 24 ore, oppure fino all’inizio del turno, a seconda di cosa avviene prima. Aprirlo dimostra l’indirizzo, effettua l’accesso del visitatore e crea la prenotazione secondo le regole ordinarie — capacità, lista d’attesa, scadenza di iscrizione, la sua approvazione — così ottiene la stessa risposta che avrebbe ottenuto prenotando dopo aver effettuato l’accesso. Se possiede un abbonamento che l’evento accetta, è in quel momento che gli viene chiesto quale utilizzare.

Un visitatore che ha già effettuato l’accesso non passa mai da qui. Prenota direttamente, e non c’è nulla che debba confermare.

Nessuno deve nemmeno aspettare l’email. Effettuando l’accesso alla sua pagina di prenotazione, compare una scheda In attesa della tua conferma che elenca tutto ciò che è in sospeso su quell’indirizzo, ciascuno con un pulsante Conferma. Confermare lì e aprire comunque l’email in seguito non causa alcun problema — il link si limita a segnalare che è già confermato.

Cosa mostra la pagina

Apra In attesa di conferma dal menu principale. In alto ci sono quattro numeri, e i primi tre sono anche filtri:

• In attesa di conferma — il link è ancora valido e il visitatore può ancora utilizzarlo.
• Mai confermato — il link è scaduto inutilizzato. È il numero da tenere d’occhio: rappresenta l’interesse che aveva ma non è riuscito a trattenere.
• Confermato — sono diventate prenotazioni reali.
• Tasso di conferma — la percentuale di link che sono stati utilizzati. Vengono conteggiati solo i link conclusi, così quelli ancora in sospeso non lo abbassano per tutto il giorno.

Sotto di essi si trova un grafico delle prenotazioni al giorno: ogni prenotazione presa dal suo account, con questo imbuto disegnato al suo interno. Una prenotazione fatta da un visitatore che ha effettuato l’accesso, o una che ha aggiunto lei stesso, non passa mai per l’imbuto, quindi le due linee interne sono sempre una porzione di quella più alta. Il filtro per tipo restringe entrambe; la ricerca testuale restringe solo la tabella, così cercare una persona non ridisegna il suo volume come se fosse tutto suo.

Solo amministratori e amministratori root — lo stesso livello di accesso del suo elenco visitatori, perché finché il link non viene aperto questi contatti non è dimostrato che appartengano a chi li ha digitati.

Confermare per un visitatore

L’email è finita nello spam, il link è scaduto senza essere letto, oppure hanno telefonato direttamente. Conferma per il visitatore si trova su ogni riga non ancora confermata — comprese quelle scadute, che è per lo più il motivo per cui il pulsante è lì — e la prenota esattamente come avrebbe fatto il link. Le regole decidono comunque l’esito: se l’evento è al completo il visitatore va in lista d’attesa, se richiede approvazione finisce tra le sue approvazioni, e se la scadenza è passata non viene prenotato nulla e le viene detto il motivo. Conferma per il visitatore

C’è una differenza rispetto al clic del visitatore stesso: nessun piano prepagato viene utilizzato, perché a nessuno è stato chiesto quale usare. Lo colleghi alla prenotazione in seguito, se deve essere conteggiata su un piano.

Ogni prenotazione creata in questo modo registra l’amministratore che l’ha confermata, e la riga ne mostra il nome.

Sapere che è successo

Quando una prenotazione resta in sospeso, arriva subito una notifica nella campanella — la vedono anche i membri del team, anche se non possono aprire questa pagina. Rimanda all’evento o al servizio a cui il visitatore puntava, perché non c’è ancora nessuna prenotazione a cui rimandare.

Condividere i suoi eventi e servizi

Ogni evento, servizio e piano prepagato ha il proprio indirizzo pubblico, così come la sua pagina di prenotazione nel suo insieme. Lo condivida come link o lo stampi come codice QR — chiunque lo apra arriva direttamente alla pagina dove può prenotare.

L’indirizzo di tutto ciò che offre

La sua pagina di prenotazione si trova sul sottodominio del suo account — il nome che ha scelto nella pagina Account, seguito da .micali.online. Quell’unico indirizzo è dove i visitatori sfogliano tutto ciò che ha reso pubblico:

• https://yourname.micali.online — tutti gli eventi futuri.
• https://yourname.micali.online/services — tutti i servizi e le loro prestazioni.
• https://yourname.micali.online/memberships — i piani prepagati che i visitatori possono acquistare.

I visitatori passano da uno all’altro con le schede in alto nella pagina, e una scheda compare solo quando c’è qualcosa di pubblico dietro di essa. Questo è l’indirizzo da mettere sul suo sito web, nella sua firma email o sul cartello all’ingresso — tutto ciò che pubblicherà in seguito comparirà lì senza che il link cambi.

Un evento, servizio o piano prepagato

Gli elenchi Eventi, Servizi e Piani prepagati mostrano una riga di piccoli pulsanti all’estremità destra di ogni riga. Il pulsante di condivisione è quello con tre puntini collegati:

Cliccandolo si apre una piccola finestra con entrambe le cose che potrebbero servirle:

• Il link — clicchi una volta per selezionarlo interamente, oppure prema Copia per copiarlo negli appunti. Ha un aspetto simile a https://yourname.micali.online/events/AbCdEfGhIj.
• Il codice QR per lo stesso link, con Scarica codice QR per salvarlo come immagine PNG che può inserire in un poster, un volantino o una diapositiva.

Gli eventi modello non hanno un pulsante di condivisione — un modello non viene mai mostrato ai visitatori. Condivida invece gli eventi reali che crea a partire da esso.

Cosa riceve il visitatore

Il link apre direttamente quell’evento, quel servizio o quel piano sulla sua pagina di prenotazione, con le sue date o prestazioni pronte da scegliere — non c’è nulla da cercare. Resta raggiungibile finché l’elemento è sia pubblico che attivo; disattivandone uno dei due, il link non ha più nulla da prenotare finché non lo riattiva.

Condividere una data e un orario

A volte vuole inviare a qualcuno un turno specifico — “giovedì alle sei” — anziché tutto il suo calendario, sperando che scelga quello giusto.

Ogni punto in cui può condividere un singolo turno le offre sia un link sia un codice QR, pronti da stampare o inviare:

• Nel calendario di un evento, accanto a qualsiasi data futura.
• Nella schermata visitatori, dove può scegliere qualsiasi data futura di un evento — inclusa una che nessuno ha ancora prenotato.
• Su un servizio, dove sceglie la prestazione, il giorno e l’orario dalla stessa disponibilità che vedono i suoi visitatori.
• Sul calendario e sull’agenda, direttamente dal turno stesso.

Cosa riceve il visitatore

Il link apre la sua pagina di prenotazione già posizionata su quel turno esatto, con le altre date fuori dai piedi, così non c’è nulla da scegliere e nulla da sbagliare. Se il turno è al completo, gli viene proposta invece la lista d’attesa.

Un pulsante di prenotazione sul suo sito web

Metta un pulsante di prenotazione sul suo sito web. Fluttua in un angolo di ogni pagina, e un clic permette ai visitatori di prenotare i suoi eventi e servizi direttamente lì — oppure li porta alla sua pagina di prenotazione.

Configurarlo

Apra Widget per il sito web dal menu principale (solo amministratori root). Scelga il testo del pulsante, il suo colore, l’angolo in cui si trova, cosa succede al clic e la lingua della finestra di prenotazione, lo provi nell’anteprima e copi il codice.

Incolli il codice nel suo sito web appena prima del tag di chiusura </body>, in ogni pagina in cui il pulsante deve comparire. La maggior parte dei costruttori di siti web (WordPress, Wix, Webflow, Squarespace…) ha uno spazio per il codice personalizzato o un blocco HTML.

Il suo pulsante. Anche un link o un pulsante qualsiasi del suo sito web con l’attributo data-micali-open apre la finestra di prenotazione, e uno sviluppatore può richiamare MicaliWidget.open(), MicaliWidget.close() o MicaliWidget.toggle(). Perché funzioni, il codice del widget deve essere presente nella pagina. Se preferisce mostrare solo i suoi pulsanti, attivi Nascondi il pulsante flottante: il codice non disegna più alcun pulsante nell’angolo, e la finestra di prenotazione si apre solo dai suoi pulsanti.

Un pulsante dopo la prenotazione. Nella pagina Widget per il sito web può aggiungere un pulsante che la finestra di prenotazione mostra quando un visitatore invia una prenotazione — con il Suo testo, colore e JavaScript. Non viene eseguito nulla automaticamente: il Suo codice viene eseguito sul Suo sito web solo quando il visitatore clicca sul pulsante (per esempio per aprire il Suo pagamento), e la finestra si chiude. Per gli sviluppatori, la pagina riceve anche gli eventi micali:booked e micali:action con kind, id, name e l’orario di inizio della prenotazione — mai i dati personali del visitatore. Con la pagina di prenotazione al posto della finestra, la prenotazione avviene su Micali.online e il Suo sito web non la vede.

Cosa succede al clic

• Finestra di prenotazione — si apre una finestra sulla sua pagina con un calendario: eventi per data, servizi per prestazione, giorno e orario. Il visitatore inserisce i propri dati e il modulo di prenotazione, e conferma.
• Pagina di prenotazione — apre la sua pagina di prenotazione di Micali.online in una nuova scheda, con tutto il suo contenuto, inclusi abbonamenti e sale.

Cosa riceve il visitatore

All’interno della finestra i visitatori non effettuano l’accesso, quindi una prenotazione fatta lì funziona come una fatta sulla sua pagina di prenotazione senza aver effettuato l’accesso: diventa valida quando aprono il link che gli inviamo via email, e scelgono eventuali abbonamenti in quella pagina di conferma. Fino ad allora resta in attesa sotto In attesa di conferma.

I suoi visitatori

Tutti coloro che hanno mai prenotato con lei, più chiunque abbia aggiunto, in un unico elenco che può cercare, in cui importare e a cui scrivere.

Importare un elenco che ha già

Carichi un CSV e indichi quale colonna è quale — a Micali.online non importa l’ordine delle colonne o come le chiama il file. Gli indirizzi già presenti nel suo account vengono collegati anziché riscritti, quindi importare un elenco che si sovrappone ai suoi visitatori esistenti non sovrascriverà i dati di nessuno.

L’importazione viene eseguita in background e riporta cosa ha fatto, così un file di grandi dimensioni non blocca lo schermo. C’è un limite di 500 nuovi visitatori aggiunti al giorno, ed è voluto: è abbastanza alto per un elenco clienti reale e abbastanza basso da evitare che un caricamento sbagliato sfugga di mano. Tutto ciò che supera il limite viene segnalato anziché scartato, e reimportare lo stesso file il giorno successivo lo recupera.

Liste di distribuzione

Una lista di distribuzione è un gruppo salvato di visitatori a cui può scrivere più e più volte. La compili scegliendo le persone a mano, oppure scegliendo eventi e servizi e un periodo — tutti coloro che hanno prenotato quello nelle ultime due settimane, nell’ultimo anno, o sempre.

Scrivere loro

Può scrivere a una lista salvata, a tutti quelli di un evento, o a tutto il suo account. Ogni messaggio viene inviato singolarmente, così un indirizzo sbagliato non blocca gli altri, e chiunque non abbia un indirizzo email viene saltato — il conteggio di questi viene mostrato prima che inizi a scrivere, non dopo l’invio.

La lista nera

Ci sono persone che meritano una seconda occhiata prima di farle entrare — chi non si presenta mai, chi prenota sei posti e ne porta uno. Aggiunga il loro indirizzo email alla lista nera, con una nota personale sul motivo.

La lista è associata all’indirizzo email, non alla scheda della persona: eliminare il visitatore e farlo iscrivere di nuovo con lo stesso indirizzo non cancella quindi la voce dalla lista.

Messaggi con i visitatori

Una conversazione è una discussione tra il suo team e un visitatore. Può iniziarla l’uno o l’altro, e tutto ciò che viene detto resta legato a quella persona invece di essere disperso tra chi ha risposto alla sua email.

Come inizia una discussione

Un visitatore può scriverle dalla propria pagina di prenotazione — riguardo a una prenotazione, o senza un motivo particolare. Può anche aprire lei stesso una discussione dalla sua riga nell’elenco visitatori, che è il modo giusto per fare una domanda a una sola persona senza trasformarla in un’email che ricevono tutti.

Chi risponde

Chiunque nell’account può leggere e rispondere, membri del team inclusi. Una conversazione può essere assegnata a una persona specifica, ed è presente un filtro mie che mostra ciò che le è stato assegnato o a cui ha già risposto — così, in una giornata intensa, è meno probabile che due persone rispondano due volte allo stesso visitatore.

Mantenere l’elenco breve

Le discussioni possono essere chiuse una volta gestite e riaperte se il visitatore scrive di nuovo, il che mantiene l’elenco limitato a ciò che richiede ancora l’intervento di una persona.

Questionari di soddisfazione

Chieda a chi è venuto cosa ne ha pensato, automaticamente, una volta che l’evento o l’appuntamento sono alle spalle.

Crearne uno

Scriva le domande, alleghi il questionario a un evento o a un servizio, e indichi quanto tempo dopo la fine del turno deve essere inviato — subito, la mattina successiva, qualche giorno dopo, come preferisce. Gli dia un nome per il suo uso personale; i visitatori non lo vedono mai, solo le domande.

Cosa riceve il visitatore

Un’email con la prima domanda. Rispondere a quella apre il resto su una pagina a sé stante — senza accesso, senza password, nulla da ricordare. Meno chiede a qualcuno in quel momento, più risposte ottiene.

Una volta per prenotazione

A ogni prenotazione viene chiesto esattamente una volta, e l’invio viene registrato. A chi viene al suo corso del martedì ogni settimana non viene chiesto di valutarlo ogni settimana.

Leggere le risposte

Le risposte si raccolgono per questionario, così può leggerle insieme invece che un’email alla volta. Può anche inviarsi prima una copia di prova e vedere il tutto esattamente come lo vedrà un visitatore.

Ottenere assistenza

Per le domande a cui questa guida non risponde, o quando qualcosa nel suo account non sembra corretto.

Aprire un ticket

Amministratori e amministratori root possono aprire un ticket direttamente dall’app, il che è meglio di un’email perché arriva con il suo account già collegato — nessuno deve chiederle di quale attività si tratti, e possiamo esaminare la configurazione reale che sta descrivendo.

Come prosegue

Un ticket è una conversazione, non un modulo: le nostre risposte arrivano nella stessa discussione e viene avvisato via email, così l’intero scambio resta in un unico posto invece di frammentarsi in una catena di email.

Come creare un evento e pubblicarlo

Per amministratori root e amministratori. L’obiettivo: un visitatore può atterrare sulla sua pagina pubblica e prenotare un posto.

1. Apra la pagina Eventi.

   Acceda all’app, scelga l’account corretto nella barra superiore e apra Eventi dal menu principale.

2. (Facoltativo) Crei prima un modello.

   Se intende organizzare lo stesso tipo di evento ripetutamente, lo crei una volta come modello: capacità, modulo, messaggi e così via. I nuovi eventi classici potranno quindi ereditarne le impostazioni.

3. Crei un nuovo evento classico.

   Clicchi su Nuovo evento, gli dia un nome e una descrizione, imposti la capacità (numero massimo di partecipanti, se possono portare amici) e scelga il modulo di prenotazione.

4. Aggiunga una o più date dell’evento.

   Per ogni occorrenza imposti l’orario di inizio e, se necessario, la scadenza di iscrizione. Senza almeno una data futura l’evento non può essere prenotato.

5. Limiti agli abbonamenti (facoltativo).

   Se possono partecipare solo gli abbonati, aggiunga gli abbonamenti richiesti sotto Abbonamenti consentiti. Lasci vuoto per consentire a qualsiasi visitatore di prenotare.

6. Scelga i messaggi.

   Scelga i modelli per i promemoria di pagamento, le cancellazioni e il promemoria di presenza. Si assicuri che il connettore corrispondente (SMTP, SendGrid o Twilio) sia configurato a livello di account.

7. Attivi Attivo.

   Questo rende l’evento operativo all’interno dell’account. Non raggiungerà ancora i visitatori fino al passaggio successivo.

8. Attivi Pubblico.

   Ora l’evento appare sul suo sottodominio pubblico. Apra il sottodominio in una finestra privata del browser per verificare che tutto sia visualizzato correttamente.

Come creare un servizio o una prestazione e pubblicarlo

Per amministratori root e amministratori. L’obiettivo: un visitatore può scegliere una prestazione e prenotare un orario libero.

1. Apra la pagina Servizi.

   Dal menu dell’app, scelga Servizi. L’elenco mostra tutto ciò che appartiene all’account attivo.

2. Crei il servizio.

   Clicchi su Nuovo servizio, inserisca il nome, la descrizione, il luogo, l’indirizzo e il fuso orario. Il fuso orario è importante: tutte le finestre di disponibilità vengono interpretate in base a esso.

3. Aggiunga le prestazioni.

   Per ogni cosa che un visitatore può prenotare, crei una prestazione con un nome e una durata. Opzionalmente imposti un tempo di preparazione prima della prestazione e un tempo di pulizia dopo, in modo che il calendario non faccia doppie prenotazioni.

4. Imposti la disponibilità.

   Definisca le finestre temporali ricorrenti in cui sono consentite le prenotazioni (ad esempio, lun.–ven. 9:00–17:00). Solo gli orari all’interno di una finestra di disponibilità attiva possono essere prenotati.

5. Scelga il modulo di prenotazione (facoltativo).

   Se ha bisogno di informazioni dal visitatore al momento della prenotazione — telefono, allergie, note —, alleghi un modulo al servizio.

6. Attivi Attivo sul servizio e su ogni prestazione.

   Un servizio inattivo viene nascosto ovunque; una prestazione inattiva resta nel database ma non appare nel flusso di prenotazione.

7. Attivi Pubblico sul servizio.

   I visitatori ora vedono il servizio sul suo sottodominio pubblico, con le prestazioni disponibili e i prossimi orari liberi.

Come configurare una sala che le persone possano prenotare

Per amministratori root e amministratori. L'obiettivo: le persone che invita possono accedere e prenotare la sala.

1. Apra la pagina Sale.

   Dal menu dell'app, scelga Sale e clicchi su Nuova sala.

2. Descriva la sala.

   Inserisca il nome, la descrizione, dove si trova e quante persone può ospitare. Dopo il primo salvataggio può aggiungere foto; la prima è la copertina.

3. Imposti quando può essere prenotata.

   Aggiunga gli orari per ogni giorno della settimana, i minuti di preparazione e pulizia, e la griglia oraria.

4. Imposti le regole per i visitatori.

   Scelga la prenotazione più lunga, la pausa tra le prenotazioni di una stessa persona e con quanti giorni di anticipo si può prenotare. Lasci un campo vuoto per nessun limite.

5. Scelga chi può prenotare.

   Scelga una o più etichette (può crearne una direttamente lì), decida se le prenotazioni vengono confermate automaticamente, e scelga le persone responsabili e il calendario condiviso.

6. Inviti le persone.

   Su Sale → Accesso, incolli i loro indirizzi email, assegni loro l'etichetta e invii l'invito. Alle persone che prenotano già con lei può semplicemente assegnare l'etichetta.

7. Condivida il link.

   Copi il link della sala dall'elenco delle sale, oppure lasci che le persone trovino la sala nella scheda Sale della sua pagina di prenotazione. Attivi Visibile a tutti se anche le persone senza accesso devono vedere la sala.

Come creare un abbonamento e pubblicarlo

Per amministratori root e amministratori. L’obiettivo: un visitatore può acquistare un abbonamento e utilizzarlo per prenotare eventi.

1. Apra la pagina Abbonamenti.

   Dal menu dell’app, scelga Abbonamenti.

2. Crei l’abbonamento.

   Clicchi su Nuovo abbonamento, gli dia un nome e una breve descrizione che spieghi cosa ottiene il visitatore.

3. Imposti prezzo, valuta e limiti.

   Inserisca il prezzo (nell’unità monetaria più piccola), la valuta, il numero massimo di utilizzi e/o la durata in giorni. Lasciare un limite vuoto significa che è illimitato.

4. Definisca quando può essere acquistato.

   Imposti disponibile dal (quando appare sulla pagina pubblica) e opzionalmente disponibile fino al (quando scompare). Utile per offerte stagionali o a tempo limitato.

5. (Facoltativo) Lo colleghi agli eventi.

   Se l’abbonamento deve sbloccare eventi specifici, apra ogni evento e aggiunga l’abbonamento sotto Abbonamenti consentiti.

6. Attivi Attivo.

   L’abbonamento ora fa parte del suo account. Gli abbonamenti esistenti dei visitatori abituali continuano a funzionare anche quando questo è disattivato.

7. Attivi Pubblico.

   I visitatori vedono l’abbonamento sul suo sottodominio pubblico e possono acquistarlo. Confermi aprendo il sottodominio in una finestra privata.

Come creare un modello di messaggio

Per amministratori root e amministratori. I modelli risiedono a livello di account: li scriva una volta e li riutilizzi su qualsiasi evento, servizio o abbonamento.

1. Apra la pagina Modelli di messaggio.

   Dal menu dell’app, scelga Modelli di messaggio all’interno dell’account attivo.

2. (Facoltativo) Inizializzi i valori predefiniti.

   Se questo è un account nuovo, clicchi su Inizializza predefiniti per creare un modello iniziale per ogni slot supportato nella lingua dell’account. Può modificarne uno qualsiasi in seguito.

3. Crei un nuovo modello.

   Clicchi su Nuovo modello e gli dia un nome interno chiaro — ad esempio, “Lezione di yoga — promemoria di pagamento”. Il nome viene mostrato solo al suo personale.

4. Scriva la versione email.

   Compili l’oggetto e il corpo dell’email. Utilizzi segnaposto come %visitor_first_name% e %event_start_at% ovunque desideri valori personalizzati. Opzionalmente imposti un nome mittente.

5. Scriva la versione SMS (facoltativo).

   Se intende inviarlo anche come SMS, compili il corpo dell’SMS. Lo mantenga breve: i provider SMS addebitano per segmento.

6. Salvi il modello.

   Servono almeno il nome più un corpo email o SMS. Il modello ora appare nei menu a tendina di ogni modulo di evento, prestazione e abbonamento.

7. Alleghi il modello dove le serve.

   Apra l’evento, la prestazione di servizio o l’abbonamento pertinente e scelga il nuovo modello nello slot appropriato — ad esempio, Promemoria di presenza su un evento. Salvi e ha finito.