Pannello · Home

Manuale operativo

Manuale utente per chi raccoglie le pratiche su WhatsApp e per chi collega il CRM dell'azienda. UnicoAgent non sostituisce il gestionale: raccoglie e consegna.

1. A chi serve

UnicoAgent è l'ingresso su WhatsApp con cui un agente o un installatore raccoglie i dati e i documenti di una pratica e li consegna al CRM dell'azienda, via API o per email. Il lavoro nel gestionale (istruttoria, delibera, contratto) resta nel CRM. Il servizio non valuta il merito creditizio e non decide l'esito.

Il dialogo ha tre passaggi:

Menu WhatsApp: la persona sceglie cosa fare. Le voci dipendono dall'azienda a cui appartiene il suo numero.
Preventivazione: per il finanziamento, un profilo a fasce senza nome né codice fiscale; per la fornitura, una nuova offerta a partire dalla spesa dichiarata.
Perfezionamento: codice pratica, documenti, controlli, dati che mancano. Alla conferma la pratica parte verso il CRM di quell'azienda, oppure per email se l'azienda non ha un CRM.

L'intelligenza artificiale legge i documenti e propone dei dati. L'agente li conferma. Un istruttore, nel CRM o nel pannello, decide sul merito.

2. L'azienda dal numero WhatsApp

Ogni messaggio è di una sola azienda. Il programma cerca il cellulare tra i fornitori attivi del core. Se lo trova, la conversazione è dell'azienda di UnicoAgent collegata a quel fornitore: prima per la società del core (core_company_id), altrimenti per l'identificativo dell'azienda in UnicoAgent. Se il numero non c'è, o il fornitore non è attivo, la conversazione è di Mediatore DEMO.

Un fornitore riconosciuto è salutato per nome. Un numero sconosciuto che completa un preventivo di finanziamento viene registrato come Segnalatore occasionale, non attivo: non vede gli importi e riceve telefono ed email del customer care.

Azienda	Cosa fa su WhatsApp	Dove arriva la pratica
Races Finance S.r.l.	Solo finanziamento. Menu predefinito: Richiedi Finanziamento, Modifica Preventivo, Perfeziona Finanziamento, Stato Pratiche. I percorsi caricati sono richiesta, perfezionamento e documenti.	CRM `unicofinance`, API `/api/agente/v1`. Non ha un URL di preventivatore: il preventivo, per un produttore, parte per email all'istruttoria.
GBD Energy	Solo fornitura. Il menu ha due voci: Nuova offerta e Sottoscrivi contratto. Aprono i percorsi `richiesta` e `perfezionamento` di questa azienda.	Nessun driver CRM: alla conferma la pratica va per email all'istruttoria, con gli allegati. Non produce i moduli dal core (manca il collegamento al tipo pratica).
Mediatore DEMO	Finanziamento e fornitura insieme. Il menu ha Richiedi Finanziamento, Modifica Preventivo, Perfeziona Finanziamento, Stato Pratiche e, in più, Nuova offerta e Sottoscrivi contratto. Queste due ultime voci sono i codici di percorso `fornitura` e `sottoscrizione`.	Nessun driver CRM: la pratica perfezionata va per email. È l'azienda di chi scrive da un numero non in anagrafica.

Su GBD Energy i percorsi «Nuova offerta» e «Sottoscrivi contratto» sono nel menu, ma nel database non hanno ancora le domande. Le domande della fornitura sono caricate su Mediatore DEMO (codici fornitura e sottoscrizione) e sono descritte in config/energy.php. Finché non si pubblicano anche su GBD, l'installatore di GBD non percorre quell'albero.

3. Menu e comandi

Al primo messaggio, e quando si torna al menu, WhatsApp mostra le voci dell'azienda. Si risponde con i pulsanti o scrivendo il titolo della voce. Per il menu di finanziamento valgono anche i numeri e le parole brevi: 1 o «richiedi», 2 o «modifica», 3 o «perfeziona», 4 o «stato». Un codice pratica scritto nel menu (forma SIGLA-MMGG-HHmm) apre il perfezionamento di quella pratica.

Il primo contatto riceve anche il link alla sintesi dei comandi (/comandi). Nel profilo WhatsApp i messaggi per rompere il ghiaccio ripetono i titoli del menu di finanziamento, così il bot li tratta come una scelta.

Comandi, in qualsiasi momento

Si scrivono da soli o con la barra (/menu, /help). Sono gli stessi registrati nel profilo.

Comando	Effetto
`menu`	Chiude la conversazione in corso e mostra il menu. Il pulsante «Vai al menu» in fondo al preventivo fa la stessa cosa.
`annulla`	Chiude la conversazione, scrive «Operazione annullata» e mostra il menu.
`help` o `aiuto`	Elenco dei comandi, poi ripropone la domanda in corso (o il menu, se non c'è un dialogo aperto).
`indietro`	Torna alla domanda precedente.
`salta`	Salta la domanda, solo se il bot lo consente: lo scrive in fondo al testo. Non salva una risposta.
`avanti`	Durante l'attesa dei controlli sui documenti: prosegue senza aspettare. Vale anche «continua».

Una conversazione lasciata sulla prima domanda per più di un'ora, senza risposte, viene chiusa: il messaggio successivo trova il menu. Se il dialogo è fermo da più di 24 ore, il bot chiede se continuare o ricominciare. Un saluto («ciao», «buongiorno» e simili) a una conversazione appena aperta, a cui non si è ancora risposto, riporta al menu.

Chi ha il numero WhatsApp associato a un utente del pannello, e solo se un percorso ha una copia di prova, vede in più le voci «Prova: Richiedi», «Prova: Perfeziona» e «Prova: Stato Pratiche». Le pratiche di quelle prove sono segnate come prova e il codice inizia con TST-.

4. Preventivo di finanziamento

Voce Richiedi Finanziamento. Vale per Races Finance e per Mediatore DEMO. La fase non chiede dati identificativi: se nel testo compaiono, il bot li rifiuta e ripete la domanda.

Tipo di finanziamento: prestito personale, cessione del quinto, finalizzato, mutuo, leasing, finanziamento aziendale.
Domande a scelta, diverse secondo il prodotto (importo, durata, età, lavoro, reddito a fasce, e le domande proprie di mutuo, leasing o azienda). Importo e durata si possono modificare in seguito; le altre solo se in configurazione sono segnate come modificabili.
Riepilogo: Conferma, Ricomincia o Annulla.

✅ Richiesta registrata. Codice pratica: PM-1007-1435. Conservalo: ti servirà per perfezionare il finanziamento.

Il codice ha la forma SIGLA-MMGG-HHmm: sigla del fornitore (se manca, le iniziali del nome; senza nome, SEG), mese e giorno, ora e minuti. Due preventivi dello stesso fornitore nello stesso minuto: il secondo aggiunge una lettera (PM-1007-1435A).

Subito dopo il codice, per un produttore:

Se l'azienda ha l'URL del preventivatore, il bot mostra l'importo minimo e massimo. Se il servizio non risponde, i dati del preventivo partono per email.
Se l'URL del preventivatore è vuoto, come oggi per tutte e tre le aziende, i dati del preventivo vanno per email. La casella è quella dell'istruttoria della prima azienda in archivio (oggi Races Finance), non quella dell'azienda della conversazione. Il messaggio dice che l'istruttoria ricontatterà. Se la mail non parte: «Non sono riuscito a inoltrare la richiesta all'istruttoria: contattala indicando il codice pratica.»

Un numero che non è un fornitore attivo non vede gli importi: viene registrato come Segnalatore occasionale e invitato a chiamare il customer care.

Modifica Preventivo elenca gli ultimi 5 preventivi non perfezionati. Il bot ne crea uno nuovo copiando le risposte e chiede solo i dati modificabili, mostrando il valore attuale. Si può tenere con «Mantieni attuale» o scrivendo ok. Il preventivo di partenza non cambia. Se per quel prodotto non c'è nulla di modificabile, il bot lo dice e torna al menu. Il pulsante «Modifica preventivo» sotto il messaggio di fine richiesta fa la stessa cosa, e compare solo se ci sono dati modificabili.

5. Nuova offerta di fornitura

È il percorso di preventivazione per chi vende energia. Su Mediatore DEMO si chiama Nuova offerta e il codice del percorso è fornitura. Le domande, le stesse descritte per GBD in configurazione, sono queste:

Profilo: abitazione privata oppure azienda o partita IVA.
Fornitura: luce, gas, oppure luce e gas.
Per un privato, se la fornitura è la residenza principale o una seconda casa. Per un'azienda, bassa o media tensione.
Spesa media mensile in euro (per luce e gas insieme, il totale).
Riepilogo e conferma.

Alla conferma il programma non chiama un CRM di preventivazione. Stima il consumo dalla spesa e, tra i prodotti energia attivi dell'azienda, sceglie per ogni fornitura il più conveniente adatto a profilo, residenza o tensione e consumo. Il messaggio indica il nome dell'offerta, una spesa mensile indicativa e, se c'è, il risparmio annuo stimato. Per la media tensione aggiunge che il prezzo finale si definisce con una consulenza. Se nessun prodotto è adatto, rimanda al customer care. La stima è dichiarata indicativa. Anche qui nasce un codice pratica, da usare per la sottoscrizione.

Su GBD Energy la voce di menu ha lo stesso titolo, «Nuova offerta», ma apre il percorso richiesta di GBD, oggi senza domande (vedi la sezione aziende).

6. Perfezionamento

Finanziamento

Voce Perfeziona Finanziamento (Races e Mediatore DEMO). L'elenco propone gli ultimi 5 preventivi da perfezionare e le pratiche già inviate a cui manca ancora un documento obbligatorio. Si può anche scrivere il codice.

Conferma che è la pratica giusta. Il bot mostra il riepilogo del preventivo. Se la pratica è già perfezionata ma manca un documento obbligatorio, si passa al caricamento, senza rifare i dati.
Elenco dei documenti del prodotto e link dell'informativa privacy da far firmare.
Informativa firmata (foto o PDF). Finché non risulta verificata, gli altri documenti restano in attesa e non vengono letti.
Documento d'identità e codice fiscale. Il documento di reddito si può saltare. Un documento già ricevuto e non respinto non viene richiesto di nuovo.
Attesa dei controlli. Il bot riparte da solo a controlli finiti. Con avanti si prosegue prima.
Conferma dei dati letti, se ce ne sono: «Sì, confermo» li tratta come risposte; «No, li inserisco io» li scarta e le domande si compilano a mano. Un dato letto non valido (formato, opzione, controllo) viene rifiutato e richiesto di nuovo, con il motivo.
Domande rimaste: codice fiscale (da cui il bot ricava data di nascita, sesso e luogo, e rifiuta un minorenne), cognome e nome, coerenza col codice fiscale, residenza, stato civile, documento, telefono, email, contatto diretto, IBAN, datore di lavoro oppure ragione sociale e partita IVA.
Riepilogo finale e Invia in istruttoria. Se qualche documento è ancora in controllo, l'invio non parte: il bot chiede di aspettare l'esito.

Nel riepilogo lo stato dei documenti è: ✅ a posto, 📎 ricevuto e in verifica, ⚠️ da correggere, ➖ mancante.

Se un controllo non passa

Alla ricezione di un file il bot risponde subito «Documento ricevuto» e, se la lettura automatica è attiva, che scriverà l'esito. Il controllo gira dopo, e il risultato arriva come messaggio WhatsApp sulla stessa chat.

Informativa accettata: «è il nostro modulo ed è firmato.» Da quel momento partono i documenti che erano in attesa.
Informativa rifiutata: «non la posso accettare», con il motivo (non è il modulo, non è firmata, oppure non è leggibile). Gli altri documenti restano in attesa. Si invia di nuovo il file.
Altro documento a posto: «controllo completato, nessuna differenza con i dati inseriti.»
Altro documento con differenze: elenco dei problemi e l'invito a inviarne uno corretto da Stato Pratiche → Carica documenti. Sul documento della pratica lo stato diventa rifiutato; l'allegato risulta difforme o non leggibile.
Lettura non riuscita: il file è stato ricevuto, il controllo automatico non è stato fatto, lo vedrà l'istruttore (allegato «non analizzato»).
In attesa dell'informativa: il file è ricevuto e sarà controllato quando l'informativa risulta verificata.

I controlli predefiniti sono, per identità e codice fiscale, tipo di documento, coerenza con i dati noti ed estrazione; per il reddito, tipo e coerenza; per l'informativa, che sia il modulo firmato. Un passo del percorso può averne di propri. Il primo controllo che fallisce ferma la catena: non si propongono dati da quel documento.

Se la lettura automatica è spenta, il file viene solo archiviato: non parte l'analisi e non arriva l'esito su WhatsApp. Dal pannello l'operatore approva o rifiuta a mano. Approvare l'informativa sblocca i documenti in attesa.

Una risposta di testo che non supera il controllo (codice fiscale, IBAN, email, età, e gli altri agganciati alla domanda) non viene salvata: il bot ripete la domanda con il messaggio di errore di quel controllo.

Sottoscrizione di un contratto di fornitura

Su Mediatore DEMO la voce è Sottoscrivi contratto (percorso sottoscrizione). Chiede il codice, l'informativa firmata, poi bolletta, documento d'identità, visura camerale se il preventivo è di un'azienda, ed estratto conto o IBAN. Questi documenti, tranne l'informativa, si possono saltare. Dopo l'attesa e la conferma dei dati letti, il bot chiede solo ciò che manca: per un'azienda parte dalla partita IVA e, se il Registro Imprese risponde, compila ragione sociale e sede; poi codice fiscale e generalità di chi firma, POD e PDR secondo la fornitura, fornitore attuale, pagamento (addebito in conto o bollettino), recapiti e il consenso a essere ricontattati. Il riepilogo chiede «Invia per la firma».

Quella conferma usa lo stesso invio del finanziamento: CRM se l'azienda ne ha uno, altrimenti email con dati e allegati. L'invio dei moduli al cliente per la firma con OTP avviene solo se l'azienda è impostata per produrre i documenti dal core (flag attivo, società del core e tipo pratica). Oggi nessuna delle tre aziende lo è, quindi la sottoscrizione non manda l'SMS di firma: la pratica risulta perfezionata e inviata in istruttoria, e parte l'avviso verso UnicoBPM descritto più sotto. Per un privato di un'azienda energia, dopo l'invio riuscito, il recupero dei dati catastali parte in background: se non si avvia, la pratica resta comunque perfezionata.

✅ Pratica PM-1007-1435 perfezionata e inviata in istruttoria al mediatore creditizio.

Invio pratica fallito, riprovare o contattare Istruttoria: l'invio non è andato a buon fine. La pratica non è stata segnata come perfezionata e i dati restano nel riepilogo. Si tocca di nuovo Invia in istruttoria (o Invia per la firma, nella fornitura). Se continua, si controlla il CRM o la casella dell'istruttoria, come nella sezione consegna.

7. Stato Pratiche

Voce presente per Races e per Mediatore DEMO (percorso documenti). Non è nel menu di GBD Energy.

Elenco delle ultime 10 pratiche di chi scrive.
Documenti in Obbligatori, Facoltativi e Integrazioni richieste, con lo stato e l'ultima nota.
Carica documenti: si sceglie il tipo e si invia foto o PDF. Un file nuovo sostituisce il precedente nella verifica. Si può tornare in giorni diversi.

Per caricare serve l'informativa già ricevuta: altrimenti il bot non apre il caricamento. Se dal pannello un operatore rifiuta un documento o chiede un'integrazione, l'agente riceve un messaggio WhatsApp con la nota.

8. Consegna al CRM

Ogni azienda ha un solo CRM, scelto in Aziende → CRM dell'istruttoria. Alla conferma del perfezionamento il programma chiama quel CRM. La risposta attesa è il codice HTTP 200. Qualsiasi altro esito, o un servizio irraggiungibile, è un fallimento: l'agente vede il messaggio della sezione precedente e può riprovare dallo stesso riepilogo. Nei log restano il tipo di errore e il codice, non i dati del cliente.

Se nella configurazione dell'applicazione il driver globale del CRM è simulated, la conferma risponde con la simulazione (di norma 200) e non chiama il CRM scelto in scheda, per nessuna azienda. È l'impostazione di sviluppo e test. In esercizio quel valore non deve essere simulated.

Scelta in scheda	Cosa succede all'invio
Vuota	Mediafacile se c'è l'URL dell'istruttoria; altrimenti email.
Solo email	Nessun CRM. Dati e allegati alla casella dell'istruttoria dell'azienda (se manca, alla casella indicata in configurazione). La pratica è inviata solo se la mail parte. In scheda pratica, la colonna Inviata per email mostra l'orario.
Mediafacile	Caricamento del lead con una chiamata al servizio (risposta XML). Vale 200 solo se lo stato inizia con OK. L'identificativo restituito, se c'è, finisce sulla pratica. I file non partono con questa chiamata: l'email, quando è il canale usato, è quella che porta gli allegati.
CRM generico (REST)	Una chiamata HTTPS configurata in scheda: indirizzo, metodo, formato JSON o form, autenticazione, modello del corpo, codici di successo e dove leggere l'esito e l'id. Senza modello si invia il formato unico (riferimento, prodotto, risposte, cliente, agente, consenso, elenco documenti senza il contenuto dei file). L'id letto nella risposta è salvato sulla pratica.
unicofinance	Il contratto descritto sotto. È il driver di Races Finance.

unicofinance, a livello operativo

La scheda azienda contiene l'indirizzo di base (https), il token e il segreto. Si ottengono in unicofinance con il comando che registra il client unicoagent; i valori si inseriscono una volta e non si riportano nei messaggi. L'autenticazione è un token Bearer e una firma HMAC: il dettaglio è in docs/agent-api.md di unicofinance.

Alla conferma, in modo sincrono, UnicoAgent crea cliente e pratica con POST /api/agente/v1/richieste. L'operazione è idempotente sul codice pratica di UnicoAgent: un nuovo tentativo non duplica la richiesta. Sulla pratica viene salvato il codice restituito dal CRM. Mancano il codice fiscale del cliente o la partita IVA dell'agente, oppure l'indirizzo, il token o il segreto: l'invio non parte e l'agente vede il fallimento. Un rifiuto del CRM (per esempio cliente già di un altro agente, o agente sconosciuto) è lo stesso fallimento, con il codice di errore solo nei log.

Se questa prima chiamata riesce, la pratica è perfezionata e parte un job che consegna i file non ancora inviati, uno alla volta, con POST /api/agente/v1/richieste/{codice}/documenti. Si saltano i documenti rifiutati e quelli senza file. Un file già consegnato non viene rimandato. Insieme al file parte l'esito dell'analisi già fatta qui (solo esito, tipo e differenze; i dati letti si aggiungono se in scheda l'analisi è impostata su «anche i dati letti»).

Lo stesso driver sa anche, senza che la chat WhatsApp li chiami ancora:

elencare i moduli della pratica e scaricare il PDF vuoto;
compilare un modulo con i dati della pratica (stampa sul core) ;
chiedere la firma con OTP e leggerne lo stato: inviata, firmata, rifiutata, scaduta o errore;
scaricare il PDF firmato, se c'è, altrimenti l'originale.

Il codice del modulo, in queste chiamate, è l'identificativo del modulo in unicofinance. Il riferimento della firma è l'identificativo del documento lì.

Cosa vede l'operatore se l'invio fallisce, e come si riprova

Fallisce la pratica (CRM o email): su WhatsApp l'agente ha «Invio pratica fallito, riprovare o contattare Istruttoria» e il riepilogo è ancora lì. Nel pannello la pratica non risulta perfezionata. Si riprova dalla chat. In alternativa, dall'elenco pratiche, si selezionano le righe e si usa Invia per email (forza): rimanda dati e allegati all'istruttoria anche se un invio email c'era già. Non richiama il CRM.
La pratica è arrivata e falliscono i documenti (solo un CRM che li accetta, oggi unicofinance): la pratica è già perfezionata. Il job SendDocumentsToCrm riprova da solo fino a 5 volte, con attese di 1 minuto, 5 minuti, 15 minuti e 1 ora. In più, ogni ora, il comando crm:send-documents rimette in coda le pratiche perfezionate che hanno ancora allegati non consegnati. A mano: php artisan crm:send-documents --loan=CODICE. I file già segnati come consegnati non ripartono.
UnicoBPM: a perfezionamento riuscito, se l'azienda non produce i documenti per la firma, parte l'evento pratica.perfezionata (prodotto, codice pratica del CRM, nome e partita IVA dell'agente; niente dati del cliente né file). Il job ritenta dopo 1, 5 e 15 minuti, poi dopo 1 e 4 ore. Senza indirizzo e chiave del bridge, o per una pratica di prova, non si invia nulla. Un secondo invio dello stesso codice non apre due processi.

9. Il pannello

Si apre da /admin con email e password. Il menu laterale ha Pratiche, Conversazioni, il gruppo Settings (Percorsi di configurazione, Documenti per il finanziamento, Controlli sulle risposte) e il gruppo Anagrafiche (Azienda, Produttori, Utenti). Lo switch azienda filtra le tabelle sulla company scelta.

Dashboard

Da fare adesso: documenti rifiutati, documenti non letti dall'AI, informative da verificare, pratiche perfezionate negli ultimi 7 giorni.
Integrazioni: stato di WhatsApp, analisi AI e pulizia automatica.
Ultimi 7 giorni: pratiche nuove per stato, pratiche vicine alla cancellazione, conversazioni attive e ferme.
Verifica WhatsApp legge i dati del numero e non manda messaggi. Verifica AI fa una richiesta minima: dice se la chiave è valida e se il credito è esaurito. L'importo residuo non è disponibile via API.

10. Pratiche e documenti

Pratiche elenca le richieste, con filtri per stato, origine (reale o di prova) e prodotto. La scheda mostra codice, agente, stato, quando è stata ricevuta e verificata l'informativa, le risposte del preventivo, i dati personali e le difformità segnalate dal bot.

Recapiti del cliente: cellulare, email e il flag di contatto diretto. Sono cifrati come gli altri dati personali.
Documenti della pratica: stato Da ricevere, Ricevuto, OK, Rifiutato, Integrazione richiesta, e le note di AI e operatore. Azioni: Approva, Rifiuta (la nota arriva su WhatsApp), Chiedi integrazione, Richiedi un documento integrativo.
Dati letti dai documenti: Proposto, Confermato o Rifiutato. Sola lettura.
Allegati: esito Verificato, Difforme, Non leggibile, Non analizzato, In attesa informativa, e le differenze trovate.

Informativa: finché non è verificata, i documenti della pratica non vanno all'AI. Se la lettura la rifiuta, Approva sul documento Informativa firmata fa partire l'analisi di quelli in attesa.

Conversazioni mostra numero, fornitore, percorso, domanda corrente e stato. I dati in corso non sono visibili: si cancellano quando la conversazione si chiude. I dati definitivi stanno sulla pratica.

11. Percorsi di configurazione

Le domande stanno nelle tabelle e si modificano senza programmare, per ogni azienda. Per ogni percorso si cambiano intestazione, testi, opzioni, salti, domande saltabili e controlli. Il pannello rifiuta i salvataggi che bloccherebbero gli agenti (salti mancanti, troppe opzioni per WhatsApp, testi troppo lunghi).

Crea copia di prova e lavoraci senza toccare la produzione.
Chi ha il numero associato al proprio utente vede le voci «Prova: …» e le pratiche nascono come prova.
Pubblica in produzione. Rifai la copia di prova riparte dalla produzione.

Altri pulsanti: Grafo delle domande ed Esporta configurazione. Su una domanda a scelta, Modificabile nel preventivo la include nella modifica del preventivo. Sulle domande di file si agganciano i controlli documento; sulle altre, i controlli sulla risposta.

Documenti per il finanziamento: catalogo per tipo di finanziamento. Il nome sta nella lista WhatsApp (massimo 24 caratteri). Le modifiche valgono per le pratiche nuove.

Controlli sulle risposte: elenco, con dove sono usati. Cerca nuovi controlli registra le classi aggiunte al programma. Un controllo usato da una domanda non si disattiva.

Una voce di menu può essere il codice di un percorso di quell'azienda, non solo le quattro voci standard. È così che Mediatore DEMO aggiunge fornitura e sottoscrizione accanto a Richiedi, Modifica, Perfeziona e Stato.

12. Anagrafiche

Azienda

Una scheda per company. I dati del titolare compaiono nell'informativa pubblica. In sintesi operativa:

Campo	Effetto
Ragione sociale, sede, email privacy, DPO	Titolare nell'informativa e nella pagina di trasparenza.
Settore e prodotti attivi	Finance, call center, hotel o energia, e i prodotti del catalogo. Per l'energia, i prodotti attivi sono quelli tra cui si sceglie l'offerta.
Telefono ed email del customer care	Indicati al segnalatore occasionale e quando non si calcola un'offerta.
Email dell'istruttoria	Per la pratica perfezionata, la casella dell'azienda del numero WhatsApp. Per il solo preventivo di finanziamento, la casella della prima azienda in archivio. Se la casella manca, si usa quella indicata in configurazione.
URL del preventivatore	Se compilato, il preventivo di finanziamento chiede gli importi al CRM. Se vuoto, parte l'email.
CRM dell'istruttoria	Un solo driver per azienda, come nella sezione consegna. La configurazione (indirizzi, token, segreti) resta in scheda e non va copiata altrove.
Voci del menu WhatsApp	Se compilate, sostituiscono del tutto il menu predefinito. Vuote, resta Richiedi / Modifica / Perfeziona / Stato.
Società del core e tipo pratica	Insieme al flag di produzione documenti, abilitano moduli e firma OTP. Senza questi tre elementi la firma dalla chat non parte.

Produttori

Anagrafica dei fornitori attivi, sul core. La sigla apre il codice dei preventivi: se è vuota, il programma la ricava dal nome e la salva. Il cellulare è quello con cui forWhatsApp riconosce chi scrive. I numeri sconosciuti che completano un preventivo compaiono come Segnalatore occasionale, non attivi: per convenzionarne uno si correggono i dati, il tipo e il flag attivo, e si indica l'azienda.

Utenti

Chi accede al pannello. Il numero WhatsApp dell'utente abilita le voci di prova nel menu del bot.

13. Dati personali

Il preventivo di finanziamento è anonimo. I dati personali si raccolgono dopo l'informativa firmata, con data e ora.
I dati personali sono cifrati. I file stanno in un archivio privato, non raggiungibile da internet.
Le pratiche non perfezionate sono cancellate, con i file, dopo il periodo di conservazione (30 giorni se non diversamente impostato). Eliminare una pratica dal pannello cancella documenti e conversazioni collegati.
Per la cancellazione chiesta da un cliente: Cancellazione dei dati. Per il trattamento: Informativa privacy e Trasparenza e conformità.

14. Se qualcosa non funziona

Sintomo	Cosa controllare
Il bot non risponde	Dashboard → Verifica WhatsApp. Un token scaduto è la causa più comune: va rigenerato e aggiornato nella configurazione del server, non in questo manuale.
Menu di un'altra azienda	Il cellulare è di un fornitore attivo di quell'azienda, oppure non è in anagrafica e quindi vale Mediatore DEMO.
«Questo servizio non è ancora attivo»	Il percorso scelto non ha un albero pubblicato per quell'azienda. È il caso, oggi, di Nuova offerta e Sottoscrivi contratto su GBD Energy.
I documenti restano in attesa	L'informativa non è verificata. In pratica, documento Informativa firmata: Approva, oppure chiedi un nuovo invio.
I documenti non vengono letti	Dashboard → Verifica AI. Nel frattempo si controllano a mano.
Invio pratica fallito	Scheda azienda: driver, e per unicofinance indirizzo, token e segreto; per l'email, la casella e la posta. Se il driver globale è `simulated`, il CRM reale non viene chiamato. L'agente riprova dal riepilogo, oppure si usa Invia per email (forza).
La pratica c'è nel CRM ma mancano i file	Solo unicofinance consegna i file dopo. Il job ritenta da solo; altrimenti `php artisan crm:send-documents --loan=CODICE`.
Le pratiche scadute non si cancellano	In dashboard la pulizia risulta mai eseguita: manca la pianificazione sul server (il comando previsto è giornaliero).
Una domanda del bot è sbagliata	Percorsi di configurazione della company → copia di prova → prova dal menu → pubblica.

↑ Torna all'inizio