Integrazione di Dialogflow con Google Chat

Integrando Dialogflow con Google Chat, sfrutti 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 migliora l'interfaccia utente creando schede che includono icone, immagini, pulsanti campi di immissione testo o app come Google Maps.
  • Dialogflow. Fornisce una piattaforma di comprensione del linguaggio naturale conversazioni dinamiche e risposte dinamiche. Tramite Dialogflow, puoi interpretare e soddisfare le intenzioni degli utenti, ad esempio, per pianificare appuntamenti o elaborare acquisti.

Sebbene sia possibile usare Google Chat anche per soddisfare le richieste degli utenti, Dialogflow consente gli utenti esprimono le loro richieste attraverso conversazioni regolari.

Come funziona

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

  • Pubblico. 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 dagli utenti a Google Chat.
  • Tester delle app. Durante il test dell'app, puoi limitare l'accesso all'app.

In Google Chat, un utente può avere una conversazione diretta con la tua app oppure per richiamare l'app dall'interno di 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 di Cloud Functions.
  3. L'app Chat riceve la richiesta JSON e la analizza. Durante l'analisi, l'app di Chat richiama Dialogflow.
  4. L'app Chat invia a Dialogflow una richiesta che include del messaggio in linguaggio naturale.
  5. Dialogflow interpreta il testo dell'utente e invia una risposta all'app 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 Chat ed esegue il rendering della risposta in un messaggio di testo, un messaggio in una scheda o un messaggio di dialogo nell'interfaccia utente.
  8. Google Chat condivide questa risposta così com'è o presenta una risposta completa utilizzando un basata su schede.

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

Limitazioni

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

Prima di iniziare

Solo gli utenti Google Workspace con licenza possono utilizzare le app Google Chat. Il tuo L'amministratore di Google Workspace deve:

Crea un agente Dialogflow

Se non hai ancora creato un agente Dialogflow, ma vuoi vedere in che modo interagisce con Google Chat, segui questa guida rapida per creare un agente semplice. Tuttavia, non eliminare l'agente. Poi abbiamo configurato 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:

Configurare Google Chat utilizzando la console di Dialogflow

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

  1. Vai alla console 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 è tra le opzioni, vedi Risolvere i 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 selezionate.

Per configurare l'app, fai di nuovo clic su Google Chat, quindi su CONFIGURA DETTAGLI DEL BOT. Viene visualizzata la pagina della console Google Cloud Per l'API Google Chat, in cui puoi configurare i parametri delle 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 Services, quindi 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 questa chat disponibile a persone specifiche e inserisci i relativi indirizzi email.
    • Dominio Google Workspace pubblico o aziendale. Pubblica l'app.

  9. Fai clic su Salva. La tua app Google Chat è ora attiva e disponibile per gli utenti 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 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 l'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 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 immissione 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 console Dialogflow ES > La pagina 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 aver consentito agli utenti di installare app di chat. Quindi, assicurati di aver avviato l'app Chat, come descritto in Configurare Google Chat.

Messaggi di risposta avanzati

Questa integrazione traduce messaggi di risposta avanzata messaggi a Formati dei messaggi di Google Chat.

Risposte testuali

Risposte testuali vengono inviati a Google Chat come Messaggi. Con questa formattazione puoi applicare il grassetto o il corsivo al testo a capo alcuni simboli (luce di markdown).

La risposta tramite messaggio ha lo stesso aspetto della risposta di testo predefinita nella console Dialogflow. Tuttavia, la risposta non elaborata dell'API avrà un aspetto un po' diverso. Imposta inoltre la configurazione della piattaforma su GOOGLE_HANGOUTS. Potrebbe essere interessante quando si creano agenti per più integrazioni.

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

Carte

Risposte delle schede vengono inviati a Google Chat come Messaggi della scheda.

Immagini

Risposte tramite immagini vengono inviati a Google Chat come Widget di immagine 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 carte più avanzate. Una scheda può avere una o più sezioni. Ogni sezione può avere un'intestazione. Per conoscere alcune delle combinazioni che puoi creare con questa funzionalità, puoi consultare la guida di riferimento delle schede dei formati dei messaggi di Google Chat. Tuttavia, utilizzando payload personalizzati dovrai fornire il formato JSON.

Ecco 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 Chat

Per non rendere più disponibile l'app Google Chat, puoi utilizzare una delle seguenti opzioni:

Arresta l'app Chat utilizzando la console Dialogflow

  1. Vai alla console 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 è tra le opzioni, vedi Risolvere i problemi.
  5. Fai clic su Arresta.

Arresta l'app 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 Services, quindi 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 DISATTIVATA.

Ulteriori informazioni

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