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.

2.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.

3.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.

4.Inserisci la Descrizione.

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

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

7.Fai clic su Distribuisci.

8.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.

1. Accedi al tuo account tawk.to e seleziona la proprietà corretta.

2. Fai clic su Automation nella barra di navigazione a sinistra.

3. Fai clic su Integrazioni nel sottomenu a sinistra.

4.Seleziona OpenAPI Server nella sezione Strumento personalizzato.

Puoi anche cercare “OpenAPI” utilizzando la barra di ricerca in alto.

5. Si aprirà la pagina di panoramica di OpenAPI Server. Fai clic su Installa nell’angolo in alto a destra.

6. Nella finestra popup, inserisci i dettagli dello schema:

• Seleziona Schema File URL e inserisci l’URL del tuo schema, oppure
• Seleziona Incolla schema e incolla il tuo schema in formato JSON




Lascia vuoto il campo API Base URL e scegli Nessuna autenticazione come metodo di autenticazione.

Quindi, fai clic su Salva.

8. Seleziona il tuo agente AI. Quindi, fai clic su Strumenti nel menu a sinistra. Assicurati che l’integrazione sia attiva sotto Stato.

1. Fai clic su Istruzioni nel menu a sinistra.

• raccogliere i dati dei clienti tramite il modulo, e
• inviare il modulo tramite una chiamata API

• Se il cliente ha bisogno di maggiori informazioni, di’ “Saremo felici di inviarti maggiori dettagli” e raccogli i dati del cliente nel Google Form. Chiedi i dati uno alla volta e non passare alla domanda successiva finché quella corrente non è stata risposta. Poi utilizza la chiamata API per l’invio del modulo.

• Dopo aver ricevuto una risposta dalla chiamata API di invio del modulo, rispondi come segue a seconda dell’esito:

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

• Assicurati che il deployment del tuo Google Apps Script sia impostato su “Chiunque” (Anyone); in caso contrario, AI Assist non sarà in grado di inviare i dati.

• Puoi aggiungere altri campi al tuo modulo, ma dovrai aggiornare sia lo script Google Apps Script sia la specifica OpenAPI per mantenerli coerenti.

• Raccogli solo i dati necessari e assicurati che vengano archiviati 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 dei limiti di esecuzione. Testa la tua configurazione in base al traffico previsto e implementa strategie di retry o backoff per ridurre il rischio di invii falliti.

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

• Guida introduttiva ad AI Assist
• Comprendere il prompt di base
• Come AI Assist utilizza i tuoi dati in modo sicuro
• Distribuire più agenti AI su diversi canali di supporto
• Come configurare un’integrazione API personalizzata con AI Assist

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