Google Chat

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

Limitazioni

Configurare Google Chat

Per configurare l'integrazione di Google Chat per il tuo agente, ti serviranno quanto segue:

Abilita l'API Google Chat

Prima di utilizzare le API 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. Verifica di abilitare le API nel progetto Cloud corretto, poi fai clic su Avanti.

  3. Verifica di attivare le API corrette, quindi fai clic su Attiva.

Configurazione da Conversational Agents (Dialogflow CX)

  1. Vai alla console Dialogflow CX.
  2. Scegli il tuo progetto Google Cloud.
  3. Seleziona il tuo agente.
  4. Seleziona la scheda Gestisci.
  5. Fai clic su Integrations (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 agli utenti che interagiscono o consumano contenuti creati da questa app, ad esempio in messaggi, ricerca e @menzioni. Ad esempio Conversational Agents (Dialogflow CX) App.
    • URL avatar: l'immagine dell'avatar visualizzata 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, se applicabile.
  9. Inserisci gli indirizzi email per rendere disponibile questa 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 Chat.
  4. Seleziona l'app Chat dai risultati. Viene visualizzato un messaggio diretto.

Messaggi di risposta avanzati

I messaggi di risposta avanzata sono supportati utilizzando il payload personalizzato in Esecuzione. Consulta API messaggio di Google Chat per il formato del messaggio.

Messaggio di testo

Il seguente payload personalizzato fornisce un messaggio di Google Chat:

{
  "text": "Hello, world"
}

Messaggio della scheda

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

{
  'cardsV2': [{
    'cardId': 'createCardMessage',
    'card': {
      'header': {
        'title': 'A card message!',
        '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': 'Read the docs!',
                    'onClick': {
                      'openLink': {
                        'url': 'https://developers.google.com/workspace/chat'
                      }
                    }
                  }
                ]
              }
            }
          ]
        }
      ]
    }
  }]
}

Risposte specifiche per canale

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