Manuale di utilizzo

Primo accesso al bot

Il punto di ingresso è il comando /start, che deve essere usato nella chat privata con il bot. In Telegram il comando puo essere avviato in piu modi: premendo il pulsante Avvia che compare nella parte bassa della chat quando si apre il bot per la prima volta, scrivendo manualmente /start nel campo messaggio e inviandolo, oppure aprendo il pulsante Menu che si trova in basso a sinistra, alla stessa altezza della barra in cui si digita il testo. Da quel pulsante Telegram mostra i comandi disponibili, incluso /start. Se il profilo esiste gia, l'utente accede al menu personale. In caso contrario, il bot avvia la procedura di registrazione iniziale.

Dati richiesti per la registrazione

La registrazione iniziale richiede tre informazioni di base. Questi dati devono essere inseriti in modo esatto, cosi come risultano nei documenti personali e nei dati anagrafici ufficiali registrati presso il Comune. È importante non abbreviare e non omettere nulla: se nei documenti o all'anagrafe sono presenti un secondo nome, un doppio nome, un secondo cognome o un cognome composto, devono essere riportati integralmente anche nel bot.

Nel caso in cui l'utente intenda registrarsi come partita IVA, al posto del classico nome e cognome personali deve inserire la denominazione dell'azienda. Poiche il bot richiede comunque due campi separati, la denominazione aziendale deve essere suddivisa in modo coerente tra i due campi richiesti durante la registrazione.

Esempio pratico: se la denominazione e Consulting SRL, l'utente puo suddividerla nei due campi obbligatori in modo coerente, ad esempio inserendo Consulting nel campo Nome e SRL nel campo Cognome, mantenendo comunque una suddivisione chiara e riconoscibile della ragione sociale.

• Nome
• Cognome
• Data di Nascita

Attesa di conferma da parte degli amministratori

Dopo il salvataggio dei dati, l'utente non entra immediatamente in tutte le funzioni del bot. Questo passaggio di attesa è necessario per motivi di controllo e sicurezza: il bot, infatti, è potenzialmente accessibile a chiunque possieda un account Telegram. Per questo motivo la registrazione resta in attesa di approvazione da parte degli amministratori, che si coordinano tra loro per capire se sono a conoscenza di chi sia l'utente appena registrato e se il profilo possa quindi essere validato prima dei passaggi successivi.

Sollecito conferma registrazione

Se la registrazione non risulta ancora approvata, il bot mette a disposizione un'azione di sollecito verso gli amministratori. Questa funzione è utile per ricordare che il profilo è in attesa di conferma.

Menu utente e stato corrente

Una volta entrato nel menu, l'utente vede il passaggio operativo attuale. Questo permette di capire immediatamente se manca ancora la registrazione, la parte fiscale, la convalida documenti o il pagamento dell'abbonamento.

Avvio della procedura fiscale

Il bot guida l'utente nella compilazione dei dati fiscali obbligatori. Questa fase è necessaria per permettere la corretta gestione amministrativa e la successiva fatturazione.

Tipologie di soggetto gestite

Il sistema prevede tre tipologie di soggetto fiscale:

• persona italiana
• persona estera
• partita IVA

Per tutte e tre le tipologie, i dati devono essere compilati con la massima attenzione e precisione, sia per la loro veridicità sia per il formato richiesto dal bot. Ogni informazione deve essere inserita correttamente fin dal primo invio. Una volta registrato il singolo dato nel flusso, infatti, non è prevista una modifica autonoma da parte dell'utente durante la procedura. Se viene inserito un dato errato, volontariamente o per distrazione, sarà poi necessario l'intervento del responsabile tecnico per sistemare la registrazione. Questo comporta un rallentamento del processo e un sovraccarico di lavoro evitabile. Per questo motivo invitiamo gentilmente ogni utente a compilare tutti i campi con la massima cura prima di inviarli.

Dati richiesti dal bot

In base alla tipologia scelta, il bot richiede l'identificativo fiscale corretto e successivamente raccoglie indirizzo, CAP o postal code, comune, provincia o stato, nazione ed email. Questi dati devono essere inseriti seguendo l'ordine richiesto dal bot, un campo alla volta, premendo invio dopo ogni singola risposta. Non devono quindi essere scritti tutti insieme in un unico messaggio, perche il bot legge e salva un'informazione per volta.

• Esempio pratico per persona italiana: Mario Rossi invia un messaggio con il codice fiscale RSSMRA80A01H501U. Quando il bot chiede l'indirizzo, invia un secondo messaggio con Via Giuseppe Verdi 15. Quando il bot chiede il CAP, invia un terzo messaggio con 20121. Poi invia, sempre uno alla volta, Milano come comune, MI come provincia, IT come nazione e mario.rossi@example.com come email.
• Esempio pratico per persona estera: John Smith invia un messaggio con il proprio identificativo fiscale estero AB1234567C. Quando il bot chiede l'indirizzo, invia un secondo messaggio con 221B Baker Street. Quando il bot chiede il postal code, invia un terzo messaggio con NW16XE. Poi invia, sempre uno alla volta, London come citta, Greater London come stato o cantone, GB come nazione e john.smith@example.com come email.

Dati aggiuntivi per partita IVA

Nel caso di partita IVA, il flusso viene esteso con la richiesta del codice destinatario o SDI e dell'indirizzo PEC, entrambi necessari per la gestione della fatturazione elettronica. Anche in questo caso, ogni dato deve essere inserito uno alla volta, seguendo con precisione le richieste del bot e verificando con attenzione sia il contenuto sia il formato.

• Esempio pratico per partita IVA: Mario Rossi, come ditta individuale o professionista, invia prima la partita IVA 12345678901. Quando il bot chiede l'indirizzo, invia Via Giuseppe Verdi 15. Poi invia, uno alla volta, 20121 come CAP, Milano come comune, MI come provincia, IT come nazione, mario.rossi@example.com come email, ABC1234 come codice destinatario e mariorossi@pec.example.it come PEC.

Controlli automatici sui dati

Durante la compilazione, il bot verifica la correttezza formale delle informazioni inserite. In questo modo riduce errori su codice fiscale, partita IVA, email, nazione, CAP, provincia e altri campi sensibili.

Sollecito conferma dati fiscali

Se i dati fiscali sono stati inviati ma non risultano ancora confermati, l'utente può inviare un sollecito agli amministratori direttamente dal menu.

Caricamento dei documenti

Dopo la compilazione dei dati fiscali, il bot richiede il caricamento di uno o più documenti a supporto, in funzione della tipologia di soggetto selezionata.

Documenti supportati

I documenti attualmente gestiti dal bot sono richiesti per verificare la veridicità dei dati inseriti dall'utente durante la registrazione e nella fase fiscale. Per questo motivo è importante fornire un documento che riporti in modo chiaro tutte le informazioni necessarie al controllo. Un esempio tipico è la carta d'identità elettronica, che consente di verificare con precisione i dati anagrafici principali.

• tessera sanitaria
• carta d'identità elettronica
• visura camerale

Fronte e retro del documento

Per i documenti personali, il flusso prevede il caricamento separato del fronte e del retro. Il bot accompagna l'utente passo dopo passo, chiedendo una foto alla volta.

Visura camerale per partite IVA

Per le aziende o partite IVA, il caricamento e semplificato: il bot richiede la parte anagrafica della visura camerale, senza richiedere il documento personale del referente.

Aggiornamento del solo documento

Se i dati fiscali risultano già presenti a sistema ma il documento deve essere aggiunto o sostituito, l'utente può caricare esclusivamente il documento senza ripetere tutta la compilazione fiscale.

Attesa convalida e sollecito

Dopo l'invio, il bot conferma l'avvenuto salvataggio e informa l'utente che la verifica restera in carico agli amministratori. Se la convalida non arriva, e disponibile una funzione di sollecito dedicata.

Intervallo minimo tra i solleciti

Per evitare richieste troppo ravvicinate, il bot applica un cooldown automatico tra un sollecito e il successivo.

Accesso alla sezione abbonamento

Quando il profilo e abilitato, l'utente puo aprire l'area abbonamento e visualizzare la propria situazione attuale.

Stati possibili del profilo

Il bot puo mostrare diversi scenari, tra cui:

• nessun abbonamento attivo
• abbonamento attivo
• abbonamento scaduto
• accesso broker lifetime
• precedente accesso broker terminato

Nuovo abbonamento, rinnovo e riattivazione

In base allo stato del profilo, il bot puo proporre un nuovo abbonamento, il rinnovo anticipato oppure la riattivazione. La proposta cambia automaticamente in funzione della situazione reale dell'utente.

Piani disponibili

Al momento il bot gestisce due opzioni principali per l'acquisto diretto:

• abbonamento mensile
• abbonamento annuale

Anteprima del periodo di validita

Prima del pagamento, il bot calcola e mostra il periodo previsto del nuovo abbonamento. In questo modo l'utente vede chiaramente la data di inizio e la data di fine della copertura.

Gestione accesso broker

Per gli utenti che rientrano nel percorso broker, il bot espone lo stato dell'accesso lifetime e ricorda l'obbligo di mantenere attivo il conto broker per conservare il diritto all'accesso VIP.

Generazione del link di pagamento

Dopo la scelta del piano, il bot genera un link di pagamento Stripe e lo invia all'utente con il riepilogo del periodo di validita associato all'acquisto.

Conclusione del pagamento

L'utente completa il pagamento direttamente tramite il link ricevuto. Al termine, il sistema registra in automatico l'esito dell'operazione.

Attivazione automatica dell'abbonamento

Una volta ricevuta la conferma del pagamento, il bot aggiorna lo stato dell'abbonamento senza richiedere interventi manuali all'utente.

Invio accesso VIP

Quando previsto dalla situazione del profilo, il bot invia in automatico il link per l'accesso al canale o alla chat VIP.

Emissione e invio della fattura

Dopo il pagamento, il sistema prova a generare la fattura e a trasmettere il relativo PDF all'utente. Se il PDF non e immediatamente disponibile, viene inviato un messaggio informativo e la spedizione avviene in un secondo momento.

Pagina di conferma o annullamento

Al termine del checkout, l'utente puo visualizzare una pagina di esito che conferma il pagamento completato oppure comunica l'annullamento dell'operazione.

Visualizzazione anagrafica

Il menu utente permette anche di aprire una schermata dedicata all'anagrafica personale, con i principali dati disponibili nel sistema.

Ritorno rapido al menu

Nei principali passaggi del flusso il bot consente di tornare facilmente al menu principale, cosi da non perdere il controllo del percorso operativo.

Assistenza

Quando il profilo richiede supporto manuale o si presenta una situazione non gestita in automatico, il bot indirizza l'utente ai riferimenti di assistenza previsti dal servizio.