Tymeslot è una piattaforma open source dedicata alla pianificazione degli appuntamenti e alla gestione delle prenotazioni online. Il progetto permette di creare pagine pubbliche attraverso le quali clienti, collaboratori e ospiti possono scegliere un orario disponibile, prenotare una riunione e ricevere automaticamente le informazioni necessarie per partecipare.
L’obiettivo è offrire un’alternativa a servizi come Calendly, mantenendo la possibilità di installare e amministrare il software sulla propria infrastruttura. Questa caratteristica rende Tymeslot particolarmente interessante per liberi professionisti, consulenti, piccole aziende, sviluppatori e organizzazioni che desiderano gestire gli appuntamenti senza affidare necessariamente l’intero servizio a una piattaforma esterna.
Il software è sviluppato utilizzando Elixir, Phoenix LiveView e PostgreSQL. Questa architettura consente di realizzare un’interfaccia web interattiva e di gestire le operazioni di prenotazione attraverso un’applicazione progettata per funzionare in modo continuativo.
Uno degli aspetti più interessanti è l’approccio integrato: Tymeslot non si limita a mostrare un calendario con gli orari disponibili, ma comprende sincronizzazione con servizi esterni, invio di email, promemoria, collegamenti per videoconferenze, notifiche e strumenti per automatizzare gli eventi.
La piattaforma può essere utilizzata in modalità self-hosted oppure attraverso il servizio cloud gestito dagli sviluppatori. Nel primo caso, l’amministratore mantiene il controllo sull’installazione e sui dati conservati sul proprio server; nel secondo, può utilizzare il servizio senza occuparsi direttamente della manutenzione dell’infrastruttura.
Calendari sincronizzati, prenotazioni automatiche e riunioni online
Il cuore di Tymeslot è il sistema di gestione della disponibilità. Gli utenti possono creare diversi calendari di lavoro, ciascuno con orari, pause, eccezioni per date specifiche, intervalli di sicurezza tra gli appuntamenti e limiti relativi all’anticipo minimo richiesto per una prenotazione.
Questa flessibilità consente, per esempio, a un consulente di offrire appuntamenti durante la settimana lavorativa e riservare alcune fasce orarie alle consulenze serali. Ogni tipologia di incontro può essere associata al calendario più appropriato, così da mostrare ai visitatori esclusivamente gli orari effettivamente prenotabili.
Tymeslot si integra con diversi servizi di calendario, tra cui Google Calendar, Microsoft Outlook, Apple iCloud e sistemi compatibili con CalDAV. La sincronizzazione permette di aggiornare la disponibilità e registrare gli appuntamenti confermati nei calendari collegati.
Un elemento importante riguarda la prevenzione delle doppie prenotazioni: al momento della richiesta, la piattaforma verifica gli impegni presenti nei calendari connessi e impedisce di confermare una fascia oraria che risulta occupata. In questo modo è possibile coordinare più calendari senza dover controllare manualmente ogni singolo appuntamento.
Le pagine di prenotazione possono essere personalizzate e integrate anche in un sito web esistente. Tymeslot supporta modalità di incorporamento inline, finestre popup e pulsanti flottanti, permettendo di inserire il sistema direttamente nelle pagine di un’attività professionale o aziendale.
Il progetto dispone inoltre di un plugin dedicato a WordPress, utile per integrare le funzionalità di prenotazione nel proprio sito. I widget utilizzano token firmati e vincoli di dominio per limitare l’utilizzo alle pagine autorizzate.
La gestione degli incontri comprende anche la possibilità di offrire differenti modalità di partecipazione. A seconda della configurazione, un appuntamento può svolgersi in presenza, per telefono oppure attraverso servizi di videoconferenza come Google Meet, Microsoft Teams, Zoom, Jitsi Meet, Nextcloud Talk e altre piattaforme compatibili.
Quando previsto dal servizio collegato, Tymeslot può creare automaticamente la stanza virtuale dopo la conferma della prenotazione. Gli organizzatori possono inoltre aggiungere domande personalizzate ai moduli, raccogliendo in anticipo informazioni utili per preparare la riunione.
La comunicazione con gli utenti viene gestita attraverso email automatiche con informazioni sull’appuntamento, allegati calendario in formato ICS e promemoria configurabili. I collegamenti firmati consentono agli ospiti di cancellare o riprogrammare una prenotazione senza dover necessariamente creare un account.
Installazione con Docker, privacy e automazioni per professionisti
Uno dei principali vantaggi di Tymeslot è la possibilità di installarlo autonomamente utilizzando Docker. Il progetto fornisce un’immagine precompilata che include PostgreSQL, semplificando la configurazione iniziale e riducendo il numero di componenti da preparare manualmente.
Un esempio di avvio riportato nella documentazione del progetto è il seguente:
docker run --name tymeslot \
-p 4000:4000 \
-e SECRET_KEY_BASE="$(openssl rand -base64 64 | tr -d '\n')" \
-e PHX_HOST=localhost \
-v tymeslot_data:/app/data \
-v tymeslot_pg:/var/lib/postgresql/data \
luka1thb/tymeslot:latestIl comando avvia il servizio sulla porta 4000 e utilizza volumi persistenti per conservare i dati e il database anche dopo l’arresto del container. Una volta avviata l’applicazione, è possibile accedere all’interfaccia web e creare il primo account, che su una nuova installazione assume il ruolo di amministratore.
Per un utilizzo pubblico, il comando rappresenta soltanto un punto di partenza. È necessario configurare correttamente dominio, HTTPS, invio delle email, autenticazione e backup. La documentazione raccomanda inoltre di conservare il database in un volume nominato, soprattutto negli ambienti Docker Desktop, rootless o con SELinux, dove determinate configurazioni basate su percorsi locali possono creare problemi.
Sul fronte della sicurezza, Tymeslot supporta l’autenticazione tramite email e password, Google, GitHub e provider OAuth/OIDC compatibili, tra cui Keycloak, Authentik, Okta e Microsoft Entra ID. Le credenziali vengono cifrate a riposo e il progetto include limitazioni alle richieste degli endpoint pubblici, protezioni CSRF e webhook firmati tramite HMAC.
La piattaforma dichiara inoltre di non utilizzare tracker di terze parti o pixel analitici. Sono disponibili webhook per gli eventi di creazione, cancellazione e riprogrammazione degli appuntamenti, che possono essere collegati a strumenti di automazione come n8n, Zapier e Make oppure a sistemi sviluppati internamente.
Tymeslot offre anche funzionalità per personalizzare l’aspetto delle pagine di prenotazione, con temi, colori, sfondi e opzioni white-label. L’interfaccia, le pagine pubbliche e le email supportano diverse lingue, tra cui l’italiano, mentre le preferenze linguistiche permettono di adattare le comunicazioni ai visitatori.
Per chi desidera monetizzare le prenotazioni, è disponibile un’integrazione opzionale con Stripe Connect. Questa funzione consente di richiedere pagamenti durante la prenotazione, ma rimane disattivata per impostazione predefinita e richiede una configurazione specifica.
La versione self-hosted è disponibile gratuitamente con tutte le funzionalità previste, senza limiti artificiali sul numero di prenotazioni imposti da un piano commerciale. Il servizio cloud gestito offre invece un piano gratuito e un’opzione Pro a pagamento, indicata dal progetto a 9 euro al mese.
Tymeslot è distribuito con licenza GNU AGPLv3, che permette di utilizzare, modificare e ridistribuire il software nel rispetto delle condizioni previste. Chi distribuisce una versione modificata come servizio di rete deve rispettare gli obblighi di condivisione del codice sorgente stabiliti dalla licenza.
Per professionisti e organizzazioni che vogliono semplificare la gestione degli appuntamenti, integrare calendari differenti e mantenere un maggiore controllo sull’infrastruttura, Tymeslot offre una soluzione completa che unisce prenotazioni, comunicazioni automatiche e strumenti per le riunioni online. Abbiamo testato Tymeslot su Arch Linux con ambiente desktop KDE Plasma 6.8.