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 のチャネル固有のレスポンスが自動的に使用されます。