Slack向けCustom OAuth profiles
Custom OAuth profilesとは何ですか
Custom OAuth profilesにより、Slackアプリは内部でWorkato Slackコネクターを活用できます。 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 | メールでユーザー情報を取得します。 |
詳細なスコープへの移行
Slackは2020年1月22日に詳細な権限をリリースしました。 Workatoに接続している既存のカスタムSlackアプリを移行する必要がある場合があります。 詳細については、移行ガイドを参照してください。
セットアップ要件
カスタムOAuthプロファイルを作成するには、WorkatoでCustom OAuth profilesにアクセスできる必要があります。
別のデータセンターを使用している場合は、そのデータセンターのカスタムプロファイルにログインします:
- EUデータセンターCustom OAuth profile
- JPデータセンターCustom OAuth profile
- SGデータセンターCustom OAuth profile
- AUデータセンターCustom OAuth profile
- ILデータセンターCustom OAuth profile
- KRデータセンターCustom OAuth profile
- 開発者サンドボックスCustom OAuth profile
ワークスペースにCustom OAuth profilesが表示されない場合
Custom OAuth Profileは追加機能です。 この機能がワークスペースで有効になっていることをWorkato CSMに確認してください。
カスタムOAuthプロファイルの作成
Step 1: Slackを選択
開始する前に、ブラウザから[Slackワークスペースにサインイン[(https://slack.com/signin#/signin)します。
Workatoでツール > Custom OAuth profilesに移動します。
新規カスタムプロファイルをクリックします。
新規カスタムプロファイルページで、次の操作を行います。
- Step 1でSlackを選択します。
- ステップ2で新しいアプリの名前を入力し、新規アプリを作成をクリックします。新しいタブが開き、https://api.slack.com/apps に移動します。 Workatoタブとこの新しいタブの両方を開いたままにします。残りの手順を完了するには両方が必要です。
Step 2: 新しいSlackアプリの作成
新しいタブで、アプリを開発するワークプレースを選択し、次へをクリックします。
Createをクリックします。
"Welcome to your app's configurations"ポップアップで、了解をクリックします。
アプリの基本情報ページに移動します。 アプリの認証情報まで下にスクロールします。次のステップを完了するには、ここにある情報が必要です。
Step 3: Slackアプリと通信するようにWorkatoを設定
Workatoタブに戻り、Step 3を完了します。
Step 3で、以下を入力します:
- Client ID: SlackのClient ID値をこのフィールドに貼り付けます。
- Client secret: SlackのClient secret値をこのフィールドに貼り付けます。
- Verification token: SlackのVerification Token値をこのフィールドに貼り付けます。
完了したらSaveをクリックします。
Step 4: Workatoでコネクションを完了
あと少しです。 残っているのは、Workatoでコネクションを完了することだけです。
開いているWorkatoタブで、完了をクリックします。 任意のプロジェクトフォルダに移動して、新しいSlackコネクションを作成します。
Slackコネクションの名前を指定します。 Custom OAuth profileフィールドで、新しく作成したOAuthプロファイルを選択します。 接続をクリックします。
権限の付与画面で、許可をクリックします。
Last updated: