Come usare Google Sheets come base di conoscenza per l’IA su WhatsApp

Come organizzare le informazioni operative per l'IA su WhatsApp

Prezzi, regioni servite, caratteristiche dei prodotti, tempistiche e domande frequenti spesso sono sparsi tra messaggi, documenti e fogli di calcolo differenti. Quando il team aggiorna un'informazione in un posto, l'agente IA può continuare a usare un'altra versione o non trovare il dato necessario.

Un'integrazione tra WhatsApp e Google Sheets può trasformare un foglio organizzato in fonte di conoscenza per l'agente. Il team mantiene i dati in un ambiente familiare, mentre la base sincronizzata viene usata per guidare le risposte su WhatsApp.

Questo flusso è adatto a informazioni tabulari e relativamente semplici. Non trasforma il foglio in un database completo, non promette query in tempo reale a ogni messaggio e non esporta conversazioni in celle. In questa guida imparerai come preparare il foglio, testare le risposte e riconoscere quando una API è l'opzione più appropriata.

Cosa significa collegare Google Sheets a WhatsApp?

Nel flusso documentato di Whatsplaid, Google Sheets viene collegato all'interno della Knowledge Base dell'assistente. La direzione può essere riassunta così: Google Sheets → Knowledge Base → risposte dell'agente.

Dopo che l'account Google è connesso e un foglio è selezionato, il sistema prepara la prima scheda disponibile per la sincronizzazione. Il contenuto processato diventa parte delle fonti che l'agente può consultare durante le conversazioni.

Questo non significa che WhatsApp legga le celle direttamente da solo. Il canale riceve i messaggi, l'agente interpreta la domanda e usa la versione del foglio messa a disposizione nella Knowledge Base per formulare la risposta.

Qual è il ruolo di ogni componente?

• Google Sheets: luogo in cui il team organizza e mantiene le informazioni tabulari.
• Knowledge base: insieme di fonti autorizzate che guidano le risposte dell'IA.
• Agente IA: interpreta la domanda e utilizza le fonti disponibili all'interno delle istruzioni configurate.
• WhatsApp: canale in cui avviene la conversazione.

Per conoscere altre fonti e il ruolo di istruzioni, limiti e test, vedi come funziona una knowledge base per IA.

Come funziona il foglio come fonte per l'IA?

Il foglio presenta informazioni in righe e colonne. Dopo la sincronizzazione e il processamento, l'agente può usare questo contenuto per rispondere a domande relative all'ambito configurato.

Immagina un'azienda che mantiene una tabella con servizi, città servite, tempo stimato e requisiti. Quando una persona chiede se un dato servizio è disponibile nella sua città, l'agente può consultare la fonte sincronizzata e rispondere in base ai dati trovati.

La qualità dipende da quattro fattori:

• struttura: colonne chiare e record coerenti;
• contenuto: informazioni corrette, complete e non contraddittorie;
• aggiornamento: versione sincronizzata compatibile con l'operazione attuale;
• istruzioni: definizione di come l'agente deve usare la fonte e quando non deve rispondere.

L'IA capisce qualsiasi foglio di calcolo?

Non si dovrebbe presumere. Fogli con titoli vaghi, celle unite, più tabelle nella stessa scheda o valori senza contesto rendono difficile l'interpretazione. La struttura deve essere preparata per la consultazione, non solo per la lettura visiva del team.

Il foglio sostituisce le istruzioni dell'agente?

No. Il foglio fornisce dati. Le istruzioni determinano obiettivo, tono, limiti e comportamento di fronte a informazioni mancanti o ambigue. Un chatbot IA per WhatsApp deve combinare conoscenza, configurazione e test.

Quali dati possono essere organizzati?

Google Sheets è utile quando l'informazione rientra in una tabella semplice e può essere mantenuta dal team. Alcuni esempi sono:

• catalogo sintetico di prodotti o servizi;
• nomi, categorie e descrizioni;
• regioni, unità o aree servite;
• orari e canali di servizio;
• requisiti per assumere o richiedere un servizio;
• elenchi di opzioni disponibili;
• politiche riassunte e i loro criteri;
• domande frequenti con risposte approvate;
• codici o identificatori non sensibili;
• informazioni operative aggiornate dal team.

Cosa non mettere nel foglio di calcolo?

Non usare il foglio come luogo per conservare password, token, chiavi API, credenziali o segreti. Evita anche dati personali o sensibili che non siano strettamente necessari e autorizzati allo scopo.

Prima di connettere, valuta chi accede al foglio, quali dati vengono trattati, per quanto tempo vengono conservati e se l'agente ne ha davvero bisogno. L'operazione deve rispettare la LGPD e altri obblighi applicabili.

Un foglio di calcolo è un database?

Non nel senso di un sistema transazionale completo. Un foglio può servire come fonte tabellare modificabile per informazioni operative, ma non offre di default le stesse garanzie, controlli, relazioni e meccanismi di query di un database o sistema specializzato.

Come strutturare colonne e righe per le query?

Una buona struttura consente a ogni riga di rappresentare un record e a ogni colonna di avere un significato stabile. La prima riga dovrebbe contenere nomi di campo chiari.

I nomi sopra sono esempi. La struttura corretta dipende dalle domande a cui l'agente deve rispondere.

Usa una riga per record

Evita di mettere più prodotti, città o regole nella stessa cella quando ognuno ha caratteristiche proprie. Separare i record facilita mantenere i dati coerenti e trovare l'informazione corrispondente.

Dai nomi chiari alle colonne

Preferisci “prazo_entrega” a “info 2” e “região_atendida” a “local”. Il nome deve spiegare il dato senza dipendere dalla memoria interna.

Standardizza formati e valori

Scegli una forma coerente per date, valute, unità, stati e risposte booleane. Mischiare “sim”, “S”, “disponível” e “ok” nella stessa colonna può generare interpretazioni diverse.

Evita celle unite e blocchi decorativi

Intestazioni visive, sottotitoli in mezzo alla tabella, righe vuote e celle unite possono essere utili nelle presentazioni, ma danneggiano una fonte strutturata. Mantieni la scheda destinata all'IA pulita.

Scrivi i valori con il contesto

Un valore come “3” può significare giorni, unità o livello. Registra “3 giorni lavorativi” o mantieni una colonna unità. Ogni cella dovrebbe essere interpretabile insieme all'intestazione.

Prepara la prima scheda

L'implementazione attuale prepara automaticamente la prima scheda disponibile del foglio per la sincronizzazione. Quindi, metti lì la tabella che deve essere usata dall'agente. Non lasciare una copertina, indice o scheda vuota in prima posizione.

Come testare le risposte dell'agente?

Un foglio ben organizzato deve comunque essere convalidato nel contesto di una conversazione. Testa prima di usare la fonte in produzione e ripeti la convalida dopo cambiamenti importanti.

Crea domande con risposta nota

Seleziona record diversi e chiedi direttamente:

• “Seguono a Curitiba?”
• “Qual è il termine per l'installazione standard?”
• “Quali requisiti devo soddisfare?”
• “Questo servizio è disponibile in questa regione?”

Confronta la risposta con la riga corrispondente e verifica che condizioni ed eccezioni siano state preservate.

Testa variazioni linguistiche

Fai la stessa domanda in modi diversi, con abbreviazioni, errori di battitura e informazioni parziali. L'agente dovrebbe chiedere chiarimenti quando il contesto non è sufficiente.

Testa informazioni mancanti

Chiedi di un elemento o di un'area che non esiste. La risposta appropriata è riconoscere l'assenza, richiedere dati aggiuntivi o trasferire a una persona secondo le istruzioni. Non inventare un record.

Testare le contraddizioni

Cerca record duplicati o valori incompatibili. Se ci sono due righe per lo stesso elemento, correggi la fonte o definisci chiaramente quando si applica ciascuna.

Registra i casi di test

Mantieni un elenco con la domanda, il risultato atteso, la risposta osservata, la versione del foglio e la data. Questo permette di ripetere la convalida dopo le modifiche.

La sincronizzazione è in tempo reale?

La pagina pubblica documenta la sincronizzazione automatica del foglio con la Base di Conoscenza, ma non promette di interrogare Google Sheets in tempo reale per ogni messaggio. Le risposte considerano la versione sincronizzata e processata della fonte.

In pratica, una modifica nel foglio potrebbe non essere disponibile immediatamente nella conversazione. Dopo aver cambiato prezzo, politica, disponibilità o altra informazione importante:

1. aspetta o attiva il processo di sincronizzazione disponibile nell'implementazione;
2. conferma che la fonte è stata elaborata;
3. ripeti le domande di convalida;
4. solo allora fai affidamento sul nuovo dato in produzione.

Quando la latenza è accettabile?

Dipende dal rischio e dalla frequenza di cambiamento. Un elenco di unità rivisto occasionalmente può funzionare bene come fonte sincronizzata. Stock, saldo, stato dell'ordine o prezzo che cambiano continuamente possono richiedere l'interrogazione diretta del sistema responsabile.

L'integrazione esporta conversazioni nel foglio?

Non in questo flusso. L'integrazione documentata utilizza Google Sheets come fonte di conoscenza per l'agente. Non promette di registrare messaggi, report, lead o cronologie di conversazione nel foglio.

È importante separare le direzioni:

• Flusso documentato: Google Sheets → Base di Conoscenza → risposte dell'agente.
• Flusso non annunciato in questa integrazione: conversazioni o dati WhatsApp → celle di Google Sheets.

Se l'azienda ha bisogno di esportare eventi o dati, deve valutare un'automazione specifica, API o webhooks. Consulta il hub delle integrazioni per comprendere le opzioni pubblicate e i loro diversi ambiti.

Quando usare API invece di Google Sheets?

Usa Google Sheets quando il team ha bisogno di una fonte semplice, tabellare, modificabile e sincronizzata periodicamente. Valuta un'API quando la risposta dipende da dati transazionali, aggiornati al momento della query o soggetti a regole complesse.

Uno API con webhooks può gestire query e integrazioni personalizzate, ma richiede autenticazione, autorizzazioni, gestione degli errori, limiti, log e manutenzione. L'esistenza di un'API non garantisce che qualsiasi azione sia disponibile.

Checklist prima di attivare

• La prima scheda contiene la tabella destinata all'agente.
• La riga di intestazione ha intestazioni chiare e univoche.
• Ogni riga rappresenta un record coerente.
• Date, unità, categorie e valori sono standardizzati.
• Non ci sono celle unite, titoli decorativi o tabelle parallele.
• Record duplicati o contraddittori sono stati revisionati.
• I dati hanno un responsabile e una routine di aggiornamento.
• Il foglio non contiene password, token, credenziali o segreti.
• I dati personali sono stati minimizzati e hanno uno scopo definito.
• Le istruzioni dell'agente definiscono ambito, limiti e passaggio all'umano.
• Sono state testate domande dirette, variazioni e informazioni mancanti.
• La versione sincronizzata è stata convalidata dopo cambiamenti importanti.
• Il team sa che il flusso non esporta conversazioni nel foglio di calcolo.
• I dati che richiedono tempo reale sono stati indirizzati a un'integrazione appropriata.

Domande frequenti su WhatsApp e Google Sheets

Google Sheets diventa un database per WhatsApp?

Non come database completo. Funziona come fonte tabellare modificabile e sincronizzata che l'agente può consultare. I sistemi transazionali offrono controlli e capacità differenti.

Quale scheda del foglio viene usata?

L'implementazione attuale prepara automaticamente la prima scheda disponibile per la sincronizzazione. Mantieni la tabella principale in quella posizione, pulita e pronta per le query.

L'IA interroga la cella esattamente al momento del messaggio?

La pagina pubblica non promette interrogazioni in tempo reale a ogni messaggio. L'agente considera la versione sincronizzata e processata. I cambiamenti importanti devono essere testati prima dell'uso in produzione.

Posso esportare conversazioni WhatsApp su Google Sheets?

Non tramite il flusso descritto in questo articolo. Questa integrazione usa il foglio come fonte di conoscenza. Le esportazioni richiedono un'altra automazione, API o webhook compatibile.

Posso salvare credenziali nel foglio?

No. Password, token e chiavi API non devono essere usati come contenuto della knowledge base. Usa meccanismi sicuri di gestione dei secret.

Quando dovrei preferire un'API?

Quando la risposta richiede dati transazionali o aggiornati, come inventario, ordini, saldo o regole complesse nel sistema di origine. L'API deve essere implementata con controlli adeguati.

Usa il foglio per il problema giusto

Google Sheets può essere una fonte utile per l'IA su WhatsApp quando i dati sono tabellari, comprensibili e mantenuti dal team. Il suo vantaggio è la semplicità, non sostituire sistemi transazionali o interrogazioni in tempo reale.

Prepara la prima scheda, standardizza i record, sincronizza e testa domande reali. Per informazioni critiche o che cambiano a ogni transazione, valuta un'API collegata al sistema responsabile.

Scopri l'integrazione Google Sheets di Whatsplaid e vedi come usare un foglio organizzato come fonte di conoscenza per l'agente IA su WhatsApp.