Come fare in modo che AI Assist interroghi un foglio Google

Le istruzioni qui sotto sono solo per computer desktop e laptop.

Puoi collegare Google Sheets ad AI Assist, permettendo al tuo agente AI di recuperare dati in tempo reale da un foglio di calcolo durante le conversazioni. Questa funzione ti consente, ad esempio, di consultare l'inventario, confermare prenotazioni, trovare dettagli sugli ordini o recuperare dati dei clienti — tutto senza uscire dalla chat.

Assicurati di avere:

• Un piano AI Assist attivo e a pagamento: Growth, Business o Enterprise.

• Un account Google con accesso al foglio che desideri utilizzare.

• Conoscenze base di programmazione in Google Apps Script e OpenAPI/YAML.
  Se non hai familiarità con il codice, ti consigliamo di farti aiutare da uno sviluppatore. Per maggiori informazioni, visita il nostro portale per sviluppatori.

Ecco alcuni suggerimenti per organizzare il tuo foglio in modo che sia facilmente ricercabile e restituisca risultati affidabili:

• Utilizza una riga di intestazione chiara con nomi di colonna descrittivi.

• Aggiungi una colonna con identificatori univoci per ricerche dirette (ad esempio: SKU, ID ordine o Email).

• Mantieni un solo tipo di dato per colonna. Ad esempio, usa una colonna solo per le date e un'altra solo per i numeri per semplificare la gestione dei dati.

• Evita celle unite o colonne nascoste. Mantieni invece i dati in un formato tabellare, per una migliore accessibilità.

Il tuo Google Sheet può contenere dettagli sugli ordini, descrizioni dei prodotti o informazioni generali.

Ad esempio:

Importare un foglio di calcolo dal tuo computer

Se i tuoi dati si trovano in un file, puoi importarli facilmente in Google Sheets:

1. Apri Google Sheets e clicca su File > Importa.

2. Seleziona la scheda Caricamento e scegli il tuo file, oppure trascinalo nella finestra.

3. Scegli come vuoi importare il file:

   • Crea un nuovo foglio di calcolo (consigliato)

   • Inserisci nuovi fogli nel foglio di calcolo attuale

   • Sostituisci il foglio di calcolo o Sostituisci il foglio (usare con cautela)

4. Clicca su Importa dati e verifica la riga di intestazione e i tipi di colonna.

Tipi di file supportati: .xlsx, .xls, .csv, .tsv, .ods

1. Nel tuo Google Sheet, vai su Estensioni > Apps Script.

1. La console di Apps Script si aprirà in una nuova scheda. Inserisci uno script in Code.gs per definire i metodi con cui interrogare il tuo foglio di calcolo.

Puoi iniziare da questo script di esempio: Code.gs su GitHub.

Lo script di esempio effettua una ricerca in una colonna specifica (SKU) ed è un punto di partenza semplice — modificalo in base ai tuoi dati e alle regole di ricerca.

Per maggiori informazioni su come personalizzare lo script, clicca qui.

1. Clicca su Distribuisci > Nuova distribuzione.

1. Clicca sull’icona a forma di ingranaggio accanto a Seleziona tipo e scegli Web app.

1. Inserisci una Descrizione. Imposta Esegui come su Me. Questo darà allo script accesso al tuo foglio di calcolo.

Imposta Chi ha accesso su Chiunque. Questo permetterà ad AI Assist di interrogare il tuo foglio usando lo script.

Infine, clicca su Distribuisci.

1. Copia e salva l’URL della Web App. Ti servirà per le specifiche API.

Nota: a ogni nuova distribuzione viene generato un nuovo URL.

AI Assist ha bisogno di un file OpenAPI (in formato YAML o JSON) che descriva come chiamare questo esempio. la tua Web App.

Puoi copiare le specifiche da Assicurati di:

• Sostituire il valore di servers.urls con l’URL della Web App copiato da Apps Script.

• Rimuovere /exec alla fine dell’URL.

• Modificare i parametri rilevanti in base alle tue esigenze.

Per maggiori informazioni su come personalizzare le specifiche,clicca qui.

Usa un validatore/editor come Swagger Editor per controllare il tuo file YAML o JSON.

Copia e salva l’URL del file raw, ti servirà per la sezione successiva.

Nota: il campo “title” nelle tue specifiche verrà visualizzato come nome dell’integrazione sulla dashboard di tawk.to.

Ad esempio:

Così apparirà sulla tua dashboard:

Se hai più integrazioni API, assegna a ciascuna un nome descrittivo per trovarle facilmente.

Nota: Per effettuare questa integrazione è necessario un piano AI Assist a pagamento.

1. Accedi al tuo account tawk.to.

2. Seleziona la proprietà corretta.

1. Clicca su Componenti aggiuntivi nel menu in alto.

1. Sotto AI Assist, clicca su Impostazioni.

1. Seleziona il tuo agente AI.

2. Seleziona Integrazione/API.

1. Clicca su + Aggiungi sotto Strumenti.

1. Clicca su Aggiungi strumento sotto API.

1. Inserisci l’URL del file delle specifiche nel campo Schema File URL.

1. Lascia vuoto il campo API Base URL.

2. Imposta il metodo di autenticazione su Nessuna autenticazione.

3. Clicca su Salva.

• Esegui query comuni e casi limite nell’anteprima della dashboard.

• Usa Logger.log() in Apps Script e controlla la pagina Esecuzioni per eventuali errori.

• Verifica che lo schema OpenAPI corrisponda all’effettivo output JSON.

• Memorizza nella cache i risultati frequenti se le risposte sono lente.

• Mantieni risposte coerenti (stessi campi e tipi) in modo che AI Assist possa analizzarle in modo affidabile.

Sii prudente nel gestire informazioni sensibili.
Restituisci solo i campi di cui AI Assist ha bisogno e monitora l’uso per attività sospette.

Limiti di velocità
Considera le quote di Google Apps Script e progetta il sistema per ritentativi e pause tra le richieste.

Protezione dei dati
Rispetta il GDPR e le altre leggi sulla privacy applicabili quando restituisci dati personali.

Versionamento
Quando modifichi la specifica OpenAPI, incrementa la versione o aggiorna il titolo per mantenere chiare le integrazioni.

Se hai commenti su questo articolo o hai bisogno di ulteriore assistenza:

Contattaci via live chat
Prenota una chiamata con il nostro team
Visita la nostra community