FLUXION

Guida Ufficiale v0.9

Tutto quello
che ti serve
in 30 minuti.

La guida completa per usare Fluxion dal primo giorno — scritta per chi ha un'attività da mandare avanti, non tempo da sprecare.

📅

Calendario

Appuntamenti, clienti, schede — tutto in ordine

🎙️

Sara

Risponde al telefono e prenota 24/7 per te

💬

Conferme automatiche ai tuoi clienti

fluxion.gestionale@gmail.com · lukeeterna.github.io/fluxion-desktop Versione 0.9.x · 2026

Guida completa

Cosa trovi in questa guida

Segui i capitoli nell'ordine la prima volta. Dalla seconda userai questa guida come riferimento rapido.

1

Installazione

Scaricare e aprire Fluxion per la prima volta

pag 3

2

Configurazione iniziale

La procedura guidata che fa tutto da sola — 5 minuti

pag 4

3

Il calendario

Come inserire appuntamenti, bloccare orari e vedere la settimana

pag 5

4

I tuoi clienti

Scheda cliente, storico appuntamenti, note e schede verticali

pag 6

5

Sara — la segretaria AI

Come attivare Sara e cosa sa fare al telefono

pag 7

6

WhatsApp automatico

Conferme, promemoria e come attivare il numero

pag 8

7

Fatturazione elettronica

Come emettere e inviare una fattura XML in 3 clic

pag 9

8

Domande frequenti

I problemi più comuni e come risolverli

pag 10

💡

Prima volta con Fluxion?

Inizia dal Capitolo 1 e segui l'ordine. La configurazione iniziale (Cap. 2) ti guida passo per passo — non puoi sbagliare. Ci vogliono circa 5 minuti.

🛡️

I tuoi dati sono al sicuro

Fluxion funziona sul tuo Mac. Nomi, numeri e appuntamenti non escono mai dal tuo computer. Nessun cloud, nessun abbonamento, nessun rischio.

Capitolo 1

Installazione

Meno di 2 minuti. Una volta sola. Poi Fluxion è sempre lì, pronto quando apri il Mac.

1

Attiva la licenza

Dopo l'acquisto ricevi un'email con il link di attivazione. Aprila e clicca "Scarica licenza". Si scarica un file chiamato license.json — tienilo al sicuro.

2

Scarica Fluxion

Dalla stessa email, clicca "Scarica Fluxion per Mac". Si scarica un file Fluxion.dmg. Aprilo e trascina l'icona Fluxion nella cartella Applicazioni — esattamente come qualsiasi altra app Mac.

3

Prima apertura

Apri Fluxion dalla cartella Applicazioni. Se il Mac ti chiede "Sei sicuro?" clicca Apri — è normale per le app non scaricate dall'App Store. Fluxion è sicuro.

4

Inserisci la licenza

Al primo avvio Fluxion ti chiede il file di licenza. Clicca "Sfoglia" e seleziona il file license.json che hai scaricato al punto 1.

💡

Copia license.json in un posto sicuro

Tieni una copia del file license.json in una chiavetta USB o su iCloud. Se reinstalli il Mac, ti serve per riattivare Fluxion senza pagare di nuovo.

Requisiti tecnici

🍎

macOS

Monterey (12) o versione successiva. Funziona su Mac Intel e Apple Silicon (M1, M2, M3).

💾

Spazio

Circa 50 MB per l'applicazione. Il database clienti cresce con l'utilizzo (tipicamente <500 MB).

🌐

Internet

Solo per Sara (voce AI). Calendario, clienti e fatture funzionano completamente offline.

Capitolo 2

Configurazione iniziale

Alla prima apertura, Fluxion ti fa 7 domande. Cinque minuti e sei pronto. Non puoi sbagliare — puoi sempre tornare indietro.

1

Nome attività

Scrivi il nome della tua attività esattamente come lo diranno i clienti. Es: "Salone Giulia" o "Officina Ferrari".

2

Settore

Scegli il tuo settore dal menu. Questo attiva le schede cliente giuste per il tuo mestiere.

3

Orari di lavoro

Imposta i giorni e gli orari in cui vuoi che Sara proponga appuntamenti.

4

Numero WhatsApp

Il numero da cui partono i messaggi di conferma ai clienti. Deve essere un numero WhatsApp attivo.

5

Dati fatturazione

Ragione sociale, partita IVA, indirizzo. Servono solo se vuoi emettere fatture elettroniche.

6

Servizi offerti

Aggiungi i tuoi servizi con nome, durata e prezzo. Sara li usa per prenotare al telefono.

7

Attiva Fluxion AI

Segui le istruzioni a schermo per attivare Sara in 2 minuti. Puoi saltare e farlo dopo.

🧭

Schermata della
procedura guidata

💡

Puoi cambiare tutto dopo

Tutte le impostazioni si trovano in Impostazioni → Attività. Non stressarti se non sai qualcosa — puoi completare dopo.

ℹ️

Fluxion AI (Step 7)

Sara funziona con Fluxion AI, un servizio gratuito che attivi con un clic. Se salti questo step, Sara resta in modalità silenziosa: registra le chiamate ma non risponde voce.

            ✅ Al termine della configurazione
            Calendario pronto con i tuoi orari
Sara sa il nome della tua attività
WhatsApp configurato per le conferme
Servizi inseriti e prenotabili

          

Capitolo 3

Il calendario

Il cuore di Fluxion. Vedi tutti gli appuntamenti in un colpo d'occhio, per giorno o per settimana.

Aggiungere un appuntamento

1

Clicca su un orario libero

Nel calendario, clicca sull'orario in cui vuoi aggiungere l'appuntamento. Si apre un pannello laterale.

2

Cerca il cliente

Digita le prime lettere del nome. Fluxion lo trova in automatico dalla tua lista clienti.

3

Scegli il servizio

Seleziona dal menu il servizio. La durata si imposta da sola.

4

Salva

Clicca Salva. Se il cliente ha WhatsApp attivo, riceve la conferma automatica.

📅

Vista settimanale
del calendario

Viste disponibili

Giorno — tutti gli slot del giorno corrente
Settimana — panoramica 7 giorni con tutti gli operatori
Lista — elenco appuntamenti in ordine cronologico

Gestire un appuntamento esistente

✏️

Modificare

Clicca sull'appuntamento → modifica data, ora o servizio → Salva.

🔄

Spostare

Trascina l'appuntamento sul nuovo orario. Il cliente riceve conferma WhatsApp del cambio.

❌

Cancellare

Clicca sull'appuntamento → Annulla appuntamento. Scegli se avvisare il cliente via WhatsApp.

💡

Blocca le ferie o le pause

Vuoi bloccare mezza giornata o una settimana intera? Clicca sull'orario tenendo premuto e trascina — si crea un "blocco". Sara non proporrà quell'orario ai clienti che chiamano.

Capitolo 4

I tuoi clienti

Ogni cliente ha la sua scheda. Tutto quello che ti serve è lì: storico, note, schede tecniche e preferenze.

Aggiungere un nuovo cliente

1

Vai in "Clienti"

Dal menu laterale, clicca su Clienti → "Nuovo cliente".

2

Dati base

Nome, cognome, telefono. L'email è facoltativa. Il numero di telefono è quello che Sara usa per riconoscerlo quando chiama.

3

Consenso WhatsApp

Attiva il toggle "Consenso WhatsApp" solo se il cliente ti ha dato il permesso di ricevere messaggi. Obbligatorio per il GDPR.

ℹ️

Sara riconosce i clienti

Quando un cliente chiama, Sara cerca il suo numero nella tua lista. Se lo trova, lo chiama per nome. Se è la prima volta, crea la scheda cliente automaticamente.

La scheda cliente

Storico appuntamenti — tutti i passati e i futuri
Note private — visibili solo a te (allergie, preferenze, ecc.)
Scheda tecnica — specifica del tuo settore (colorazione, odontogramma, scheda allenamento…)
Programma fedeltà — timbri accumulati e premi raggiunti
Pacchetti acquistati — sedute residue e scadenze

