IBM Cloud Docs
Slack との統合

Slack との統合

IBM Cloud

Slack は、ユーザー同士のコラボレーションを支援するクラウド・ベースのメッセージング・アプリケーションです。

アクションを作成した後でアシスタントを Slack と統合できます。

統合すると、サポートするようにアシスタントを構成したイベントに応じて、アシスタントは、ダイレクト・メッセージで尋ねられた質問、またはアシスタントが直接言及されているチャネルで尋ねられた質問に応答できます。

watsonx Assistant、Slack、および Db2 を使用して Slackbot を作成する方法の例と手順については、ソリューション・チュートリアル Build a database-driven Slackbot を参照してください。

開始前に

Slackとアシスタントを統合するには、Slackアプリと必要な役割と権限が必要です：

役割 権限
ワークスペースまたは
組織の所有者		 「情報の表示」
「情報の投稿」
「アクションの実行」

slackアプリを作成するには、クイックスタートを参照してください：ワークフローを開始するを参照してください。

ロールとパーミッションの詳細については、スラックを始めるを参照してください。

Slack 統合の追加

  1. **「統合」**ページに移動します。それには、左側のメニューにある統合アイコン (統合アイコン) をクリックします。

  2. 「追加」 (Slack タイル上) をクリックします。

  3. 次に、再度 「追加」 をクリックします。

使用を開始する

Slackの設定には4つのステップがある：

  • Slackボットを設定する
  • watsonx Assistant を Slack に接続
  • Slackボットを設定する
  • アシスタントをつなぐ

Slackボットを設定する

  1. Slackウェブサイトの アプリページにアクセスし、使いたいアプリをクリックするか、新しいアプリを作成します。

watsonx Assistant を Slack に接続

  1. Slackアプリの設定ページで、 基本情報タブに移動し、下にスクロールしてアプリ認証情報セクションを開きます。

  2. 認証トークンをコピーして、アシスタントの設定ページに貼り付けます。

  3. Slack app settings ページで、Features > OAuth & Permissions と進み、Bot Token Scopes セクションまでスクロールダウンしてください。

  4. 「OAuthスコープを追加」 をクリックし、以下のスコープを選択します

    • app_mentions:read
    • chat:write
    • im:history
    • im:read
    • im:write

  5. ページを OAuth Tokens for Your Workspace セクションまでスクロールし、Install App to Workspace をクリックし、Allow をクリックします。

    OAuth & Permissionsページにリダイレクトされます。

  6. ボットユーザーのOAuthアクセストークンをコピーして、アシスタントの設定ページに貼り付けます。

  7. **「次へ」**をクリックして先に進みます。

Slackボットを設定する

  1. 生成されたURL をコピーします。

  2. Slackアプリの設定ページで、Features > Event Subscriptions と進み、イベントを有効にするトグル on を切り替えます。

  3. URL の下に URLを貼り付けます。

    URL の横に緑色のチェックマークが付いた 「認証済み」 と表示されるまでお待ちください。

  4. 下にスクロールし、ボットイベントを購読するをクリックします。

  5. 購読したいイベントの種類を選択します。 次のタイプから少なくとも 1 つ選択する必要があります。

    • message.im: ダイレクト・メッセージ・チャネルに投稿されるメッセージ・イベントを listen します。

    • app_mention: アプリまたはボットに言及するメッセージ・イベントのみを listen します。

      太字フォントの app_mention エントリーではなく、通常フォントの app_mention エントリーを選択してください。

  6. **「変更を保存」**をクリックします。

  7. アシスタント設定ページで、次へをクリックします。

アシスタントをつなぐ

  1. Slackアプリの設定ページで、機能 > AppHome と進み、アプリ表示名の横にある編集をクリックします。

  2. 変更が完了したら、保存をクリックします。

  3. Always Show My Bot as Online トグルを on に切り替えます。

  4. タブを表示セクションに移動し、メッセージタブを on に切り替えます。

  5. ユーザーがメッセージタブからSlashコマンドとメッセージを送信できるようにするチェックボックスをオンにします。

  6. Slackアプリにボタン、メニュー、曖昧さ解消オプションを表示するサポートを追加したい場合は、以下の手順を実行してください：

    1. Interactivity & Shortcuts タブに行き、機能を有効にする
    2. リクエストURLを、用意されたテキスト入力欄に貼り付けます。
    3. **「変更を保存」**をクリックします。

  7. アシスタント設定ページで、完了をクリックします。

認証に必要な token フィールドが変更された場合は、関連フィールドのすべての項目に入力して、再度検証する必要があります。

アクションに関する考慮事項

アクションに追加したリッチな応答は、次の例外を除いてSlackチャンネルに表示されます

  • オペレータに接続 ：この応答タイプは無視されます。

  • Option: この応答タイプでは、ユーザーが選択できるオプションのリストが表示されます。

    • ユーザーが選択肢の一つをクリックすると、既存の選択項目は消え、ユーザーの選択によって生成されたユーザー入力に置き換わる。 1つのレスポンスに複数のレスポンスタイプを含める場合は、レスポンスとユーザー入力の混在による混乱を避けるため、オプションのレスポンスタイプを最後に配置する必要があります。

    • オプションをドロップダウン・リスト形式で表示する場合は、各オプションの値の長さが 75 文字以下でなければなりません。 リストに5つ以上のオプションが含まれる場合、ドロップダウンリストで表示されます。

アシスタントとのチャット

アシスタントとチャットを開始するには、以下の手順を実行します。

  1. Slack を開き、アプリに関連するワークスペースに移動します。
  2. 「アプリ」セクションで作成したアプリケーションをクリックします。
  3. アシスタントとチャットします。

ウェルカム・アクションは Slack 統合では処理されません。 ウェルカム・メッセージは、アシスタント・プレビューとは異なり Slack チャネルには表示されません。 これがここからトリガーされない理由は、welcome 特殊条件を持つノードが、ユーザーによって開始されたダイアログ・フローではスキップされるためです。 Slack は、ユーザーが会話を開始するのを待ちます。

現行セッションのアクション・フローは、60 分間 (ライト・プランおよび標準プランの場合は 5 分間) 何の操作も行われないと再開されます。 つまり、ユーザーがアシスタントとの対話を停止し、60 分 (または 5 分) 経過すると、以前の会話中に設定されたコンテキスト変数の値はすべてヌルに設定されるか、デフォルト値に戻されます。