Google Chat

L'integrazione di Google Chat per Dialogflow CX ti consente di creare app di Chat Google con la comprensione del linguaggio naturale basata sulla tecnologia Dialogflow CX.

Limitazioni

Configura Google Chat

Per configurare l'integrazione di Google Chat per l'agente, devi avere:

Abilita l'API Google Chat

Prima di utilizzare le API di Google, devi attivarle in un progetto Google Cloud. Puoi attivare una o più API in un singolo progetto Google Cloud.

  1. In https://console.cloud.google.com/, abilita l'API Google Chat e l'API Dialogflow.
  2. Verifica di abilitare le API nel progetto Cloud corretto, quindi fai clic su Avanti.
  3. Verifica di abilitare le API corrette, quindi fai clic su Abilita.

Configura da Dialogflow CX

  1. Vai alla console Dialogflow CX.
  2. Selezionare il tuo progetto Google Cloud .
  3. Seleziona l'agente.
  4. Vai alla scheda Gestisci nel menu di navigazione.
  5. Seleziona Integrations (Integrazioni).
  6. Fai clic su Connetti in Google Chat.
  7. Inserisci le seguenti informazioni obbligatorie:
    • Nome:il nome visualizzato dagli utenti che interagiscono o consumano contenuti creati da questa app, ad esempio in messaggi, ricerca e @menzioni. Ad esempio, Dialogflow CX App.
    • URL avatar:l'immagine avatar visualizzata dagli utenti che interagiscono con l'app. Specifica un URL HTTPS che ospita un'immagine PNG quadrata (proporzioni 1:1). Dimensioni minime consigliate: 256 x 256 pixel. Ad esempio, https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png.
    • Descrizione:una descrizione dell'app, ad esempio A helpful bot that responds to real human conversation.
    • Ambiente: l'ambiente a cui connettersi. Seleziona un ambiente, se applicabile.
  8. Inserisci gli indirizzi email per rendere disponibile l'app di Chat a utenti e gruppi specifici, a seconda dei casi.
  9. Fai clic su Avvia.

Test

Per testare l'app configurata, menzionala in uno spazio di Google Chat o invia un messaggio diretto.

Ad esempio:

  1. Apri Google Chat.
  2. Fai clic su Nuova chat.
  3. Nel campo Aggiungi una o più persone, inserisci il nome della tua app di Chat.
  4. Seleziona la tua app di Chat dai risultati. Si apre un messaggio diretto.

Messaggi di risposta avanzati

Puoi supportare i messaggi di risposta avanzata utilizzando il payload personalizzato nel fulfillment. Per informazioni sul formato dei messaggi, consulta l'API Google Chat Message.

Messaggio di testo

Il seguente payload personalizzato fornisce un messaggio di Google Chat:

{
  "text": "Hello, world"
}

Se utilizzi un componente aggiuntivo di Chat, il seguente payload personalizzato fornisce un messaggio di testo di Google Chat:

{
  "hostAppDataAction": {
    "chatDataAction": {
      "createMessageAction": {
        "message": {
          "text": "Your pizza delivery is here!"
        }
      }
    }
  }
}

Messaggio della carta

Il seguente payload personalizzato fornisce un messaggio con scheda di Google Chat:

{
  "cardsV2": [{
    "cardId": "createCardMessage",
    "card": {
      "header": {
        "title": "A card message!",
        "subtitle": "Sent from Dialogflow CX",
        "imageUrl": "https://developers.google.com/chat/images/chat-product-icon.png",
        "imageType": "CIRCLE"
      },
      "sections": [
        {
          "widgets": [
            {
              "buttonList": {
                "buttons": [
                  {
                    "text": "Read the docs!",
                    "onClick": {
                      "openLink": {
                        "url": "https://developers.google.com/workspace/chat"
                      }
                    }
                  }
                ]
              }
            }
          ]
        }
      ]
    }
  }]
}

Il seguente payload personalizzato fornisce un messaggio con scheda di Google Chat se utilizzi un componente aggiuntivo di Chat:

{
  "hostAppDataAction": {
    "chatDataAction": {
      "createMessageAction": {
        "message": {
          "cardsV2": [
            {
              "cardId": "basic1",
              "card": {
                "header": {
                  "title": "This is a card!",
                  "subtitle": "Sent from Conversational Agents (Dialogflow CX)",
                  "imageUrl": "https://developers.google.com/chat/images/chat-product-icon.png",
                  "imageType": "CIRCLE"
                },
                "sections": [
                  {
                    "widgets": [
                      {
                        "buttonList": {
                          "buttons": [
                            {
                              "text": "Open Google!",
                              "color": {
                                "red": 0.101960786,
                                "green": 0.4509804,
                                "blue": 0.9098039
                              },
                              "onClick": {
                                "openLink": {
                                  "url": "http://google.com"
                                }
                              }
                            }
                          ]
                        }
                      }
                    ]
                  }
                ]
              }
            }
          ]
        }
      }
    }
  }
}

Risposte specifiche per il canale

Se configurate, le risposte specifiche per il canale con il canale DF_CX_GOOGLE_CHAT vengono utilizzate automaticamente quando l'agente risponde ai messaggi di Google Chat.