一部のサービスと機能は名前を変更中です。生成ハンドブックとフロー機能も、単一の統合コンソールに移行されます。詳しくは、こちらをご覧ください。

Slack

Slack 統合を使用すると、会話エージェント（Dialogflow CX）テクノロジーを基盤とし、自然言語理解を備えた Slack の bot を簡単に作成できます。

制限事項

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

Slack を設定する

エージェントの Slack 統合を設定するには、次のものが必要です。

Slack アカウント
Slack ワークスペース

Slack ボットを作成する

Slack アプリに移動します。

アプリマニフェストから新しい Slack アプリを作成します。マニフェストの例を以下に示します。oath_config フィールドと oath_config フィールドがサンプルマニフェストと一致していることを確認します。

display_information:
  name: Conversational Agents (Dialogflow CX)
  description: Conversational Agents (Dialogflow CX) integration
  background_color: "#1148b8"
features:
  app_home:
    home_tab_enabled: false
    messages_tab_enabled: true
    messages_tab_read_only_enabled: false
  bot_user:
    display_name: CX
    always_online: true
oauth_config:
  scopes:
    bot:
      - app_mentions:read
      - chat:write
      - im:history
      - im:read
      - im:write
      - incoming-webhook
settings:
  event_subscriptions:
    request_url: https://dialogflow-slack-4vnhuutqka-uc.a.run.app
    bot_events:
      - app_mention
      - message.im
  org_deploy_enabled: false
  socket_mode_enabled: false
  token_rotation_enabled: false

任意のワークスペースにアプリケーションをインストールします。
- Bot User OAuth Token
  - Install App > OAuth Tokens for Your Workspace > Bot User OAuth Token に移動します。
- 署名トークン
  - [基本情報] > [アプリの認証情報] > [署名シークレット] に移動します。

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

左側のパネルで [Manage] タブをクリックします。
左側のメニューで [Integrations] をクリックします。
[Slack] タイルの [Connect] ボタンをクリックします。
次の情報を入力します。
- アクセストークン
- 署名トークン
該当する環境を選択します。
[開始] をクリックします。
[Webhook URL] の値をコピーします。

Slack で Webhook を有効にする

Slack アプリに戻り、[イベントサブスクリプション] > [イベントを有効にする] > [リクエスト URL] に Webhook URL を貼り付けます。

テスト

構成したアプリをテストするには、アプリをインストールしたワークスペースで、グループチャンネルでアプリをメンションするか、DM を送信します。

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

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

たとえば、次のカスタムペイロードは単純な Slack テキストメッセージを提供します。

{
  "text": "Hello, world"
}

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

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