Slack スポーク
Slack スポークを使用し、メッセージを投稿したり、チャネルへのアクセスを管理したりします。
統合ハブサブスクリプション
このスポークには Integration Hub のサブスクリプションが必要です。詳細については、「法務スケジュール - IntegrationHub の概要」を参照してください。 サブスクリプションの詳細については、アカウント マネージャーにお問い合わせください。
スポークバージョン
Slack スポーク v 1.6.0 が最新バージョンです。
Slack アカウントの要件
スポークのサブフロー
| サブフロー | 説明 |
|---|---|
| メンバー ID 別に Slack ユーザーの詳細を挿入 | メンバー ID に基づいて、必要なユーザーの詳細を Slack ユーザーキャッシュモジュールに挿入します。 |
| ユーザー ID 別に Slack ユーザーの詳細を挿入 | ユーザー ID に基づいて、必要なユーザーの詳細を Slack ユーザーキャッシュモジュールに挿入します。 |
| アクション可能なメッセージを投稿 | アクション可能なメッセージをSlackチャネルに投稿します。 注: このサブフローでは、入力として送信構成が必要です。デフォルトの送信構成をカスタマイズしたり、要件に応じて送信構成を作成したりします。詳細については、「ServiceNowインスタンスで送信構成を設定」を参照してください。 |
| 承認メッセージを投稿 | 承認メッセージをSlackチャネルに投稿します。 注: このサブフローでは、入力として送信構成が必要です。デフォルトの送信構成をカスタマイズしたり、要件に応じて送信構成を作成したりします。詳細については、「ServiceNowインスタンスで送信構成を設定」を参照してください。 |
| Slack 承認メッセージに応答 | 確認応答メッセージを Slack チャネルに投稿します。 |
| Slack コマンドに応答 | コマンドへの応答を Slack チャネルに投稿します。 |
| Slack メッセージアクションに応答 | 通知をSlackチャネルに投稿します。 |
サブフローをカスタマイズするときは、サブフローが無限ループを回避するように構成されていることを確認する必要があります。
スポークのアクション
Slack スポークでは、ServiceNow インスタンスでイベントが発生したときに Slack ワークスペースタスクを自動化するアクションが提供されます。使用可能なアクションは次のとおりです。
| カテゴリ | アクション | 説明 |
|---|---|---|
| 会話管理 | チャネルにユーザーを追加 | Slack ワークスペース内の指定されたチャネルに既存ユーザーを追加します。 |
| チャネルのアーカイブ | Slack ワークスペース内のチャネルをアーカイブします。 | |
| 会話の名前を変更 | 会話の名前を変更します。 | |
| 会話情報を検索 | 会話に関する情報を取得します。 | |
| チャネルを作成 | Slack ワークスペースにチャネルを作成します。 | |
| 会話またはメンバー ID で添付ファイルストリームを検索 | 適切なチャネル、メンバー、またはボットユーザーに関連付けられた添付ファイルを取得します。 | |
| チャネル履歴ストリームを検索 | チャネルの履歴を取得します。チャネル ID、開始日、終了日を入力する必要があります。 | |
| 会話を検索 | 指定されたチャネルからスレッドの会話メッセージを取得します。 | |
| 会話を開く | 1 つのダイレクトメッセージまたは複数ユーザーのダイレクトメッセージを開くか再開します。 | |
| メンバー ID で会話 ID ストリームを検索 | Slack の指定されたメンバーに関連付けられた会話 ID の詳細を取得します。 | |
| チャネルのトピックを設定 | Slack チャネルのトピックを設定します。 | |
| チャネルからユーザーを削除 | Slack ワークスペース内のチャネルからユーザーを削除します。 | |
| 通知管理 | アクション可能なメッセージを投稿 | アクション可能なメッセージを Slack チャネルに投稿します。 注: このアクションでは、入力として送信構成が必要です。デフォルトの送信構成をカスタマイズしたり、要件に応じて送信構成を作成したりします。詳細については、「ServiceNowインスタンスで送信構成を設定」を参照してください。 |
| 承認メッセージを投稿 | 承認メッセージをSlackチャネルに投稿します。 注: このアクションでは、入力として送信構成が必要です。デフォルトの送信構成をカスタマイズしたり、要件に応じて送信構成を作成したりします。詳細については、「ServiceNowインスタンスで送信構成を設定」を参照してください。 |
|
| 変更の詳細を投稿 | 変更レコードの詳細をチャネルに投稿します。 | |
| インシデントの詳細を投稿 | インシデントレコードの詳細をチャネルに投稿します。 | |
| メッセージを投稿 | メッセージをSlackチャネルに投稿します。 | |
| 応答を Slack に投稿 | 応答を Slack に投稿します。 | |
| 承認レコードを更新 | 承認レコードを更新します。 | |
| 問題の詳細を投稿 | 問題レコードの詳細をチャネルに投稿します。 | |
| ユーザー管理 | ユーザーを作成 | Slack ワークスペースにユーザーを作成します。 注: このアクションには、Slack アカウントのユーザートークンが必要です。ボットユーザートークンがある場合、このアクションは使用できません。 |
| ユーザーの非アクティブ化 | Slack ワークスペースから指定されたユーザーを非アクティブ化します。 注: このアクションには、Slack アカウントのユーザートークンが必要です。ボットユーザートークンがある場合、このアクションは使用できません。 |
|
| ユーザーを検索 | 指定されたユーザーまたはボットに関する情報を返します。情報としては、ユーザーまたはボットの名前、タイムゾーン、ワークスペース管理者権限、チームの所有権などがあります。 | |
| サブスクリプションを非アクティブ化 | Slack のユーザーサブスクリプションを非アクティブ化します。このアクションを使用するには、「Slack との統合」の「Slack Enterprise Grid アプリケーションの作成」および「Slack Enterprise 接続を作成」セクションで概説されている手順を実行します。 | |
| アクセスログストリームを検索 | 指定された最も古い日付以降のすべてのユーザーのアクセスログを取得します。このアクションを使用するには、「Slack との統合」の「Slack ワークスペースアプリケーションを作成」および「Slack ワークスペース接続を作成」セクションで概説されている手順を実行します。 | |
| ユーザーストリームを検索 | Slack エンタープライズグリッドのすべてのユーザーを取得します。このアクションを使用するには、「Slack との統合」の「Slack Enterprise Grid アプリケーションの作成」および「Slack Enterprise 接続を作成」セクションで概説されている手順を実行します。 |
- 「ユーザーを作成」および「ユーザーを非アクティブ化」のアクションには、管理者スコープが必要です。 ここで説明するスポークの設定手順には、ボットユーザートークンのみが必要です。ボットトークンスコープの使用中は、「ユーザーを作成」および「ユーザーを非アクティブ化」アクションを使用できません。これらのアクションを使用するには、Slack アカウントからユーザートークンを取得する必要があります。
- 管理者スコープは、Slack ワークスペース所有者のみが利用可能です。
スポークモジュール
| モジュール | 説明 |
|---|---|
| Slack モーダル構成 | モーダルを作成し、Slackモーダルに表示するフィールドを指定します。 |
| Slack ユーザーキャッシュ | ServiceNow インスタンスの更新または ServiceNow インスタンスからの応答を必要とするアクションを Slack チャネルで実行したユーザーに関する情報にアクセスします。 |
| Slack チャネルキャッシュ | ServiceNow インスタンスでの更新または ServiceNow インスタンスからの応答を必要とするアクションが実行されたチャネルに関する情報にアクセスします。 |
| 受信決定 | ServiceNow インスタンスでアクションを実行する必要がある Slack アプリケーションのイベントを指定します。 たとえば、承認者が関連するSlackチャネルでタスクを承認したときに、ServiceNowインスタンスのタスクの詳細を更新する受信決定を指定できます。5 つの受信決定のサンプルが参照用に用意されています。これらの決定をカスタマイズするか、要件に従って受信決定を作成します。 受信決定に記載されている条件が満たされると、関連するサブフローがトリガーされ、受信アクションを開始した Slack ユーザーの Slack ユーザーキャッシュモジュールにレコードが作成されます。 |
| モーダルの受信決定 | 必要な受信決定が満たされたときにトリガーする必要があるサブフローを指定します。 受信決定に記載されている条件が満たされると、関連するサブフローがトリガーされ、受信アクションを開始した Slack ユーザーの Slack ユーザーキャッシュモジュールにレコードが作成されます。 |
| Slack 送信選択肢 | Slack チャネルにリストとして表示する必要がある選択肢です。 |
| 受信 Slack メッセージ | Slack アプリケーションから ServiceNow インスタンスへの受信メッセージに関する情報にアクセスします。 |
| 送信構成 | Slack アプリケーションでアクションを実行する必要がある ServiceNow インスタンスのイベントを指定します。 たとえば、 ServiceNow インスタンスでタスクが作成されたときに、承認を求めるメッセージを Slack チャネルで送信するように送信構成を指定できます。3 つの送信構成のサンプルが参照用に用意されています。これらの構成をカスタマイズしたり、要件に応じて送信構成を作成したりします。 送信構成では、「アクション可能なメッセージを投稿」と「承認メッセージを投稿」アクションにテンプレートが提供されます。たとえば、送信構成では、関連するSlackチャネルで送信される承認メッセージに [承認] および [却下] ボタンを表示するように設定できます。 送信構成に記載されている構成が満たされると、適切なサブフローがトリガーされ、Slack アプリケーションでアクションが実行されます。 |
| Slack 構成 | Slack アプリと署名キーに関する情報を入力します。 |
| テーブル | フィールド |
|---|---|
| Slack チャネルキャッシュ [sn_slack_ah_v2_slack_channel_cache] |
|
| Slack 構成 [sn_slack_ah_v2_slack_configurations] |
|
| Slack 資格情報 [sn_slack_ah_v2_slack_credential] |
|
| Slack 送信選択肢 [sn_slack_ah_v2_slack_outbound_choices] |
|
| Slack ユーザーキャッシュ [sn_slack_ah_v2_slack_user_details] |
|
| Slack ワークスペーストークン [sn_slack_ah_v2_slack_workspace_tokens] |
|
| Slack モーダル構成 [sn_slack_ah_v2_slack_modal_configuration] |
|
接続および資格情報エイリアスの要件
統合ハブ は、エイリアスを使用して、接続および資格情報を管理します。エイリアスを使用することで、複数の環境を使用する場合に、複数の資格情報と接続情報プロファイルを構成する必要がなくなります。接続または資格情報が変更された場合、接続を使用するどのアクションも更新する必要はありません。詳細については、「資格情報と接続情報」を参照してください。
スポークの設定については、「 Slack スポークを設定。