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] の [接続] をクリックします。
- 次の必須情報を入力します。
- 名前: メッセージ、検索、名前リンク付きメッセージなど、このアプリで作成されたコンテンツを操作または消費するユーザーに表示される名前。例:
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 アプリを特定のユーザーおよびグループが使用できるように、メールアドレスを入力します。
- [Start] をクリックします。
テスト
構成したアプリをテストするには、Google Chat スペースで名前リンクを貼り付けるか、DM を送信します。たとえば、
- Google Chat を開きます。
- [チャットを新規作成] をクリックします。
- [1 人以上を追加] 欄に Chat アプリの名前を入力します。
- 検索結果から Chat アプリを選択します。ダイレクト メッセージが開きます。
リッチ レスポンス メッセージ
リッチ レスポンス メッセージは、フルフィルメントのカスタム ペイロードによってサポートされます。メッセージ形式については、Google Chat Message API をご覧ください。
テキスト メッセージ
次のカスタム ペイロードは、Google Chat のテキスト メッセージを提供します。
{ "text": "Hello, world" }
カード メッセージ
次のカスタム ペイロードは、Google Chat カード メッセージを提供します。
{ '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' } } } ] } } ] } ] } }] }
チャネル固有のレスポンス
構成すると、エージェントが Google Chat メッセージに応答するときに、チャネル DF_CX_GOOGLE_CHAT
のチャネル固有のレスポンスが自動的に使用されます。