Slack Web API の統合

Workspace ONE Intelligence ワークフローで Slack Web API コネクタを使用するため、Slack との統合を更新しました。この統合では、Slack の API を使用してワークフローアクションを展開する Slack アプリケーションを作成および構成し、Slack ワークスペースに Slack アプリケーションをインストールして、Slack Web API コネクタをセットアップします。プライベートチャネルを追加し、既存のワークフローを監査して、Slack Web API コネクタを使用することもできます。

Webhook を廃止する Slack

Slack は Webhook のサポート終了日をまだ提示していませんが、webhook は廃止され、削除される可能性があることを警告します。

プロセスの概要

この統合により、Slack の API サイトで Slack アプリケーションを作成します。次に、Intelligence ワークフローで使用する Slack アプリケーションを構成します。このアプリケーションは、Slack の API を使用して、Workspace ONE Intelligence ワークフローで構成された送信アクションを展開します。

ダイレクトメッセージを送信します。
パブリックチャネルにメッセージを送信します。
プライベートチャネルにメッセージを送信します。

Workspace ONE Intelligence の統合セクションで Slack Web API コネクタを構成し、Slack アプリケーション を介して Slack およびその API を Workspace ONE Intelligence で接続して、統合を完了します。

ワークフローテンプレートに Slack Web API を使用する

レガシーの Slack 統合では使用がサポートされていないため、Slack Web API コネクタを使用してワークフローテンプレートを使用します。

ワークフローの Slack Web API アクション

ワークフローでメッセージの送信アクションを使用して、Slack を介してメッセージを送信できます。

Slack Web API 統合手順

Slack の API サイトおよび Workspace ONE Intelligence で作業し、Slack ワークスペースを Intelligence と統合することで、ワークフローのアクションに Slack の API を使用できます。

Slack の API サイトで、Slack アプリケーション を作成します。
1. https://api.slack.com/apps に移動します。Slack アプリケーションを作成するには、Slack アカウントにログインしている必要があります。
2. アプリケーションの作成 を選択します。
3. スクラッチから 作成するオプションを選択します。
4. [アプリケーション名] フィールドに名前を入力し、[アプリケーションを開発するためのワークスペースの選択] ドロップダウンメニューでスペースを選択します。
5. アプリケーションの作成 を選択します。
Slack の API サイトで、該当する Slack ワークスペースに Slack アプリケーションをインストールし、Workspace ONE Intelligence で使用します。
1. https://api.slack.com/apps で Slack アプリケーションを選択し、[機能] > [OAuth と権限] の順に選択します。
2. 範囲セクションに移動し、次の ボットトークンの範囲 を追加します。
  - incoming-webhook
  - chat:write.customize
  - chat:write
  - chat:write.public（この範囲では、このアプリケーションをパブリックチャネルで使用できます）。
3. [設定] > [基本情報] の順に移動します。
4. Slack 用アプリケーションの構築 セクションで、アプリケーションのインストール を選択し、Workspace へのアプリケーションのインストール を選択します。
  - アプリケーションをインストールするワークスペースとチャネルを選択します。
  - Workspace ONE Intelligence ワークフローで使用する追加の個人、プライベートチャネル、およびパブリックチャネルの設定を構成できます。
5. [機能] > [OAuth と権限] に移動し、ワークスペース用の OAuth トークン セクションに進みます。
6. ボットユーザー OAuth トークン をコピーして、Workspace ONE Intelligence に追加できるようにします。
Workspace ONE Intelligence で Slack Web API コネクタをセットアップします。
1. Workspace ONE Intelligence で、[統合] > [ワークフローコネクタ] > [Slack Web API] の順に移動します。
2. Slack Web API カードのセットアップを選択し、リストされた値を入力します。
  - ベース URL：デフォルトの URL https://slack.com/api/chat.postMessage を入力します。
  - ヘッダー名：認証と入力します。
  - ヘッダー値：テキストエディタを使用してヘッダー値を作成すると、テキストフィールドにコピーできます。テキストエディタを使用する必要はありません。ヘッダー値テキストフィールドに値をそのまま入力できます。
    1. テキストエディタを開くか、 ヘッダー値テキストフィールドにカーソルを重ねます。
    2. Bearer という単語を入力します。
    3. Bearerの後にスペースを入力します。
    4. トークン xoxb-<token> をコピーし、スペースの後に入力します。
      最終的には、Bearer xoxb-<token> のような入力結果になります。
    5. テキストエディタを使用した場合は、テキストエディタのヘッダー値をヘッダー値テキストフィールドにコピーします。
3. 設定を保存します。

これで、Workspace ONE Intelligence ワークフローで Slack Web API コネクタを使用する準備が整いました。Slack の API サイトで入力した Slack の範囲に応じて、ダイレクトメッセージとメッセージをパブリックチャネルに送信します。

Slack アプリケーションをプライベートチャネルに追加する

ワークフローのアクションとしてプライベートチャネルにメッセージを送信するには、目的の Slack チャネルに Slack アプリケーションを追加します。

Slack を開き、プライベート Slack チャネルに移動します。
Slack チャネル名の横にあるドロップダウンを選択します。
[統合] > [アプリケーションの追加] の順に移動します。
アプリケーションを選択し、Slack チャネルに追加します。

元の Slack（廃止）コネクタを使用している場合は、次の手順を実行します。

既存のワークフローを監査し、Slack（廃止） アクションを Slack Web API アクションに置き換えます。
今後のワークフローの構築時に混乱を避けるために、Slack（廃止） コネクタを切断します。

Slack (非推奨)

このレガシープロセスは当面使用することができ Slack は Webhook のサポート終了日をまだ提示していませんが、webhook は廃止され、削除される可能性があることを警告します。

Slack を API 通信用に構成し、Slack を Workspace ONE Intelligence に登録できるように、また Slack ワークフローアクションを使用できるようにします。

手順

Slack のヘルプで、Incoming WebHook を検索します。
Slack で Incoming WebHook 統合を構成して、Slack API に接続してメッセージを送信できるようにします。
メッセージのデフォルトチャンネルを定義します。メッセージを作成するときに、このチャンネルをオーバーライドできます。
Workspace ONE Intelligence で、[統合] > [ワークフローコネクタ] > [Slack] > [設定] の順に移動します。
[資格情報を提供] タブで、[ベース URL] フィールドに Slack WebHook URL を入力します。
[認証タイプ] として [認証なし] を選択します。