👤

Scheda cliente con
scheda tecnica settore

⭐

Clienti VIP

Contrassegna i clienti migliori come VIP (1-3 stelle). Puoi inviargli WhatsApp selettivi su promozioni e novità.

Importare clienti esistenti

Hai già una lista clienti in Excel o su carta? Vai in Impostazioni → Importa clienti e carica il file CSV. Fluxion li importa tutti in pochi secondi. Se hai bisogno di aiuto con il formato, scrivi a fluxion.gestionale@gmail.com.

Capitolo 5

Sara — la segretaria AI

Sara risponde al telefono, prenota appuntamenti e manda conferme WhatsApp. Funziona 24 ore su 24, 7 giorni su 7 — anche quando stai lavorando, stai mangiando o stai dormendo.

Come funziona in pratica

🎙️ Sara parla

"Buongiorno, sono Sara del Salone Giulia. Come posso aiutarla?"

👤 Cliente risponde

"Ciao, sono Marco Rossi, vorrei tagliare i capelli domani pomeriggio"

🎙️ Sara risponde

"Perfetto Marco! Ho disponibile domani alle 15:30 o alle 17:00. Quale preferisce?"

👤 Cliente risponde

"Le 17 va bene"

🎙️ Sara conferma

"Perfetto! Ho prenotato per Marco Rossi domani alle 17:00 — taglio capelli. Le mando la conferma su WhatsApp. Buona giornata!"

Cosa sa fare Sara

Riconosce i clienti abituali dal nome
Capisce accenti regionali e soprannomi
Propone orari alternativi se lo slot è occupato
Mette in lista d'attesa se tutto è pieno
Invia la conferma WhatsApp in automatico
Gestisce cancellazioni e spostamenti
Risponde al tuo nome di attività

⚠️

Sara ha bisogno di internet

Solo per la parte di risposta vocale (Fluxion AI). Basta una connessione normale — anche la connessione del telefono come hotspot funziona.

✅

Sara è già attiva?

Controlla in Impostazioni → Sara. Se vedi il punto verde "Attiva", Sara sta già rispondendo alle chiamate.

Come attivare Sara (se non l'hai fatto durante la configurazione)

1

Vai in Impostazioni → Sara → Attiva Fluxion AI

2

Clicca il pulsante "Attiva Fluxion AI" e segui le istruzioni (crea account gratuito, copia la chiave)

3

Incolla la chiave nel campo e clicca Testa. Se appare ✅ verde, Sara è pronta.

4

Imposta il deviazione di chiamata dal tuo gestore telefonico verso il numero Sara (vedi email di attivazione).

Capitolo 6

WhatsApp automatico

Ogni volta che si prenota, modifica o cancella un appuntamento, il cliente riceve un messaggio WhatsApp in automatico. Non devi fare nulla.

Messaggi automatici inviati

Conferma prenotazione — subito dopo la prenotazione
Promemoria — il giorno prima (configurabile)
Modifica appuntamento — quando sposti un orario
Cancellazione — se annulli l'appuntamento
Rinnovo abbonamento — alert automatico (palestre)
"Il tuo veicolo è pronto" — per officine

⚠️

Consenso obbligatorio

Invia messaggi WhatsApp solo ai clienti che hanno dato il consenso. Il toggle "Consenso WhatsApp" nella scheda cliente deve essere attivo. È un obbligo di legge (GDPR).

💡

Personalizza i messaggi

In Impostazioni → WhatsApp → Template puoi modificare il testo dei messaggi automatici con il nome della tua attività.

Capitolo 7

Fatturazione elettronica

Emetti fatture XML conformi al Sistema di Interscambio (SDI) in 3 clic. Nessun software aggiuntivo, nessun commercialista per questo.

1

Vai in "Fatture"

Dal menu laterale clicca Fatture → "Nuova fattura".

2

Seleziona cliente e voci

Cerca il cliente, aggiungi le voci (servizi o prodotti) con il prezzo. L'IVA si calcola in automatico.

3

Invia all'SDI

Clicca "Invia al SDI". Fluxion genera il file XML e lo trasmette. Ricevi la ricevuta di consegna via email.

ℹ️

Prima di emettere fatture

Controlla in Impostazioni → Azienda che tutti i dati siano corretti: Partita IVA, codice fiscale, indirizzo, regime fiscale. Un dato sbagliato invalida la fattura.

💡

Hai un commercialista?

Puoi esportare tutte le fatture in un file ZIP mensile da Fatture → Esporta periodo. Mandaglielo direttamente — ha già tutto.

Capitolo 8

Domande frequenti

📱 Sara e le chiamate

Sara non risponde alle chiamate. Cosa faccio?

Controlla che il servizio Sara sia attivo in Impostazioni → Sara (pallino verde). Poi verifica che la deviazione di chiamata sia attiva sul tuo telefono.

I clienti non capiscono che stanno parlando con un AI?

Spesso no — Sara suona naturale e professionale. Se preferisci, puoi configurarla per dire "Sono l'assistente automatico di [tua attività]" all'inizio di ogni chiamata.

Sara può gestire le cancellazioni?

Sì. Il cliente dice "voglio cancellare l'appuntamento" e Sara lo gestisce, aggiornando il calendario e inviando conferma cancellazione via WhatsApp.

Sara capisce i dialetti?

Capisce accenti regionali (testato con accenti veneto, romano, siciliano, napoletano). Risponde sempre in italiano chiaro.

💾 Dati e sicurezza

Cosa succede se si rompe il Mac?

Fluxion salva automaticamente un backup del database ogni notte in ~/Documents/Fluxion/backup/. Copia quella cartella su un disco esterno o iCloud ogni settimana.

Posso usare Fluxion su due Mac?

La licenza è per 1 dispositivo. Per il piano Enterprise (multi-sede) puoi installarlo su più Mac. Scrivi a fluxion.gestionale@gmail.com per info.

⚙️ Uso quotidiano

Ho sbagliato un appuntamento. Come modifico?

Clicca sull'appuntamento nel calendario → Modifica. Cambia data, ora o servizio → Salva. Il cliente riceve automaticamente un WhatsApp con il nuovo orario.

Come aggiungo un nuovo servizio (es. trattamento nuovo)?

Vai in Impostazioni → Servizi → Aggiungi servizio. Metti nome, durata e prezzo. Sara lo può prenotare al telefono dal giorno dopo.

Il cliente vuole un pacchetto di sedute. Come lo gestisco?

Vai nella scheda cliente → Tab "Pacchetti" → "Nuovo pacchetto". Scegli il servizio, il numero di sedute e l'importo. Fluxion scala le sedute automaticamente ad ogni appuntamento.

Come vedo il totale incassato del mese?

Vai in Report → Riepilogo mensile. Vedi incassi per servizio, per operatore e il totale del mese. Esportabile in Excel.

🔧 Problemi tecnici

L'app è lenta o si blocca

Chiudi e riapri Fluxion. Se persiste, riavvia il Mac. Fluxion è progettato per girare per settimane senza riavvii — ma il Mac se ne giova comunque.

Non riesco ad attivare la licenza

Assicurati di usare il file license.json originale (non una copia rinominata). Se il problema persiste, scrivi a fluxion.gestionale@gmail.com con lo screenshot dell'errore.

Hai bisogno di aiuto?

Il nostro supporto risponde entro 24 ore. Siamo qui per farti partire nel modo giusto.

📧

Email

fluxion.gestionale
@gmail.com

🌐

Sito web

lukeeterna.github.io
/fluxion-desktop

🔑

Licenza

Attiva o trasferisci
dalla pagina web

Ricorda: I tuoi dati sono sul tuo Mac. Nessuno può accedervi senza il tuo permesso. Nessun abbonamento può essere revocato. Fluxion è tuo per sempre.

FLUXION

Gestionale desktop per PMI italiane · Fatto in Italia · v0.9 · 2026