Google Chat

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

Limitazioni

Configurare Google Chat

Per configurare l'integrazione di Google Chat per il tuo agente, avrai bisogno di:

Abilitare l'API Google Chat

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

  1. Nella https://console.cloud.google.com/, abilita l'API Google Chat e l'API Dialogflow.

  2. Verifica di aver abilitato le API nel progetto Cloud corretto, quindi fai clic su Avanti.

  3. Verifica di aver abilitato le API corrette, quindi fai clic su Abilita.

Configurare da Dialogflow CX

  1. Vai alla console di Dialogflow CX.
  2. Scegli il tuo Google Cloud progetto.
  3. Seleziona l'agente.
  4. Seleziona la scheda Gestisci.
  5. Fai clic su Integrazioni nel menu della barra laterale a sinistra.
  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 dell'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.
  8. Scegli un ambiente , se applicabile.
  9. Inserisci gli indirizzi email per rendere disponibile l'app di chat a utenti e gruppi specifici, se applicabile.
  10. Fai clic su Avvia.

Test

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

  1. Apri Google Chat.
  2. Fai clic su Nuova chat.
  3. Nel campo Aggiungi una o più persone, digita 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

I messaggi di risposta avanzati sono supportati tramite Payload personalizzato in fulfillment. Per il formato del messaggio, consulta l'API dei messaggi di Google Chat.

Messaggio di testo

Il seguente payload personalizzato fornisce un messaggio di testo di Google Chat testo:

{
  "text": "Hello, world"
}

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

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

Messaggio della scheda

Il seguente payload personalizzato fornisce un messaggio della scheda di Google Chat card message:

{
  '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 della scheda di Google Chat se utilizzi un componente aggiuntivo di Chat:

{
  "host_app_data_action": {
    "chat_data_action": {
      "create_message_action": {
        "message": {
          "cardsV2": [
            {
              "card_id": "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 verranno utilizzate automaticamente quando l'agente risponde ai messaggi di Google Chat.