Come fare in modo che AI Assist generi lead tramite Google Forms

Collegando il tuo assistente AI a un Google Form tramite Google Apps Script e una semplice specifica OpenAPI, i dati dei clienti raccolti durante le chat vengono inviati automaticamente al tuo account Google, rendendo il tracciamento e il follow-up più rapidi ed efficaci.

Ecco cosa ti serve:

• Un piano AI Assist attivo a pagamento (Growth, Business o Enterprise)

• Un account Google con accesso a Google Forms e Google Apps Script

• Un po' di conoscenza di codice (Google Apps Script e OpenAPI).
  Se non ti senti a tuo agio, puoi adattare gli esempi pubblici forniti in questa guida o chiedere aiuto a uno sviluppatore.
  Per maggiori informazioni, visita il nostro portale per sviluppatori.

Esempi di questa integrazione sono disponibili nel nostro repository pubblico su GitHub per il tuo riferimento.

1. Vai su Google Forms.

2. Crea un nuovo modulo e aggiungi i campi per le informazioni che desideri raccogliere (es. Nome, Email, Numero di telefono, Messaggio).

Assicurati che i nomi dei campi siano chiari e coerenti — li utilizzerai sia nello script di Apps Script che nella tua specifica OpenAPI.

Per permettere ad AI Assist di inviare dati al tuo Google Form, devi configurare un endpoint web utilizzando Google Apps Script.

1. Nell’editor di Google Form, clicca sul menu con i tre puntini (⋮) in alto a destra e seleziona Apps Script.

1. Nella console di Apps Script, inserisci uno script nel file Code.gs per descrivere i metodi necessari a interrogare il tuo foglio.
   Puoi copiare lo script fornito in questo esempio.

1. Dopo aver aggiunto lo script, pubblica lo script come Web App.
   Fai clic su Distribuisci > Nuova distribuzione.

Fai clic sull'icona a forma di ingranaggio accanto a Seleziona tipo e scegli Web app.

1. Inserisci la Descrizione.

1. Imposta Esegui come su Me. Questo permette al tuo script di accedere al tuo foglio.

2. Imposta Chi ha accesso su Chiunque. Questo consente ad AI Assist di interrogare il tuo foglio utilizzando il tuo script.

3. Fai clic su Distribuisci.

4. Copia e salva l’URL della Web App — ti servirà per la specifica OpenAPI.

Nota: Ogni distribuzione crea un nuovo URL, quindi assicurati di aggiornarlo se ridistribuisci lo script.

Ti servirà una specifica OpenAPI, come un file YAML, che definisca l’interazione tra AI Assist e il tuo Google Form.

Puoi copiare la specifica fornita in questo esempio. Assicurati di:

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

• Rimuovere /exec dalla fine dell’URL.

• Modificare i parametri rilevanti in base alle tue esigenze. Per maggiori informazioni sulla personalizzazione della specifica, clicca qui.

Puoi modificare e testare le specifiche API usando un editor online come Swagger.

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

Il titolo nella tua specifica apparirà come nome dell’integrazione sulla dashboard di tawk.to.

Ad esempio:

Ecco come apparirà sulla tua dashboard:

Se hai più integrazioni API, assegna a ciascuna un nome descrittivo in modo che sia facile trovarle.

AI Assist è progettato per comprendere il contesto della richiesta e utilizzare l’operationId rilevante nel tuo schema API. In questo esempio, il nome dell’operazione è submitForm.

Ora completiamo questa integrazione sulla dashboard di tawk.to.

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

1. Accedi al tuo account tawk.to.

2. Seleziona la proprietà corretta.

1. Vai su Componenti aggiuntivi (Add-ons).

1. Sotto AI Assist, clicca su Impostazioni (Settings).

1. Seleziona il tuo agente AI.

2. Clicca su Integrazione/API (Integration/API).

1. Clicca su Aggiungi strumento (Add tool) sotto la sezione API.

1. Inserisci l’URL del file della tua specifica OpenAPI nel campo Schema File URL.

1. Lascia vuoto il campo API Base URL e imposta il metodo di autenticazione su Nessuna autenticazione (No Auth).

2. Clicca su Salva.

Aggiorna il Base Prompt del tuo agente AI per assicurarti che sappia quando inviare i dati al modulo.

1. Vai al Base Prompt.

1. Inserisci le istruzioni per addestrare AI Assist a:

• raccogliere i dettagli dei clienti tramite il modulo, e

• inviare il modulo usando una chiamata API.

Ad esempio:

• Se il cliente necessita di ulteriori informazioni, dì: “Saremo felici di inviarti maggiori dettagli” e raccogli i dati del cliente nel Google Form. Chiedi i dettagli uno alla volta e non procedere alla domanda successiva finché la risposta attuale non è stata fornita. Poi usa la chiamata API per inviare il modulo.

Puoi anche definire la risposta di AI Assist dopo l’invio del modulo, per esempio:

• Dopo aver ricevuto una risposta dalla chiamata API di invio modulo, dì quanto segue a seconda del risultato:

  • Se l’invio è andato a buon fine, dì:
    “Grazie. Un nostro rappresentante ti contatterà a breve. Cosa vorresti fare adesso?
    [opzione] Torna al menu principale
    [opzione] Ulteriori informazioni sui prodotti”

  • Se l’invio è fallito, dì:
    “Mi dispiace, qualcosa è andato storto. Per favore contatta info@example.com”

1. Clicca su Salva.

• Avvia una chat di prova con il tuo agente AI.

• Fornisci dati di esempio (es. nome, email, telefono).

• Controlla il tuo Google Form per verificare che i dati siano stati acquisiti correttamente.

• Se qualcosa non funziona, verifica nuovamente i permessi di Google Apps Script, la distribuzione della Web App e la specifica OpenAPI.

• Assicurati che la distribuzione del tuo Google Apps Script sia impostata su Chiunque; altrimenti AI Assist non potrà inviare i dati.

• Puoi aggiungere altri campi al modulo, ma dovrai aggiornare sia lo script di Apps Script che la specifica OpenAPI di conseguenza.

• Raccogli solo i dati necessari e assicurati che siano conservati in modo sicuro. Rispetta le normative sulla protezione dei dati applicabili (come il GDPR) ed evita di inviare informazioni personali non necessarie.

• Google Apps Script ha limiti di esecuzione. Testa il tuo setup sotto il carico previsto e implementa strategie di retry o backoff per ridurre il rischio di invii falliti.

• Ogni nuova distribuzione dello script genera un nuovo URL per la Web App. Se aggiorni lo script o la specifica OpenAPI, assicurati di aggiornare il file ospitato e di salvare nuovamente lo strumento nella dashboard di tawk.to.

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