Google Chat

Conversational Agents (Dialogflow CX) 的 Google Chat 整合功能可讓您以 Conversational Agents (Dialogflow CX) 技術為基礎，建立具有自然語言理解能力的 Google Chat 應用程式。

限制

這項整合功能僅支援以服務專員的預設語言輸入文字。

設定 Google Chat

如要為代理程式設定 Google Chat 整合，您必須符合以下條件：

具有 Google Chat 存取權的 Google Workspace 帳戶。
Google Cloud 專案。

啟用 Google Chat API

使用 Google API 前，您需要在 Google Cloud 專案中啟用這些 API。您可以在單一 Google Cloud 專案中啟用一或多個 API。

在 https://console.cloud.google.com/中，啟用 Google Chat API 和 Dialogflow API。
確認您要在正確的 Cloud 專案中啟用 API，然後按一下「下一步」。
確認要啟用的 API 正確無誤，然後按一下「啟用」。

從 Conversational Agents (Dialogflow CX) 設定

前往 Dialogflow CX 主控台。
選擇 Google Cloud 專案。
選取代理程式。
選取「管理」分頁標籤。
按一下左側欄選單中的「整合」。
按一下「Google Chat」上的「連結」。
填寫下列必要資訊：
- 名稱：使用者與這個應用程式互動，或使用這個應用程式建立的內容時 (例如在訊息、搜尋中或使用 @號提及時)，應用程式的顯示名稱。例如 Conversational Agents (Dialogflow CX) App。
- 顯示圖片網址：與應用程式互動的使用者會看到的顯示圖片。請指定含有正方形 (顯示比例為 1:1) PNG 圖片的 HTTPS 網址。建議大小下限為 256 x 256 像素。例如 https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png。
- 說明：應用程式的說明，例如 A helpful bot that responds to real human conversation。
視情況選擇「環境」。
輸入電子郵件地址，視需要將這個 Chat 擴充應用程式提供給特定使用者和群組。
按一下「啟動」。

測試

如要測試設定的應用程式，請在 Google Chat 聊天室中提及該應用程式，或傳送即時訊息給該應用程式。例如，假設使用者要求系統將文字從英文翻譯成法文

開啟 Google Chat。
按一下「發起新即時通訊」。
在「新增 1 位以上使用者」欄位中，輸入 Chat 應用程式的名稱。
從結果中選取 Chat 應用程式。系統會開啟即時訊息。

複合式回應訊息

如要支援豐富的回覆訊息，請在履行中使用自訂酬載。如需訊息格式，請參閱「Google Chat 訊息 API」。

簡訊

以下自訂酬載會提供 Google Chat 文字訊息：

{
  "text": "Hello, world"
}

如果您使用 Chat 外掛程式，以下自訂酬載會提供 Google Chat 簡訊：

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

資訊卡訊息

以下自訂酬載提供 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'
                      }
                    }
                  }
                ]
              }
            }
          ]
        }
      ]
    }
  }]
}

如果您使用 Chat 外掛程式，下列自訂酬載會提供 Google 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"
                                }
                              }
                            }
                          ]
                        }
                      }
                    ]
                  }
                ]
              }
            }
          ]
        }
      }
    }
  }
}

管道專屬回覆

設定完成後，當服務專員回覆 Google Chat 訊息時，系統會自動使用含有管道 DF_CX_GOOGLE_CHAT 的管道專屬回覆。