Slack

Slack 統合を使用すると、Dialogflow CX テクノロジーを基盤とし、自然言語理解を備えた Slack の bot を作成できます。

制限事項

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

Slack を設定する

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

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

Slack bot を作成する

[Slack Apps] に移動します。

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

display_information:
  name: Dialogflow CX
  description: 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] に移動します。
- 署名トークン: [Basic Information] > [App Credentials] > [Signing Secret] に移動します。

Dialogflow CX を設定する

ナビゲーションメニューの [管理] タブに移動します。
[統合] を選択します。
[Slack] タイルの [Connect] ボタンをクリックします。
次の情報を入力します。
- アクセストークン
- 署名トークン
該当する環境を選択します。
[開始] をクリックします。
[Webhook URL] の値をコピーします。

Slack で Webhook を有効にする

[Slack Apps] に移動し、[Event Subscriptions] > [Enable Events] > [Request URL] に Webhook URL を貼り付けます。

テスト

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

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

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

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

{
  "text": "Hello, world"
}

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

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