Integrazione di Dialogflow con Google Chat

Integrando Dialogflow con Google Chat, puoi sfruttare le funzionalità di entrambi i servizi:

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

Sebbene tu possa utilizzare anche Google Chat per soddisfare le richieste degli utenti, Dialogflow consente agli utenti di esprimere le proprie richieste tramite una normale conversazione.

Come funziona

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

• Pubblico generico. Gli utenti Google Workspace con licenza possono scaricare la tua app tramite Google Workspace Marketplace.
• Dominio Google Workspace. Un amministratore di Google Workspace può specificare quali app possono essere aggiunte a Google Chat dagli utenti.
• Tester di app. Durante il test dell'app, puoi limitarne l'accesso.

In Google Chat, un utente può avere una conversazione diretta con la tua 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 di chat, che potrebbe essere ospitata in Cloud Functions.
3. L'app Chat riceve la richiesta JSON e la analizza. Durante l'analisi, l'app Chat richiama Dialogflow.
4. L'app Chat invia una richiesta a Dialogflow che include il testo del messaggio in linguaggio 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 scheda o messaggio di dialogo nella UI.
8. Google Chat condivide questa risposta così com'è o presenta una risposta avanzata utilizzando un'interfaccia utente basata su schede.

Questa pagina descrive come integrare Dialogflow con Google Chat e configurare risposte di chat avanzate.

Nota: Google Chat in precedenza si chiamava Hangouts Chat e le app di chat in precedenza si chiamavano bot di chat. Anche se Google Chat e la console Google Cloud utilizzano il termine app, la console Dialogflow utilizza ancora 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 Google Workspace con licenza possono utilizzare le app Google Chat. Il tuo amministratore di Google Workspace deve:

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

Crea un agente Dialogflow

Se non hai ancora creato un agente Dialogflow, ma vuoi vedere come interagisce con Google Chat, segui questa guida rapida per creare un agente semplice. Tuttavia, non eliminare l'agente. Successivamente, abbiamo configurato l'agente con un'interfaccia Google Chat.

Configurare Google Chat

Per configurare l'agente Dialogflow con Google Chat, puoi utilizzare uno dei seguenti metodi:

• Console Dialogflow
• Google Cloud console

Configura 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, consulta la sezione Risoluzione dei problemi.
5. Seleziona chi può accedere all'app.
6. [Facoltativo] Seleziona un ambiente in cui eseguire l'agente.
7. Fai clic su Avvia.

La tua app Google Chat è ora disponibile per le persone che hai selezionato.

Per configurare l'app, fai di nuovo clic su Google Chat, poi su CONFIGURA DETTAGLI BOT. Viene visualizzata la pagina della console Google Cloud per l'API Google Chat, dove puoi configurare i parametri dell'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 di progetti

2. Fai clic su .

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

4. Cerca e fai clic su 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 disponibile questa chat a persone specifiche e inserisci i loro indirizzi email.
   • Dominio Google Workspace pubblico o Enterprise. Pubblica l'app.

9. Fai clic su Salva. La tua app Google Chat è ora disponibile per le persone che hai selezionato.

Test

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

Puoi testare la tua app utilizzando uno di questi metodi:

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

Chattare 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, consulta la sezione Risoluzione dei problemi.
4. Fai clic su Chat.
5. Nel campo di inserimento della chat, inserisci una frase in 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 inserimento della chat, inserisci @ e seleziona l'app per completare automaticamente il nome.
6. Dopo il nome dell'app completato automaticamente, inserisci una frase in linguaggio naturale per testare l'app.

Risoluzione dei problemi

Errore	Soluzione
La pagina Console Dialogflow ES > Integrazioni non mostra Google Chat come opzione.	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. Poi, assicurati di aver avviato l'app Chat, come descritto in Configurare Google Chat.

Messaggi di risposta avanzati

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

Risposte testuali

Le risposte di testo vengono inviate a Google Chat come messaggi. Con questa formattazione puoi mettere il testo in grassetto o in corsivo racchiudendolo tra determinati simboli (Markdown Light).

La risposta all'SMS ha lo stesso aspetto della risposta di testo predefinita nella console Dialogflow. Tuttavia, la risposta API non elaborata avrà un aspetto leggermente diverso. Imposta anche la configurazione della piattaforma su GOOGLE_HANGOUTS, il che potrebbe essere interessante quando crei agenti per più integrazioni.

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

Schede

Le risposte alle schede vengono inviate a Google Chat come messaggi con schede.

Immagini

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

Payload personalizzato

Nota: questa integrazione non supporta le azioni delle 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 può avere un'intestazione. Puoi consultare la guida di riferimento alle schede dei formati dei messaggi di Google Chat per vedere alcune delle combinazioni che puoi creare. Tuttavia, l'utilizzo di payload personalizzati significa che dovrai fornire il formato JSON.

Nota :quando copi e incolli gli esempi della guida di riferimento nella casella del payload personalizzato in Dialogflow, assicurati che l'editor non contenga errori di linting. 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 Cards v1:

{
  "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 impedire che l'app Google Chat sia disponibile, puoi utilizzare una delle seguenti opzioni:

• Console Dialogflow

• Google Cloud console

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, consulta la sezione Risoluzione dei problemi.
5. Fai clic su Arresta.

Interrompere l'utilizzo dell'app Chat tramite la console Google Cloud

1. Seleziona il progetto Dialogflow dalla console Google Cloud .

   Vai al selettore di progetti

2. Fai clic su .

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

4. Cerca e fai clic su API Google Chat.

5. Fai clic su Gestisci.

6. Fai clic sulla scheda Configuration (Configurazione).

7. Nel campo Stato app, seleziona DISATTIVATO.

Ulteriori informazioni

Per saperne di più sull'utilizzo di Google Chat, consulta le seguenti risorse:

• Documentazione per sviluppatori dell'API Google Chat
• Creare un componente aggiuntivo di Google Workspace che estenda Google Chat
• Video: integrare Dialogflow con Google Chat
• Codelab: Integrating Dialogflow with Google Chat