Google Chat

L'integrazione di Google Chat con Dialogflow CX ti consente di creare Google Chat app 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 della seguenti:

Abilitare 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. Nella console Google Cloud, abilita l'API Google Chat e l'API Dialogflow.

  2. Assicurati di abilitare le API nel progetto Cloud corretto, poi 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. Scegli il progetto Google Cloud.
  3. Seleziona l'agente.
  4. Seleziona la scheda Gestisci.
  5. Fai clic su Integrations (Integrazioni) nel menu della barra laterale sinistra.
  6. Fai clic su Connetti su Google Chat.
  7. Inserisci le seguenti informazioni obbligatorie:
    • Nome: il nome mostrato agli utenti che interagiscono con i contenuti creati da questa app, ad esempio nei messaggi, nella ricerca e nelle @menzioni, o che consumano contenuti creati da questa app. Ad esempio Dialogflow CX App.
    • URL avatar: l'immagine avatar mostrata agli 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 a seconda dei casi.
  9. Inserisci gli indirizzi email per rendere disponibile l'app Chat a persone e gruppi specifici, a seconda dei casi.
  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 dell'app di Chat.
  4. Seleziona la tua app Chat dai risultati. Si apre un messaggio diretto.

Messaggi di risposta avanzati

I messaggi di risposta avanzati sono supportati tramite Payload personalizzato in Completamento. Consulta API Google Chat message per il formato del messaggio.

Messaggio di testo

Il seguente payload personalizzato fornisce un'interfaccia messaggio di testo:

{
  "text": "Hello, world"
}

Messaggio della carta

Il seguente payload personalizzato fornisce una chat di Google messaggio nella scheda:

{
  'cardsV2': [{
    'cardId': 'createCardMessage',
    'card': {
      'header': {
        'title': 'A card message!',
        'subtitle': 'Sent from Dialogflow',
        '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'
                      }
                    }
                  }
                ]
              }
            }
          ]
        }
      ]
    }
  }]
}

Risposte specifiche per 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.