Dialogflow と Google Chat の統合

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

Dialogflow と Google Chat の統合により、1 対 1 の会話や Chat スペースに含めることができる Chat アプリを作成できます。詳細については、Google Chat API のデベロッパー ドキュメントをご覧ください。

制限事項

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

設定

Google Chat の統合を設定して有効にするには、次の手順を行います。

  1. 左側のメニューで [Integrations] をクリックします。
  2. [Hangouts Chat] をクリックします。
  3. アクセス オプションを選択します。
  4. (省略可)エージェント環境を選択します。
  5. [起動] をクリックします。

チャットアプリを構成する

Google Chat アプリの作成後、統合ポップアップの [CONFIGURE BOT DETAILS] ボタンをクリックすると、詳細を変更できます。これで、Google Chat API の Google Cloud Console ページが表示されます。

Google Chat API アプリの公開ガイドの手順に沿って、アプリを構成して公開します。

チャットアプリのアバターを構成する

アプリのアバターを構成するには、次の 2 つの方法があります。

  • 統合設定の [CONFIGURE BOT DETAILS] ボタンをクリックし、[Avatar URL] フィールドにアバターの URL を入力します。
  • エージェントの一般設定の [Agent Avatar URI] フィールドにアバターの URL を入力します。

Google Cloud コンソールを有効にして構成する

Google Cloud コンソールで次の手順を行うことによっても Google Chat の統合を有効にできます。

  1. Google Cloud コンソールで、左上隅にあるメニュー アイコン()をクリックします。
  2. [API とサービス] > [ダッシュボード] の順にクリックします。
  3. [API とサービスを有効化] をクリックします。
  4. 「Google Chat API」を検索します。
  5. [Google Chat API] タイルをクリックします。
  6. [有効にする] をクリックします。
  7. 左側のサイドバー メニューで [設定] をクリックします。
  8. Google Chat API アプリの公開ガイドの手順に沿って、アプリを構成して公開します。

テスト

Chat アプリをテストする前に、アプリを起動していることを確認します(設定セクションを参照)。

アプリをテストする手順は、次のとおりです。

  1. Google Chatを開きます。
    1. [Start a chat] > [Find apps] をクリックして、アプリに新しいダイレクト メッセージを送信します。
    2. [Find apps] ページで、アプリの名前を検索します。
    3. アプリの横にある [Chat] をクリックします。
    4. そのアプリの新しいダイレクト メッセージに、「Hello」と入力して enter を押します。

トラブルシューティング

エラー 解決策
管理者の設定により、ダイレクト メッセージでアプリとやり取りできません。 Chat アプリのインストールをユーザーに許可するように、Google Workspace 管理者に依頼してください。

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

この統合により、一部のリッチ レスポンス メッセージGoogle Chat のメッセージ タイプに変換されます。

テキストのレスポンス

テキスト レスポンスSimpleText として Google Chat に送信されます。このフォーマットでは、テキストを特定の(マークダウン ライト)記号で囲むことにより、太字や斜体にできます。

SimpleText レスポンスは、Dialogflow コンソールのデフォルトのテキスト レスポンスと同じように表示されます。ただし、未加工の API レスポンスは少し異なります。また、プラットフォーム構成を GOOGLE_HANGOUTS に設定して、複数の統合用のエージェントを構築するときに興味深い情報を提供します。

"fulfillmentMessages": [
{
   "text": {
   "text": [
        "This is a test."
   ]
},
  "platform": "GOOGLE_HANGOUTS"
},

画像

画像レスポンスは、Google Chat 画像ウィジェットとして Google Chat に送信されます。

カード

カード形式のレスポンスは、Google Chat カードとして Google Chat に送信されます。

カスタム ペイロード

他の種類の Google Chat メッセージを送信するには、カスタム ペイロードを使用します。

Google Chat のカスタム ペイロードを使用すると、より高度なカードを作成できます。1 つのカードは 1 つ以上のセクションを持つことができます。各セクションにはヘッダーを含めることができます。Google Chat メッセージ形式カードのリファレンス ガイドを参照して、これで作成できる組み合わせのいくつかを確認できます。ただし、カスタム ペイロードを使用する場合は、JSON 形式を指定する必要があります。

有効な例は次のとおりです。

{
  "hangouts": {
    "header": {
      "title": "Pizza Delivery Customer Support",
      "subtitle": "pizzadelivery@example.com",
      "imageUrl": "https://goo.gl/aeDtrS"
    },
    "sections": [{
      "widgets": [{
        "keyValue": {
          "icon": "TRAIN",
          "topLabel": "Order No.",
          "content": "12345"
        }
      },
      {
        "keyValue": {
          "topLabel": "Status",
          "content": "In Delivery"
        }
      }]
    },
    {
      "header": "Location",
      "widgets": [{
        "image": {
          "imageUrl": "https://dummyimage.com/600x400/000/fff"
        }
      }]
    },
    {
      "header": "Buttons - I could leave the header out",
      "widgets": [{
        "buttons": [{
          "textButton": {
            "text": "OPEN ORDER",
            "onClick": {
              "openLink": {
                "url": "https://example.com/orders/..."
              }
            }
          }
        }]
      }]
    }]
  }
}