Google Chat

会話エージェント（Dialogflow CX）の Google Chat の統合により、会話エージェント（Dialogflow CX）テクノロジーを基盤とし、自然言語理解を備えた Google Chat 用アプリを作成できます。

制限事項

この統合では、エージェントのデフォルト言語のテキスト入力のみがサポートされます。

Google Chat を設定する

エージェントの Google Chat 統合を設定するには、以下が必要です。

Google Chat へのアクセス権を持つ Google Workspace アカウント。
Google Cloud プロジェクト。

Google Chat API を有効にする

Google API を使用する前に、Google Cloud プロジェクトで API を有効にする必要があります。1 つの Google Cloud プロジェクトで 1 つ以上の API を有効にできます。

Google Cloud コンソールで、Google Chat API と Dialogflow API を有効にします。
正しい Cloud プロジェクトで API が有効になっていることを確認し、[次へ] をクリックします。
正しい API を有効にしていることを確認し、[有効にする] をクリックします。

会話エージェント（Dialogflow CX）から設定する

Dialogflow CX コンソールに移動
ご自身の Google Cloud プロジェクトを選択します。
エージェントを選択します。
[Manage] タブを選択します。
左側のサイドバーメニューで [Integrations] をクリックします。
[Google Chat] の [接続] をクリックします。
次の必須情報を入力します。
- 名前: メッセージ、検索、名前リンクなどで、このアプリで作成されたコンテンツを操作または消費するユーザーに表示される名前。例: Conversational Agents (Dialogflow CX) App。
- アバターの URL: アプリを操作するユーザーに表示されるアバターの画像。正方形（アスペクト比 1:1）の PNG 画像をホストする HTTPS URL を指定してください。推奨最小サイズ: 256 × 256 ピクセル。例: https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png。
- 説明: アプリの説明。例: A helpful bot that responds to real human conversation
該当する環境を選択します。
該当する場合は、この Chat アプリを特定のユーザーおよびグループが使用できるように、メールアドレスを入力します。
[開始] をクリックします。

テスト

構成したアプリをテストするには、Google Chat スペースで名前リンクを貼り付けるか、DM を送信します。例:

Google Chat を開きます。
[チャットを新規作成] をクリックします。
[1 人以上を追加] 欄に Chat アプリの名前を入力します。
検索結果から Chat アプリを選択します。ダイレクトメッセージが開きます。

リッチレスポンスメッセージ

リッチレスポンスメッセージは、フルフィルメントのカスタムペイロードによってサポートされます。メッセージの形式については、Google Chat メッセージ API をご覧ください。

テキストメッセージ

次のカスタムペイロードは、Google Chat のテキストメッセージを提供します。

{
  "text": "Hello, world"
}

カードメッセージ

次のカスタムペイロードは、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'
                      }
                    }
                  }
                ]
              }
            }
          ]
        }
      ]
    }
  }]
}

チャネル固有のレスポンス

構成すると、エージェントが Google Chat メッセージに応答するときに、チャネル DF_CX_GOOGLE_CHAT のチャネル固有のレスポンスが自動的に使用されます。