DOCUMENTAZIONE SULLA PIANIFICAZIONE
Prenotazione con calendario e lock di concorrenza
Come Crescelo prenota appuntamenti nella conversazione in chat, si sincronizza con i calendari esterni e previene le doppie prenotazioni da race condition.
1. Come funziona la verifica degli slot in tempo reale
Quando un visitatore del sito chiede di prenotare, Crescelo recupera dal database gli appuntamenti attivi di quell'assistente e calcola gli orari disponibili in base agli orari di apertura impostati (ad es. 9:00–17:00) e alla durata predefinita dello slot (ad es. 30 minuti).
2. Il lock mutex atomico di concorrenza
Se due visitatori fanno clic contemporaneamente sullo stesso slot delle 14:00, i bot tradizionali spesso prenotano entrambi. Crescelo usa acquireBookingLock(assistantId, date, timeSlot). La prima richiesta acquisisce un blocco, verifica che nel frattempo non sia stato scritto alcun conflitto, conferma la prenotazione e rilascia il blocco in sicurezza. Il secondo utente riceve subito la proposta del primo slot libero più vicino.
3. Conferme e il tuo feed del calendario
Una volta confermato un appuntamento:
- • Al cliente viene inviata un'e-mail di conferma con un link per riprogrammare o annullare in autonomia.
- • Il titolare dell'attività riceve una notifica via e-mail e nella dashboard.
- • La prenotazione compare nel tuo feed del calendario privato. Iscriviti al suo indirizzo in Google Calendar, Outlook o Apple Calendar per vedere lì le prenotazioni. Il feed è in sola lettura; la sincronizzazione bidirezionale è nella roadmap.
4. Riprogrammazione e annullamento in autonomia
Ogni e-mail di conferma include un'unica firma crittografica manageToken. I clienti possono annullare o scegliere una nuova data e ora da soli, senza telefonare al tuo ufficio, liberando subito lo slot annullato per altri visitatori.