Dialogflow Hangouts の統合

Dialogflow Hangouts の統合により、一対一のチャットやチャットルームに含める bot を作成できます。詳細については、Hangouts Chat API のドキュメントをご覧ください。

設定

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

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

ボットを構成する

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

Hangouts Chat API Publishing bots のガイドの手順に沿って bot を構成して公開します。

Cloud Console を有効にして構成する

次の手順に従って、Cloud Console で Hangouts 統合を有効にすることもできます。

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

テスト

テストを開始する前に、ボットを起動しておく必要があります(設定セクションを参照)。

ボットをテストするには、次の手順に従います。

  1. Hangouts Chat にアクセスします。
  2. [Search] フィールドをクリックします。
  3. [Find a bot] を選択します。
  4. ボットの名前を選択します。
  5. [Message] をクリックします。

トラブルシューティング

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

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

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

テキストのレスポンス

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

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

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

画像

画像レスポンスハングアウト画像ウィジェットとしてハングアウトに送信されます。

カード

カード レスポンスハングアウト カードとしてハングアウトに送信されます。

カスタム ペイロード

その他の種類のハングアウト メッセージを送信する場合に、カスタム ペイロードを使用できます。

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

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

{
  "hangouts": {
    "header": {
      "title": "Pizza Bot Customer Support",
      "subtitle": "pizzabot@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/..."
              }
            }
          }
        }]
      }]
    }]
  }
}