CalFuse Docs

CalFuse sincronizza eventi tra calendari collegati. Nell'MVP i provider attivi sono Google Calendar, Microsoft Outlook e Apple Calendar: puoi registrarti, collegare uno o più account, scegliere i calendari e creare SyncLink in una direzione o in modalità bidirezionale.

Ogni SyncLink mantiene opzioni proprie: privacy, campi da copiare, filtri, colori, tag e comportamento di ReSync.

1. 1Apri la pagina di registrazione o login.
2. 2Accedi con magic link email, Google o Microsoft. Il login Microsoft e il collegamento calendario Outlook sono due flussi separati.
3. 3Apri il link ricevuto via email oppure completa il consenso del provider identità: la sessione viene creata automaticamente.
4. 4Dopo il login verrai portato alla dashboard. Da li puoi collegare Google Calendar, Microsoft Outlook o Apple Calendar.

CalFuse supporta italiano e inglese sulle superfici principali: sito pubblico, autenticazione, dashboard, billing, supporto, pagine legali e documentazione. La lingua si cambia dal selettore lingua e viene ricordata nel browser.

Le lingue non ancora complete non vengono mostrate agli utenti.

1. 1Vai in Dashboard → Account.
2. 2Seleziona Connetti Google, Connetti Microsoft, Connetti Apple o Riconnetti se l'account risulta scaduto.
3. 3Per Google e Microsoft completa il consenso OAuth. Per Apple usa Apple ID/iCloud e una password specifica per app.
4. 4Al ritorno nell'app, l'account comparirà come attivo.

Se un provider revoca il token, la sessione scade o la password specifica per app non è più valida, CalFuse mostra l'account come da riconnettere e disabilita le azioni che richiedono accesso live.

Apple Calendar non espone un flusso OAuth equivalente a Google o Microsoft per questo caso d'uso. Per l'MVP CalFuse usa iCloud CalDAV: devi inserire Apple ID/email iCloud e una password specifica per app generata dal tuo account Apple.

1. 1Accedi alla gestione del tuo Apple ID e crea una password specifica per app per CalFuse.
2. 2Vai in CalFuse → Account → Connetti Apple.
3. 3Inserisci Apple ID/email iCloud e la password specifica per app. Non usare la password principale del tuo Apple ID.
4. 4CalFuse valida le credenziali su iCloud CalDAV, salva la password cifrata e importa i calendari disponibili.
5. 5Se revochi la password dal tuo Apple ID o la cambi, riconnetti l'account Apple da CalFuse.

Per generare la password specifica per app segui la guida ufficiale Apple: Accedere alle app con l'Apple Account usando password specifiche per le app.

La pagina Calendari mostra i calendari disponibili per ciascun account collegato. Puoi abilitare o disabilitare i calendari che vuoi rendere selezionabili nei SyncLink.

Il refresh dei calendari legge i dati live dal provider quando le credenziali sono valide; in caso contrario viene mostrato un avviso di riconnessione.

1. 1Vai in Dashboard → Sync Links.
2. 2Clicca Nuovo Sync Link.
3. 3Scegli Calendario A e Calendario B.
4. 4Seleziona direzione e opzioni di sincronizzazione.
5. 5Conferma. Alla creazione viene accodato un backfill automatico per allineare gli eventi esistenti nella finestra supportata.

Il pulsante Forza risincronizzazione accoda un controllo completo nella finestra configurata dal sistema. È utile dopo modifiche importanti alle opzioni, riconnessioni o dubbi su eventi non allineati.

Il ReSync può essere limitato da cooldown e limiti giornalieri per proteggere provider, code e database. Se un account richiede riconnessione, il pulsante viene disabilitato.

Gli Scheduling Links servono a condividere una pagina pubblica di prenotazione. A differenza degli SyncLink, non copiano eventi tra calendari gia esistenti: creano un nuovo appuntamento sul calendario host quando un ospite sceglie uno slot disponibile.

1. 1Vai in Dashboard -> Scheduling.
2. 2Crea o modifica una pagina pubblica con nome, slug, timezone e stato attivo.
3. 3Aggiungi una o piu opzioni appuntamento, per esempio 15, 30, 60 o 90 minuti.
4. 4Scegli il calendario target su cui scrivere il booking e i calendari da controllare per evitare conflitti.
5. 5Configura disponibilita settimanale, buffer, preavviso minimo e finestra massima di prenotazione.
6. 6Condividi il link pubblico della pagina.

La pagina pubblica non richiede login all'ospite. L'ospite sceglie l'opzione appuntamento, seleziona data e slot, inserisce nome, email ed eventuali note, poi conferma.

Prima di salvare la prenotazione CalFuse ricalcola la disponibilita e blocca lo slot per ridurre il rischio di doppie prenotazioni. Dopo la conferma viene creato l'evento sul calendario host configurato.

Quick Schedule ti permette di scrivere un evento in linguaggio naturale e trasformarlo in una bozza controllabile. Prima di creare l'evento puoi modificare titolo, data, orario, calendario, partecipanti, meeting, luogo e descrizione.

1. 1Vai in Dashboard -> Quick Schedule.
2. 2Scegli il calendario su cui vuoi creare l'evento.
3. 3Scrivi la richiesta, ad esempio: Domani dalle 15 alle 17 titolo Demo prodotto, aggiungi Meet, invita [email protected].
4. 4Clicca Prepara preview.
5. 5Controlla tutti i campi della preview e correggi eventuali errori o campi mancanti.
6. 6Clicca Crea evento solo quando la preview e' corretta.

I piani governano quante risorse puoi usare: account calendario collegabili, SyncLink, pagine Scheduling attive e livello Quick Schedule. Il piano Free permette di provare il prodotto con limiti ridotti; i piani Pro e Business sbloccano piu account, piu collegamenti e opzioni avanzate.

Se raggiungi un limite, l'app blocca nuove creazioni e mostra una CTA di upgrade. Le verifiche sono applicate lato server, non solo nell'interfaccia.

Dalla pagina Billing puoi vedere piano corrente, stato dell'abbonamento, periodo coperto, profilo fiscale e azioni disponibili. Il checkout online usa una pagina hosted del gateway di pagamento: CalFuse non raccoglie ne conserva dati carta.

CalFuse supporta profili fiscali distinti per privati e aziende/professionisti. Prima del checkout puoi indicare i dati necessari al documento corretto.

Google Calendar e Microsoft Outlook usano subscription webhook o delta per notificare i cambi e sincronizzare gli eventi in modo incrementale.

Le subscription vengono rinnovate automaticamente dal sistema. Il pulsante Rinnova è uno strumento manuale di manutenzione e non dovrebbe essere necessario nell'uso normale. Apple Calendar usa polling CalDAV e non compare nella lista delle subscription webhook.

Dalla voce Supporto puoi aprire e seguire ticket autenticati. Ogni ticket ha categoria, priorita, stato e thread messaggi. Il team di supporto vede solo un contesto tecnico essenziale e sicuro, utile a diagnosticare problemi di login, billing, provider, account e sync.