Slack の認証

前提条件

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

• OAuth 2.0 認可コード: ユーザー スコープ、ボット スコープ、Slack の資格情報。
• 独自の OAuth 2.0 アプリ (クライアント ID、クライアント シークレット、ユーザー スコープ、ボット スコープ) を使用します。
• API Ke: API キーです。

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

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

手記： [Bring your own OAuth 2.0 app] を使用してコネクションを作成する場合、[ Button Clicked ] イベントを使用する際には、追加の手順がいくつかあります。 詳細については、「 Bring your own OAuth 2.0 app authentication で [ボタンのクリックを使用する] をご覧ください。

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

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

1. 左側のレールから [Integration Service] を選択します。
2. [コネクタ] のリストから [Slack] を選択します。 検索バーで検索して、表示されるコネクタの数を絞ることもできます。
3. [ Slack に接続 ] ボタンを選択します。

   [OAuth 2.0 認可コード]、[独自の OAuth 2.0 アプリ (BYOA) を使用する]、[API キー] の 3 つの認証の種類から選択できます。

   1. [Bring your own OAuth 2.0 app] メソッドを選択した場合は、必要な資格情報を入力し、[ 接続] を選択します。
   2. API キー メソッドを選択した場合は、API キーを入力して [ 接続] を選択します。
   3. 既定の OAuth 2.0 認可コード メソッドを選択した場合は、手順 4 に進みます。
4. ボット スコープおよび/またはユーザー スコープを要件またはユース ケースに従って確認または変更します。この手順は任意です。 既定のスコープを使用して接続を作成できます。

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

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

   

   
   
7. [Allow] を選択します。お使いの Slack アカウントへのアクセス権があることにより、UiPath は以下を実行できます。
   • あなたに関するコンテンツと情報を表示します。
   • チャンネルと会話に関するコンテンツと情報を表示します。
   • ワークスペースに関するコンテンツと情報を表示します。
   • 自分らしくアクションを実行します。
   • チャンネルと会話内でアクションを実行します。
   • ワークスペースでアクションを実行します。
8. コネクションが追加されました。

範囲と権限

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

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

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

スコープ/権限	ユースケース	アクティビティ
チャット:書き込み (ユーザー トークンとボット トークンの両方)	ボットまたはユーザーとしてチャンネルでメッセージを送信します。 ボットまたはユーザーとしてチャンネル内のメッセージに返信を送信します。 チャネルでボタンがクリックされたときに、一時的なメッセージまたは me メッセージをユーザーに送信します。	チャンネルにメッセージを送信 返信を送信
チャット:書き込み:カスタマイズ (ボット トークンのみ)	カスタマイズしたボット名とアイコンを使用して、チャンネルまたはユーザーにメッセージを送信します。	チャンネルにメッセージを送信 ユーザーにメッセージを送信
チャット:書き込み:公開 (ボット トークンのみ)	ボットがチャンネルメンバーではない場合でも、通知/お知らせをボットとしてパブリック チャンネルに送信します。	チャンネルにメッセージを送信
リンク:書き込み(ユーザートークンとボットトークンの両方)	ボットまたはユーザーとして、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 (ユーザー トークンとボット トークンの両方)	通知を送信するために、ボットまたはユーザーとしてユーザー情報 (名前やメールなど) を読み取ります。	メール アドレスからユーザーを取得