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 automatiche e risposte dinamiche. Tramite Dialogflow, puoi interpretare e soddisfare le intenzioni degli utenti, ad esempio per pianificare appuntamenti o elaborare acquisti.

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

Come funziona

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

  • Pubblico in generale. Gli utenti di 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 gli utenti possono aggiungere a Google Chat.
  • 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 richiamarla da uno spazio. Ecco cosa succede:

  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 di chat riceve la richiesta JSON e la analizza. Durante questa analisi, l'app di chat richiama Dialogflow.
  4. L'app di 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 di chat.
  6. L'app di chat analizza la risposta di Dialogflow e invia una risposta JSON a Google Chat.
  7. Google Chat riceve la risposta JSON dell'app di chat e ne esegue il rendering sotto forma di messaggio di testo, messaggio di 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.

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

Limitazioni

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

Prima di iniziare

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

Creare un agente Dialogflow

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

Configurare Google Chat

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

Configurare Google Chat utilizzando la console di Dialogflow

Per integrare Google Chat utilizzando la console di Dialogflow:

  1. Vai alla console di Dialogflow ES.
  2. Nel menu a sinistra, seleziona un progetto Dialogflow.
  3. Fai clic su Integrations (Integrazioni).
  4. Fai clic su Google Chat. Se Google Chat non è una delle opzioni, consulta 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 attiva e disponibile per le persone che hai selezionato.

Per configurare l'app, fai di nuovo clic su Google Chat, poi su CONFIGURA I DETTAGLI DEL BOT. Viene visualizzata la Google Cloud pagina della console per l'API Google Chat, dove puoi configurare i parametri dell'app, ad esempio l'avatar dell'app.

Configurare Google Chat utilizzando la Google Cloud console

Per integrare Google Chat utilizzando la Google Cloud console:

  1. Seleziona il progetto Dialogflow.

    Vai al selettore di progetti

  2. Fai clic su .

  3. Fai clic su API e servizi, 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 Visibility (Visibilità), seleziona chi può accedere all'app:

    • Tester di app. Seleziona Make this chat available to specific people (Rendi questa chat disponibile a persone specifiche) e inserisci i loro indirizzi email.
    • Pubblico in generale o dominio Google Workspace Enterprise. Pubblica l'app.

  9. Fai clic su Salva. La tua app Google Chat è ora attiva e 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 l'app utilizzando uno dei seguenti metodi:

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, consulta 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.

Richiama l'app da uno spazio

  1. Apri Google Chat.
  2. Nel riquadro Spaces (Spazi), fai clic su + e seleziona Create a space (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 la tua 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 di Dialogflow ES > Integrazioni non mostra Google Chat come opzione. Prova ad aggiornare la pagina: nel menu a sinistra, fai clic su Intents (Intenzioni), poi su Integrations (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 di chat, come descritto in Configurare Google Chat.

Messaggi di risposta avanzati

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

Messaggi di risposta

I messaggi di risposta vengono inviati a Google Chat come messaggi di testo. Con questa formattazione puoi formattare il testo in grassetto o in corsivo racchiudendolo tra determinati simboli (markdown light).

Il messaggio di risposta, visivamente, ha lo stesso aspetto del messaggio di risposta predefinito nella console di 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

I messaggi di risposta con schede vengono inviati a Google Chat come messaggi di schede.

Google Immagini

I messaggi di risposta con immagini vengono inviati a Google Chat come widget di immagini di Google Chat.

Payload personalizzato

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 con questa funzionalità. Tuttavia, l'utilizzo di payload personalizzati significa che dovrai fornire il formato JSON.

Di seguito è riportato un esempio di payload personalizzato che utilizza il formato Cards v1:

{
  "hangouts": {
    "header": {
      "title": "Pizza Delivery Customer Support",
      "subtitle": "pizzadelivery@example.com",
      "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 di chat

Per impedire che l'app Google Chat sia disponibile, puoi utilizzare una delle seguenti opzioni:

Interrompere l'app di chat utilizzando la console di Dialogflow

  1. Vai alla console di Dialogflow ES.
  2. Nel menu a sinistra, seleziona un progetto Dialogflow.
  3. Fai clic su Integrations (Integrazioni).
  4. Fai clic su Google Chat. Se Google Chat non è una delle opzioni, consulta Risoluzione dei problemi.
  5. Fai clic su Arresta.

Interrompere l'app di chat utilizzando la Google Cloud console

  1. Seleziona il progetto Dialogflow dalla Google Cloud console.

    Vai al selettore di progetti

  2. Fai clic su .

  3. Fai clic su API e servizi, 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 App status (Stato dell'app), seleziona DISABLED (DISATTIVATO).

Ulteriori informazioni

Per ulteriori informazioni sull'utilizzo di Google Chat, consulta le seguenti risorse: