Il bot WhatsApp che, prima di rispondere, ha studiato le chat degli operatori.
Nei ricambi auto ogni messaggio su WhatsApp è un piccolo esame tecnico, fatto di codici, compatibilità e targhe. Per un'azienda di ricambi auto ho costruito un assistente AI che cerca nel catalogo del gestionale, riconosce i codici OEM e passa la chat a un operatore quando serve. Invece di farlo rispondere subito ai clienti, l'ho messo in modalità ombra: registra le chat gestite dagli operatori e le usa per la sua base di conoscenza.
> filtri: eco del bot, duplicati, lunghezza, frequenza ok
[!] modalità ombra: il bot non risponde al cliente
> risponde l'operatore · la conversazione resta registrata
$esporta --chat --verso base-di-conoscenza
[✓] il bot impara dalle risposte vere
Modalità ombraimpara dalle chat degli operatori
Risposte automatichesolo in modalità test
Log illustrativo, nessun dato reale
Il problema
Nei ricambi auto una chat non è mai solo una domanda.
Chi cerca un ricambio su WhatsApp scrive come parla: una foto del libretto, un codice letto sul pezzo vecchio, una targa, e poi la domanda di sempre: «va bene per la mia?».
Dietro ogni messaggio c'è una verifica tecnica: il codice originale, la compatibilità, la versione del motore. Prima di poter rispondere davvero, gli operatori ripetono le stesse domande, chat dopo chat. È lavoro necessario, ma sempre uguale.
Sono domande giuste e ripetitive, e qui un assistente può fare il primo passo al posto dell'operatore, purché sappia quando fermarsi e passare la mano.
OperatoreBuongiorno, di che marca e modello è l'auto?
OperatoreDi che anno è?
OperatoreMi manda la targa o una foto del libretto?
OperatoreC'è un codice scritto sul pezzo vecchio?
Esempi di domande ricorrenti, scritti per questa pagina: non sono chat reali.
Cosa fa
Un assistente che conosce il catalogo e i propri limiti.
Riceve i messaggi WhatsApp, cerca nel catalogo del gestionale Ready Pro e in una base di conoscenza, prepara la risposta con un modello linguistico e, quando serve, passa la conversazione a un operatore tramite Bitrix24.
Cerca nel catalogo del gestionale
Legge il catalogo di Ready Pro in sola lettura: può consultare, non modificare. Ogni notte una sincronizzazione porta il catalogo nella base di conoscenza.
Riconosce i codici
Estrae dal testo i codici OEM e SKU e li usa per cercare tra prodotti e conoscenza, con una ricerca ibrida che unisce codici e significato.
Raccoglie i dati del veicolo
In modalità Apprendista chiede marca, modello, anno e targa, poi apre un affare in Bitrix24 con lo storico della conversazione.
Passa la mano
Quando la richiesta va oltre, la conversazione arriva a un operatore tramite Bitrix24. L'ultima parola resta alle persone.
Capisce i vocali
I messaggi vocali vengono trascritti in locale con Whisper, sul server: l'audio non va a un servizio di trascrizione esterno.
Come funziona
Dal messaggio del cliente alla risposta, o all'operatore.
Segui un messaggio dentro il sistema: scegli un passo, oppure usa le frecce della tastiera quando l'elenco è selezionato.
Passo 01 · WhatsApp
Il cliente scrive, come ha sempre fatto
Manda una richiesta, una foto del libretto, un codice o un vocale. Per chi scrive non cambia nulla: non deve installare app né compilare moduli.
È il punto di partenza di tutto il resto, e il motivo per cui il bot deve essere prudente: dall'altra parte c'è un cliente vero.
Passo 02 · Canale
Il messaggio passa da Wazzup24
Il bot si appoggia a Wazzup24, integrato come canale WhatsApp: ogni nuovo messaggio arriva al sistema tramite webhook.
Lo stesso canale lo usano gli operatori, ed è per questo che il bot deve saper distinguere i propri messaggi da quelli di una persona (lo vedi al passo 04).
Passo 03 · Ingresso
Una porta sola, con il certificato in regola
Davanti a tutto c'è IIS come reverse proxy, con certificati rinnovati in automatico. Dietro, l'applicazione FastAPI gira come servizio Windows.
Se il servizio si ferma, un watchdog lo riavvia. Un controllo di salute verifica anche il database.
IISFastAPIservizio Windowswatchdog
Passo 04 · Webhook
Prima di pensare, il bot filtra
Il webhook è il primo controllo. Qui il messaggio viene:
scartato se è l'eco di un messaggio del bot stesso;
riconosciuto se è un comando dell'operatore;
scartato se è un duplicato;
scartato se supera i 1.500 caratteri o se la chat scrive con una frequenza anomala;
fermato dalla modalità test, che fa rispondere il bot solo a un elenco di numeri ammessi.
Passo 05 · Orchestratore
Cosa vuole davvero il cliente?
L'orchestratore riconosce l'intento del messaggio tra quattro possibilità e sceglie con quale dei quattro ruoli rispondere.
escalationordineprodottogenerale
L'intento «escalation» porta dritto all'operatore, al passo 07b.
Passo 06 · Ricerca
Una ricerca ibrida, fatta per i codici
La risposta si costruisce su fonti, non sull'immaginazione del modello:
ChromaDB con due collezioni vettoriali: prodotti e conoscenza;
embedding multilingue e5-small, per cercare per significato;
estrazione dei codici OEM e SKU dal testo, per cercare per codice;
il catalogo Ready Pro, consultato in sola lettura.
Con i dati trovati, il modello linguistico (OpenAI GPT-4o) prepara la risposta, che torna al cliente nella stessa chat.
Durante il pilota questo passo era acceso solo in modalità test, per un elenco di numeri ammessi. Sulle chat reali il bot è rimasto in ombra, e più sotto spiego perché.
Passo 07b · Operatore
La conversazione passa a una persona
Quando serve, la chat va a un operatore tramite Bitrix24, con la gestione dell'escalation e degli affari. In modalità Apprendista il bot apre un affare con marca, modello, anno, targa e lo storico della conversazione: l'operatore non riparte da zero.
Dal pannello di amministrazione si vede anche la coda degli operatori.
Intorno al flusso
sincronizzazione notturna catalogo → base di conoscenzawatchdog che riavvia il serviziotrascrizione vocale locale (Whisper)accensione e spegnimento per giorno e oracontrollo di salute del databasebridge MCPpannello admin: statistiche, configurazione, log, coda operatori, riavvio
I ruoli dell'agente
Quattro ruoli, un solo agente.
Una richiesta di disponibilità e un dubbio dopo l'acquisto non si trattano allo stesso modo. Dall'intento riconosciuto, l'agente sceglie il ruolo con cui rispondere.
Commerciale
Per chi cerca un prodotto o vuole ordinare.
Tecnico
Per codici e dettagli del ricambio.
Post-vendita
Per chi ha già acquistato e torna a scrivere.
Apprendista nella simulazione
Raccoglie marca, modello, anno e targa, poi apre un affare in Bitrix24 con lo storico della conversazione.
Qualunque sia il ruolo, l'escalation verso un operatore resta sempre una delle strade possibili.
Ricambi Esempio · assistente AIsimulazione · dati inventati
Assistente AIBuongiorno, sono l'assistente virtuale del negozio, un sistema di intelligenza artificiale. Mi dica marca, modello, anno e targa del veicolo: preparo la richiesta per un operatore.
Cliente di provaCerco un alternatore per una Marca Esempio modello Demo del 2015.
Assistente AIGrazie. Mi manda anche la targa? Serve all'operatore per verificare il codice originale.
Cliente di provaTarga XX000XX
Apprendista · affare aperto in Bitrix24 con lo storico
OperatoreBuongiorno, ho già i suoi dati: verifico il codice e le scrivo qui.
Simulazione illustrativa con dati inventati: nessun cliente, numero o veicolo reale. Nel pilota le risposte automatiche erano attive solo in modalità test.
Protezioni
Un bot su WhatsApp è anche una porta aperta. L'ho costruito pensando a chi prova a forzarla.
Da Certified Ethical Hacker, prima ancora di chiedermi cosa sa fare un bot mi chiedo cosa può andare storto.
Contro la prompt injection
Protezioni contro i messaggi scritti apposta per fargli cambiare comportamento o rivelare istruzioni.
Dati personali mascherati
Il bot maschera i dati personali che trova nei messaggi: meno dati in chiaro, meno danni se qualcosa va storto.
Limiti di frequenza
Rate limit sulle API e scarto delle chat troppo frequenti e dei messaggi oltre 1.500 caratteri.
Modalità test
Le risposte automatiche partono solo verso un elenco di numeri ammessi. Tutti gli altri restano agli operatori.
Orari programmati
Accensione e spegnimento per giorno e ora: il bot lavora solo nelle fasce decise dall'azienda.
Pannello con token e whitelist IP
Il pannello di amministrazione si apre solo con token e da indirizzi IP autorizzati.
Le stesse domande le faccio prima di mettere online qualsiasi assistente: le trovi nella pagina sui chatbot e agenti AI.
Perché in modalità ombra
Prima ascoltare, poi forse rispondere.
Un bot che sbaglia un codice ricambio fa partire il pezzo sbagliato.
Per questo ho scelto la strada lenta.
Da maggio a settembre 2026 il bot ha lavorato in ombra sulle chat reali: ha registrato le conversazioni gestite dagli operatori senza rispondere ai clienti, e quelle conversazioni sono diventate materiale per la sua base di conoscenza.
Le risposte automatiche le ho accese solo in modalità test, per un elenco di numeri ammessi. Il flusso completo esiste; sulle chat reali, però, un assistente che parla a nome di un'azienda deve prima imparare dalle risposte di chi quel lavoro lo fa ogni giorno.
Se stai pensando a un bot per la tua azienda, ti propongo lo stesso percorso: prima osserviamo le tue chat, poi decidiamo insieme cosa automatizzare.
Le versioni del bot nel 2026
25 marv1.5.0
Canale, ricerca e gestionale
Canale Wazzup, ricerca RAG e lettura del gestionale Ready Pro.
12 aprv2.0.0
Nuova architettura
Passaggio a FastAPI dietro IIS e pannello di amministrazione.
16 aprv2.1.0
Bitrix24 e sicurezza
Escalation e affari su Bitrix24, misure di sicurezza.
29 aprv2.2.0
Protezioni e orari
Protezioni, programmazione oraria e bridge MCP.
mag–setpilota
Pilota in modalità ombra
Il bot ascolta le chat reali e impara dagli operatori. Risposte automatiche solo in test.
Com'è fatto
I numeri del cantiere, non quelli dei clienti.
Qui misuro il lavoro di costruzione: righe di codice, moduli, commit. Le conversazioni e i dati commerciali restano dell'azienda e non finiscono su questa pagina.
Dove sta il codice
Righe di codice proprio per area del progetto, 17.936 in totale.
Fonte: conteggio delle righe del codice proprio del bot (scheda tecnica del progetto, novembre 2026). Escluse librerie e componenti di terzi.
Vedi i dati in tabella
Righe di codice del bot per area
Area
Righe
Quota
RAG (ricerca e conoscenza)
8.090
45,1%
Radice (main.py e avvio)
2.116
11,8%
Pannello di amministrazione
2.069
11,5%
Utilità (utils)
1.782
9,9%
Script di servizio
922
5,1%
Agente (orchestratore e ruoli)
862
4,8%
Database
836
4,7%
API
649
3,6%
Integrazioni
483
2,7%
Watchdog
127
0,7%
Totale
17.936
100%
Quando si è lavorato
Commit al mese nel repository, aprile–ottobre 2026. Ottobre riguarda syncro, non il bot.
Fonte: storico git del repository, che dal 14 aprile 2026 contiene anche syncro. Per tipo: 67 nuove funzioni, 41 correzioni, 7 riorganizzazioni, 7 documentazione, 4 manutenzione, 1 prestazioni, 1 rilascio.
Vedi i dati in tabella
Commit al mese nel repository, aprile–ottobre 2026
Librerie affermate alla base, codice mio per le parti su misura.
Wazzup24, Ready Pro e Bitrix24 li ho integrati, non riscritti. Il codice scritto da me sta nella ricerca sui codici, nei filtri del webhook, nell'orchestratore e nel pannello di amministrazione.
OpenAI GPT-4oChromaDBsentence-transformerse5-small multilingueWhisper in locale
Dati e server
SQLiteSQL Server ExpresspyodbcIISPowerShell
Integra
Wazzup24Ready Pro, sola letturaBitrix24
Il tuo pilota
Anche a te arrivano le stesse domande su WhatsApp?
Partiamo da un pilota, anche in ombra: prima guardiamo come rispondono oggi le tue persone, poi decidiamo insieme cosa può fare un assistente e dove deve fermarsi.
Raccontami cosa vuoi proteggere, costruire o far crescere. Ti aiuto a capire da dove partire.
Di cosa mi occupo
Da oltre trent'anni faccio tre cose. Cerco le falle della tua azienda prima che le trovi chi vuole entrare. Imposto il marketing perché i risultati si possano misurare. E aiuto persone e aziende a capire chi sono, prima ancora di decidere cosa vendere.
Uso cookie tecnici necessari. Con il tuo consenso attivo anche Google Analytics e Google Ads per misurare le visite. Puoi cambiare idea quando vuoi. Cookie policy
WhatsApp · richiesta guidata
Quattro domande, poi mi scrivi.
Così non devo chiederti in chat le stesse cose e la mia prima risposta parla già del tuo caso. Ci vuole meno di un minuto.
Passo 1 di 4
Disclaimer legale
Marchi e indipendenza professionale
Indipendenza da Google LLC
Questo sito è un progetto indipendente e non è affiliato, autorizzato o sponsorizzato da Google LLC. I marchi Google Ads, Analytics e BigQuery sono di proprietà esclusiva di Google LLC.
Indipendenza da Meta Platforms
I servizi offerti non sono associati, approvati o sponsorizzati da Meta Platforms, Inc. Facebook e Instagram sono marchi registrati di Meta.
Certificazioni ufficiali
Le certificazioni esposte attestano il superamento degli esami tecnici ufficiali ma non configurano un rapporto di dipendenza con i fornitori delle tecnologie.
