Slack の認証

前提条件

選択した認証の種類に応じて、次のいずれかの資格情報が必要です。

• OAuth 2.0 認可コード: ユーザー スコープ、ボット スコープ、Slack の資格情報。
• 独自の OAuth 2.0 アプリ (クライアント ID、クライアント シークレット、ユーザー スコープ、ボット スコープ) を使用します。
• API キー: アクセス トークン (ボット トークン、ユーザー トークンなど)詳しくは、Slack の ドキュメントをご覧ください。

プライベート OAuth2 アプリを作成するには、Slack のドキュメントに記載されている手順に従います。

注:

Slack で OAuth アプリケーションを登録する際は、 コールバック URL をコネクション作成ページに表示されている値に設定してください (例: Automation Cloud の https://cloud.uipath.com/provisioning_/callback )。

コネクションを作成するには、Slack ワークスペースのメンバーまたはゲストである必要があります。

注:

[独自の OAuth 2.0 アプリ (BYOA) を使用する] を使用してコネクションを作成した場合、[ ボタンのクリック時 ] イベントを使用する際に、いくつかの追加手順を実行する必要があります。詳しくは、「 [ボタン クリック時] を使用する [独自の OAuth 2.0 アプリ 認証] を使用する 」をご覧ください。

Slack のコネクションを追加する

お使いの Slack インスタンスへのコネクションを作成するには、次の手順に従います。

1. 左側のレールから [Integration Service] を選択します。

2. [コネクタ] のリストから [Slack] を選択します。 検索バーで検索して、表示されるコネクタの数を絞ることもできます。

3. [ Slack に接続 ] ボタンを選択します。

4. 使用する認証方法に必要な資格情報を入力します。[OAuth 2.0 認可コード]、[独自の OAuth 2.0 アプリ (BYOA) を使用する]、[API キー] の 3 つの認証の種類から選択できます。

   1. [Bring your own OAuth 2.0] メソッドを選択した場合は、必要な資格情報を入力して [ 接続] を選択します。

      どのような種類のシークレット フィールドでも、値を直接入力する代わりに、フィールドの横にあるメニューを選択して [ 資格情報アセット を使用] を選択し、外部コンテナーにリンクされている Orchestrator 資格情報アセットを参照できます。詳細については、「 コネクションに資格情報アセットを使用する」をご覧ください。

   2. [API key] メソッドを選択した場合は、API キーを入力して [ 接続] を選択します。

      どのような種類のシークレット フィールドでも、値を直接入力する代わりに、フィールドの横にあるメニューを選択して [ 資格情報アセット を使用] を選択し、外部コンテナーにリンクされている Orchestrator 資格情報アセットを参照できます。詳細については、「 コネクションに資格情報アセットを使用する」をご覧ください。

   3. 既定の OAuth 2.0 認可コード メソッドを選択した場合は、手順 4 に進みます。

5. 要件またはユースケースに応じて 、ボットスコープ および/または ユーザースコープ を確認または変更します。chat:writeボットスコープは必須であり、削除することはできません—削除すると接続の作成が失敗します。その他のスコープはすべて任意です。

6. [接続] を選択します。

7. 画面の右上隅から適切なワークスペースを選択します。 接続は、この選択したワークスペースとそれぞれのチャネルに対してのみアクションを実行します。

   

8. [Allow] を選択します。お使いの Slack アカウントへのアクセス権があることにより、UiPath は以下を実行できます。

   • あなたに関するコンテンツと情報を表示します。
   • チャンネルと会話に関するコンテンツと情報を表示します。
   • ワークスペースに関するコンテンツと情報を表示します。
   • 自分らしくアクションを実行します。
   • チャンネルと会話内でアクションを実行します。
   • ワークスペースでアクションを実行します。

9. コネクションが追加されました。

範囲と権限

コネクションを使用して、UiPath Studio で Slack アクティビティ を有効化することで、ユーザーとチャンネルの管理、メッセージの予約投稿など協働のために必要な作業のオートメーションを作成できます。

必須のボットスコープ

以下のボットスコープは、認証方法に関係なく、すべてのSlack接続に必須です。このパラメーターを削除すると、接続の作成を完了できません。

スコープ	目的
chat:write	作成後に Slack ワークスペースに接続確認メッセージを投稿するために必要

注:

ボットスコープから chat:write を削除すると、接続の作成が失敗します。

すべてのスコープ

以下の表では、Slack アクティビティを使用して実現できるさまざまな権限ベースのユース ケースを確認できます。

表 1.各アクティビティに必要な Slack の権限

スコープ/権限	ユースケース	アクティビティ
チャット:書き込み (ユーザー トークンとボット トークンの両方)	ボットまたはユーザーとしてチャネルにメッセージを送信します。チャネル内のメッセージにボットまたはユーザーとして返信を送信します。チャネルでボタンがクリックされたら、エフェメラル メッセージまたは自分メッセージをユーザーに送信します。	チャンネルにメッセージを送信 返信を送信
チャット:書き込み:カスタマイズ (ボット トークンのみ)	カスタマイズしたボット名とアイコンを使用して、チャンネルまたはユーザーにメッセージを送信します。	チャンネルにメッセージを送信 ユーザーにメッセージを送信
チャット:書き込み:公開 (ボット トークンのみ)	ボットがチャンネルメンバーではない場合でも、通知/お知らせをボットとしてパブリック チャンネルに送信します。	チャンネルにメッセージを送信
リンク:書き込み(ユーザートークンとボットトークンの両方)	ボットまたはユーザーとして、Jira チケットや GitHub の Issue などのリンクのプレビューとともにメッセージを送信します。	チャンネルにメッセージを送信 ユーザーにメッセージを送信
チャンネル:書き込み[ちゃんねる:かい] (ユーザトークンのみ)	ユーザーとしてのニーズ/トピック/目標に基づいて、さまざまなチームやユーザー向けのパブリック チャンネルを作成します。サポート チケットが閉じられたり再オープンされたりしたときに、一時チャネル/会話をユーザーとして動的にアーカイブ、アーカイブ解除、または閉じます。	チャンネルをアーカイブ チャンネルのトピックを設定
チャンネル:管理(ボットトークンのみ)	ボットとしてのニーズ/トピック/目標に基づいて、さまざまなチームやユーザー向けのパブリックチャネルを作成します。サポート チケットが閉じられたり再オープンされたりしたときに、一時チャネル/会話をユーザーとして動的にアーカイブ、アーカイブ解除、または閉じます。	チャンネル アーカイブを作成 チャンネル チャンネルのトピックを設定
チャンネル:参加[ちゃんねる:じゅんと] (ボットトークンのみ)	まずチャンネルに参加して、メディア ファイルを Slack メッセージとしてボットとしてチャンネルにアップロードします。	チャンネルに参加
グループ:書き込み(ユーザートークンとボットトークンの両方)	ボットまたはユーザーとして、ニーズ/トピック/目標に基づいて、さまざまなチームやユーザー向けのプライベート チャンネルを作成します。	チャンネルを作成
im:write (ユーザー トークンとボット トークンの両方)	ボットまたはユーザーとして個別のメッセージ (IM) を送信します。	ユーザーにメッセージを送信
mpim:書き込み (ユーザー トークンとボット トークンの両方)	MPIM グループにボットまたはユーザーとしてメッセージを送信します。MPIM グループ内のメッセージにボットまたはユーザーとして返信を送信します。ボットまたはユーザーとしてメッセージを送信するために複数のユーザーを追加して、MPIM 会話を開きます。	チャンネルにメッセージを送信 返信を送信
チャンネル:読み取り (ユーザー トークンとボット トークンの両方)	メッセージを送信したり、ボットまたはユーザーとしてユーザーを管理したりするには、接続されたワークスペースのパブリック チャネルのリストを取得します。メッセージを送信したりユーザーを管理したりするために、ボットまたはユーザーとしてパブリック チャネル情報を読み取ります。	チャンネルにメッセージを送信 ユーザーにメッセージを送信 チャンネルにファイルを送信 返信 チャンネルにユーザーを招待 チャンネルからユーザーを削除 すべてのチャンネルのリストを取得 チャンネル情報を取得 すべてのチャンネル メンバーのリストを取得
グループ:読み取り (ユーザー トークンとボット トークンの両方)	メッセージを送信したり、ボットまたはユーザーとしてユーザーを管理したりするには、接続されたワークスペースのプライベート チャネルのリストを取得します。メッセージを送信したりユーザーを管理したりするために、ボットまたはユーザーとしてプライベート チャネル情報を読み取ります。	チャンネルにメッセージを送信 ユーザーにメッセージを送信 チャンネルにファイルを送信 返信 チャンネルにユーザーを招待 チャンネルからユーザーを削除 すべてのチャンネルのリストを取得 チャンネル情報を取得 すべてのチャンネル メンバーのリストを取得
im:read (ユーザー トークンとボット トークンの両方)	ボットまたはユーザーとしてメッセージを送信するために、接続されたワークスペースの IM 会話のリストを取得します。ユーザーが参加している IM 会話の一覧を取得します。	すべてのチャンネルのリストを取得 チャンネル情報を取得
mpim:読み取り (ユーザー トークンとボット トークンの両方)	ボットまたはユーザーとしてメッセージを送信するために、接続されたワークスペースの MPIM グループのリストを取得します。ユーザーが参加している MPIM 会話のリストを取得します。	すべてのチャンネルのリストを取得 チャンネル情報を取得
ファイル:読み取り(ボットトークンのみ)	ボットまたはユーザーとして、Slack メッセージを介して URL からパブリック URL や四半期の業績などの重要なファイルをダウンロードするなどのファイル情報を取得します。	ファイルの情報を取得
ファイル:書き込み(ユーザートークンとボットトークンの両方)	重要な更新について、ユーザー グループのすべてのユーザーに通知します。たとえば、ボットまたはユーザーとして、四半期ごとの売上結果を営業/マーケティングチームグループ全体に通知します。ボットまたはユーザーとして、メディア ファイルを Slack メッセージとしてチャンネルにアップロードします。	チャンネルにファイルを送信
ユーザグループ:読み取り(ユーザトークンのみ)	ボットまたはユーザーとしてユーザーを更新または追加するために、ユーザー グループ内のユーザーのリストを取得します。	すべてのユーザー グループのリストを取得
ユーザグループ:書き込み(ユーザトークンのみ)	ボットまたはユーザーとして、複数のチャネルのユーザー グループを作成します。新しいユーザーがチャネルに追加されるたびに、ボットまたはユーザーとして既存のユーザー グループにユーザーを追加します。一時チャネルがアーカイブ/アーカイブ解除されるたびに、一時チャネルのユーザー グループを動的に有効または無効にします。	ユーザー グループを作成 ユーザーをユーザー グループに追加
ユーザー:読み取り (ユーザー トークンとボット トークンの両方)	メッセージを送信するために、接続されたワークスペースのユーザーのリストをボットまたはユーザーとして取得します。	すべてのユーザーのリストを取得 チャンネルにユーザーを招待 チャンネルからユーザーを削除 ユーザーにメッセージを送信
users:read.email (ユーザー トークンとボット トークンの両方)	通知を送信するために、ボットまたはユーザーとしてユーザー情報 (名前やメールなど) を読み取ります。	メール アドレスでユーザーを取得
reactions:read (ボットトークンのみ)	アプリがアクセスできるチャネル内のメッセージのリアクション イベントをリッスンします。[Bring your own OAuth 2.0 app] の認証で [Reaction added] トリガーを使用する場合は必須です。	リアクションの追加