Slack向けCustom OAuth profiles

このページは機械翻訳により提供されています。翻訳内容と英語版に相違がある場合は、英語版が優先されます。

Custom OAuth profilesとは何ですか

SlackアプリがバックグラウンドでWorkato Slackコネクターを活用できるように、Custom OAuth profilesを使用します。 Slackアプリのアイデンティティは、次の項目を含めて完全にカスタマイズできます。

  • ブランディング(ボット名、ボットロゴ、背景色)
  • 権限

Slack向けCustom OAuth profilesが必要になる場合

  • 複数のアプリが必要であり、各アプリが自動化の一部としてワークスペースオーケストレーションを実行する場合。 たとえば、EscalationBotはプライベート会話を作成し、危機管理チームメンバーを招待し、問題が解決した後に会話をアーカイブできます。 BirthdayBotは同じアクションを実行できますが、目的は大きく異なります。プライベート会話を作成し、パーティープランナーを招待し、誕生日が終わった後に会話をアーカイブします。

  • アプリのブランディングと外観を制御したい場合。

  • ボットの権限を制御したい場合。 最適に使用するための最小権限は次のとおりです。

トークンタイプスコープ理由
ボットなしボットスコープは不要です。
ユーザーchannels:readパブリック会話のリストを取得します。
ユーザーchannels:writeパブリック会話を作成または更新します。
ユーザーgroups:readプライベート会話のリストを取得します。
ユーザーgroups:writeプライベート会話を作成または更新します。
ユーザーim:readダイレクトメッセージ会話のリストを取得します。
ユーザーim:writeダイレクトメッセージ会話を作成または更新します。
ユーザーmpim:write複数人グループ会話を作成または更新します。
ユーザーmpim:readマルチパーティグループ会話のリストを取得します。
ユーザーchat:writeユーザーとしてメッセージを投稿します。
ユーザーusers:readユーザー情報を取得します。
ユーザーusers:read.emailメールでユーザー情報を取得します。

カスタムOAuthプロファイルの作成

WorkatoでCustom OAuth profileを作成するには、次の手順を実行します。

1

ツール > Custom OAuth profilesをクリックします。

2

+ 新規カスタムプロファイルをクリックします。

3

Applicationドロップダウンメニューを使用してSlackを選択します。

4

Nameフィールドにアプリの一意の名前を入力します。

5

Create new appをクリックします。 これにより、Slack APIページが新しいウィンドウで開きます。 次の手順を完了するには両方が必要なため、WorkatoとSlackを開いたままにします。

6

Slackで、ワークスペースにサインインし(求められた場合)、Create New Appを選択します。

7

アプリのスコープと設定を構成する方法を選択します。 構成する方法は2つあります。

8

SlackでBasic Informationページが開きます。 WorkatoのApp Credentialsセクションに追加するため、次の情報をコピーします。

  • Client ID
  • Client Secret
  • Signing Secret
9

Workatoに次の情報を追加します。

  • Client ID
  • Client secret
  • Signing Secret
10

保存をクリックします。

11

任意です。 Workatoの画面上の指示に従って、SlackアプリのリダイレクトURL、インタラクティビティ設定、ユーザートークンスコープを手動で構成します。 ワークスペースにアプリをインストールする前に、少なくとも1つの権限スコープを定義する必要があります。 Event subscriptionsを使用するには、Slackアプリに権限スコープが必要です。 イベントをサブスクライブすると、Slackは必要な権限スコープを自動的に追加します。

イベントサブスクリプションの有効化

New eventトリガーがイベントを取得できるように、WorkatoはRequest URLを生成し、アプリがこれらのイベントの送信先を認識できるようにします。 このRequest URLは、トリガーにEvent nameを入力した後に生成されます。 アプリがレシピのリクエストURLにイベントを送信すると、レシピが引き継ぎ、レシピアクションを実行します。 詳細については、New eventトリガー(リアルタイム)を参照してください。

SlackでEvent Subscriptionsを有効にするには、次の手順を実行します。

1

ナビゲーションバーからEvent Subscriptionsをクリックします。

2

Enable EventsトグルをクリックしてOnにします。

3

New eventトリガーのURLをRequest URLフィールドに貼り付けます。

4

保存をクリックします。

ワークスペースイベントのサブスクライブ

Slackには、サブスクライブできるワークスペースイベントの完全なリストが用意されています。 イベントをサブスクライブすると、アプリにまだないスコープが自動的に追加されます。 これにより、アプリに意図しない権限が付与される可能性があります。 アプリの権限スコープを確認するには、OAuth & Permissions > Scopesに移動します。

アプリのインストール

少なくとも1つのワークスペースイベントをサブスクライブすると、権限スコープが自動的に追加されます。 これにより、Slackアプリをワークスペースにインストールできるようになります。

Slackアプリをインストールするには、次の手順を実行します。

1

ナビゲーションバーからInstall App > Install to Workspaceをクリックします。

2

アプリの権限を確認し、Allowをクリックします。

WorkatoのCustom OAuth profileで構成を完了するには、Doneをクリックします。 これで、Workatoの他のSlackコネクションでこのCustom OAuth profileを使用できます。

Custom OAuth profileの使用

Custom OAuth profileを作成した後は、Workatoワークスペース内の誰でも、新しいSlackアプリを作成および構成することなく、自分のSlackコネクションで使用できます。

CUSTOM OAUTH PROFILEの制限

Custom OAuth profilesは、単一のSlackワークスペースにのみ接続できます。

データセンター固有のCustom OAuth profilesの詳細については、Token request endpointを参照してください。

Last updated: