Integrazione di Google Chat con Dialogflow

Se integri Dialogflow con Google Chat, puoi utilizzare le funzionalità di entrambi i servizi:

• Google Chat Offre una piattaforma di messaggistica con un'interfaccia utente front-end per conversazioni e spazi di chat individuali. Tramite Google Chat, puoi migliorare le interfacce utente creando schede che incorporano icone, immagini, pulsanti, campi di immissione di testo o app come Google Maps.
• Dialogflow. Offre una piattaforma di comprensione del linguaggio naturale per conversazioni automatiche e risposte dinamiche. Tramite Dialogflow, puoi interpretare e soddisfare gli scopi degli utenti, ad esempio per pianificare appuntamenti o elaborare gli acquisti.

Puoi utilizzare Google Chat anche per soddisfare le richieste degli utenti, ma Dialogflow consente agli utenti di esprimere le proprie richieste attraverso una conversazione regolare.

Come funziona

Dopo aver creato un'app Google Chat abilitata per Dialogflow, puoi renderla disponibile come segue:

• Pubblico. Gli utenti con licenza di Google Workspace possono scaricare la tua app tramite Google Workspace Marketplace.
• dominio Google Workspace. Un amministratore di Google Workspace può specificare le app che gli utenti possono aggiungere a Google Chat.
• Tester delle app. Durante il test, puoi limitare l'accesso all'app.

In Google Chat, un utente può avere una conversazione diretta con l'app o richiamare l'app da uno spazio. Si verifica quanto segue:

1. Un utente invia un messaggio a un'app di chat.
2. Google Chat invia una richiesta JSON all'app Chat che potrebbe essere ospitata in Cloud Functions.
3. L'app Chat riceve la richiesta JSON e la analizza. Durante questa analisi, l'app Chat richiama Dialogflow.
4. L'app Chat invia a Dialogflow una richiesta che include il testo del messaggio in lingua naturale dell'utente.
5. Dialogflow interpreta il testo dell'utente e invia una risposta all'app Chat.
6. L'app Chat analizza la risposta di Dialogflow e invia una risposta JSON a Google Chat.
7. Google Chat riceve la risposta JSON dell'app Chat e visualizza una risposta sotto forma di messaggio di testo, messaggio di una scheda o messaggio di dialogo nell'interfaccia utente.
8. Google Chat condivide questa risposta così com'è o presenta una risposta avanzata utilizzando un'interfaccia utente basata su schede.

In questa pagina viene descritto come integrare Dialogflow con Google Chat e configurare le risposte chat avanzate.

Nota: in precedenza, Google Chat era denominato Hangouts Chat, mentre le app di Chat in precedenza erano chiamate bot di Chat. Sebbene Google Chat e la console Google Cloud utilizzino il termine app, la console Dialogflow utilizza comunque il termine bot.

Limitazioni

Con le integrazioni di Google Chat, un agente Dialogflow può utilizzare solo la lingua predefinita dell'agente.

Prima di iniziare

Solo gli utenti con licenza Google Workspace possono utilizzare le app Google Chat. L'amministratore di Google Workspace deve eseguire le seguenti operazioni:

• Aggiungi un account Google Workspace per te.
• Consentire agli utenti di installare app di chat.

Crea un agente Dialogflow

Se non hai ancora creato un agente Dialogflow e vuoi vedere come un agente interagisce con Google Chat, segui questa guida rapida per creare un agente semplice. Non eliminare comunque l'agente. Successivamente, configuriamo l'agente con un'interfaccia di Google Chat.

Configurare Google Chat

Per configurare l'agente Dialogflow con Google Chat, puoi utilizzare una delle seguenti opzioni:

• Console Dialogflow
• Console Google Cloud

Configurare Google Chat utilizzando la console Dialogflow

Per integrare Google Chat utilizzando la console Dialogflow, segui questi passaggi:

1. Vai alla console di Dialogflow ES.
2. Nel menu a sinistra, seleziona un progetto Dialogflow.
3. Fai clic su Integrazioni.
4. Fai clic su Google Chat. Se Google Chat non è tra le opzioni disponibili, vedi Risolvere i problemi.
5. Seleziona chi può accedere all'app.
6. (Facoltativo) Seleziona un ambiente per l'esecuzione dell'agente.
7. Fai clic su Avvia.

La tua app Google Chat è ora disponibile e disponibile per gli utenti selezionati.

Per configurare l'app, fai di nuovo clic su Google Chat, quindi su CONFIGURA DETTAGLI BOT. Viene visualizzata la pagina della console Google Cloud per l'API Google Chat, in cui puoi configurare i parametri per le app come l'avatar dell'app.

Configurare Google Chat utilizzando la console Google Cloud

Per integrare Google Chat utilizzando la console Google Cloud, segui questi passaggi:

1. Seleziona il progetto Dialogflow.

   Vai al selettore progetti

2. Fai clic su .

3. Fai clic su API e servizi e poi su Libreria.

4. Cerca e fai clic sull'API Google Chat.

5. Fai clic su Attiva.

6. Fai clic sulla scheda Configuration (Configurazione).

7. Configura l'app.

8. Nel riquadro Visibilità, seleziona chi può accedere all'app:

   • tester delle app. Seleziona Rendi questa chat disponibile per persone specifiche e inserisci i loro indirizzi email.
   • dominio Google Workspace pubblico o aziendale. Pubblica l'app.

9. Fai clic su Salva. L'app Google Chat è ora disponibile e disponibile per gli utenti selezionati.

Test

Prima di testare l'app Chat, assicurati di averla avviata, come descritto in Configurare Google Chat.

Puoi testare l'app utilizzando uno dei seguenti metodi:

• Chattare direttamente con l'app
• Richiamare l'app da uno spazio

Chatta direttamente con l'app

1. Apri Google Chat.
2. Nel riquadro Chat, fai clic su + e seleziona Trova app.
3. Cerca e seleziona la tua app. Se Google Chat non elenca la tua app, vedi Risolvere i problemi.
4. Fai clic su Chat.
5. Nel campo di immissione della chat, inserisci una frase del linguaggio naturale per testare l'app.

Richiamare l'app da uno spazio

1. Apri Google Chat.
2. Nel riquadro Spazi, fai clic su + e seleziona Crea uno spazio.
3. Inserisci il nome dello spazio Test.
4. Fai clic su Crea.
5. Nel campo di immissione della chat, inserisci @ e seleziona l'app per completare automaticamente il nome.
6. Dopo il nome dell'app con completamento automatico, inserisci una frase in linguaggio naturale per testare l'app.

Risolvere i problemi

Errore	Soluzione
Nella pagina Dialogflow ES Console > Integrazioni non è disponibile l'opzione per Google Chat.	Prova ad aggiornare la pagina: nel menu a sinistra, fai clic su Intent e poi su Integrazioni.
Google Chat non elenca la tua app come disponibile.	Assicurati che l'amministratore di Google Workspace abbia aggiunto un account Google Workspace per te e abbia consentito agli utenti di installare app di chat. Assicurati di aver avviato l'app Chat, come descritto in Configurare Google Chat.

Messaggi di risposta avanzati

Questa integrazione traduce alcuni messaggi di risposta avanzati in formati di messaggi di Google Chat.

Risposte testuali

Le risposte di testo vengono inviate a Google Chat come SMS. Con questa formattazione puoi formattare il testo in grassetto o in corsivo inserendolo in alcuni simboli (luce di markdown).

La risposta degli SMS ha lo stesso aspetto della risposta predefinita nella console di Dialogflow. Tuttavia, la risposta dell'API non elaborata avrà un aspetto leggermente diverso. Inoltre, la configurazione della piattaforma viene impostata su GOOGLE_HANGOUTS, il che potrebbe essere interessante durante la creazione di agenti per più integrazioni.

"fulfillmentMessages": [
{
   "text": {
   "text": [
        "This is a test."
   ]
},
  "platform": "GOOGLE_HANGOUTS"
},

Carte

Le risposte delle schede vengono inviate a Google Chat come messaggi delle schede.

Immagini

Le risposte di immagini vengono inviate a Google Chat come widget di immagine di Google Chat.

Payload personalizzato

Nota: questa integrazione non supporta le azioni relative alle schede.

Per inviare altri tipi di messaggi di Google Chat, puoi utilizzare un payload personalizzato.

Il payload personalizzato di Google Chat ti consente di creare schede più avanzate. Una scheda può avere una o più sezioni. Ogni sezione potrebbe avere un'intestazione. Puoi dare un'occhiata alla Guida di riferimento delle schede dei formati dei messaggi di Google Chat per vedere alcune delle combinazioni che puoi creare con il codice. Tuttavia, l'utilizzo di payload personalizzati implica la necessità di fornire il formato JSON.

Nota: quando copi e incolli gli esempi dalla guida di riferimento alla casella del payload personalizzato in Dialogflow, assicurati che l'editor non contenga errori di analisi tramite lint. Non puoi testare i risultati nel Simulatore di Dialogflow, ma puoi farlo direttamente in Google Chat.

Ecco un esempio di payload personalizzato che utilizza il formato Schede v1:

Nota: il formato delle schede v2 non è supportato.

{
  "hangouts": {
    "header": {
      "title": "Pizza Delivery Customer Support",
      "subtitle": "[e-mail]",
      "imageUrl": "https://goo.gl/aeDtrS"
    },
    "sections": [{
      "widgets": [{
        "keyValue": {
          "icon": "TRAIN",
          "topLabel": "Order No.",
          "content": "12345"
        }
      },
      {
        "keyValue": {
          "topLabel": "Status",
          "content": "In Delivery"
        }
      }]
    },
    {
      "header": "Location",
      "widgets": [{
        "image": {
          "imageUrl": "https://dummyimage.com/600x400/000/fff"
        }
      }]
    },
    {
      "header": "Buttons - I could leave the header out",
      "widgets": [{
        "buttons": [{
          "textButton": {
            "text": "OPEN ORDER",
            "onClick": {
              "openLink": {
                "url": "https://example.com/orders/..."
              }
            }
          }
        }]
      }]
    }]
  }
}

Interrompere l'app Chat

Per interrompere la disponibilità dell'app Google Chat, puoi utilizzare una delle seguenti opzioni:

• Console Dialogflow

• Console Google Cloud

Interrompere l'app Chat utilizzando la console Dialogflow

1. Vai alla console di Dialogflow ES.
2. Nel menu a sinistra, seleziona un progetto Dialogflow.
3. Fai clic su Integrazioni.
4. Fai clic su Google Chat. Se Google Chat non è tra le opzioni disponibili, vedi Risolvere i problemi.
5. Fai clic su Arresta.

Interrompere l'app di chat utilizzando la console Google Cloud

1. Seleziona il progetto Dialogflow dalla console Google Cloud.

   Vai al selettore progetti

2. Fai clic su .

3. Fai clic su API e servizi e poi su Libreria.

4. Cerca e fai clic sull'API Google Chat.

5. Fai clic su Gestisci.

6. Fai clic sulla scheda Configuration (Configurazione).

7. Nel campo Stato applicazione, seleziona DISATTIVATO.

Informazioni dettagliate

Per ulteriori informazioni sull'utilizzo di Google Chat, vedi:

• Documentazione per gli sviluppatori di Google Chat
• Creare un'app di chat
• Video: integrare Dialogflow con Google Chat
• Codelab: integrazione di Dialogflow con Google Chat