Slack 

SlackAPI スコープまとめ

2024/12/08

※随時更新中です。(最終更新日:24/12/08)

SlackAPIの「スコープ」とは

WebAPIメソッドの呼び出しやEventAPIイベントの受信など、Slackで機能を実行する許可をアプリに与えるために使用される権限。

トークンタイプ一覧

トークン 接頭辞 概要
Botトークン xoxb- ユーザーIDに紐づかない独立したトークン。
必要なスコープのみを要求するため、カスタマイズ性の高い権限モデルを提供する。
Workflow
トークン
xwfp- Botトークンのサブセット。
発行後15分で失効するワンタイムトークン。
ユーザースコープを必要とするアクションを実行することはできない。
Userトークン xoxp- アプリをインストール、または認証したユーザーに発行される。
アプリケーションの場合、ユーザに代わってアクションを実行することが可能。
Configuration
トークン
- アプリを作成および構成するために AppManifestAPI で使用されるワークスペースごとのトークン。
App-level
トークン
xapp- アプリがインストールされている組織全体で固有のトークン。
アプリ全体に関連する特定のAPIでのみ使用可能。
Service
トークン
- 有効期限がなく、トークンをリフレッシュすることなくSlack CLIのあらゆるアクションを実行可能。
WorkflowAppsでのみ使用可。

スコープ一覧

スコープ名 概要 トークンタイプ
admin

ワークスペースの管理者権限

User
admin.analytics:read

組織に関する分析データへのアクセス権限

User
admin.app_activates:read

User
admin.apps:read

User
admin.apps:write

User
admin.barriers:read

User
admin.barriers:write

User
admin.conversions:read

User
admin.conversions:write

User
admin.invites:read

User
admin.invites:write

User
admin.roles:read

User
admin.roles:write

User
admin.teams:read

User
admin.teams:write

User
admin.usergroups:read

User
admin.usergroups:write

User
admin.users:read

User
admin.users:write

User
admin.workflows:read

User
admin.workflows:write

User
app_configurations:read

Bot User
Configurations
app_configurations:write

Bot User
app_mentions:read

Bot
apps.requests:write

User
assistant:write

Bot
auditlogs:read

User
authorizations:read

AppLevel
bookmarks:read

Bot User
bookmarks:write

Bot User
calls:read

Bot User
calls:write

Bot User
canvases:read

Bot User
canvases:write

Bot User
channels:history

Bot User
channels:join

Bot
channels:manage

Bot
channels:read

Bot User
channels:write

User
channels:write.invites

Bot User
channels:write.topic

Bot User
chat:write

承認されたチャンネルと会話にメッセージを投稿する

Bot User
chat:write.customize

Bot
chat:write.public

Bot
chat:write:bot

Slackアプリとしてメッセージを送る

User
chat:write:user

User
commands

Bot User
connections:write

AppLevel
conversations.connect:manage

Bot
conversations.connect:read

Bot
conversations.connect:write

Bot
conversations:write.invites

-

conversations:write.topic

-

datastore:read

Bot
datastore:write

Bot
dnd:read

Bot User
dnd:write

Bot User
email

User
emoji:read

Bot User
files:read

Bot User
files:write

Bot User
files:write:user

User
groups:history

Bot User
groups:read

Bot User
groups:write

Bot User
groups:write.invites

Bot User
groups:write.topic

Bot User
hosting:read

User
hosting:write

User
identify

-

im:history

Bot User
im:read

Bot User
im:write

Bot User
im:write.topic

Bot User
incoming-webhook

Bot User
links.embed:write

Bot User
links:read

Bot User
links:write

Bot User
metadata.messages:read

Bot
mpim:history

Bot User
mpim:read

Bot User
mpim:write

Bot User
mpim:write.invites

Bot User
mpim:write.topic

Bot User
none

Bot
openid

User
pins:read

Bot User
pins:write

Bot User
profile

User
reactions:read

Bot User
reactions:write

Bot User
reminders:read

Bot User
reminders:write

Bot User
remote_files:read

Bot User
remote_files:share

Bot User
remote_files:write

Bot>
search:read

User
search:read.im

Bot
search:read.mpim

Bot
search:read.private

Bot
search:read.public

Bot
stars:read

User
stars:write

User
team.billing:read

Bot User
team.preferences:read

Bot User
team:read

Bot User
tokens.basic

Bot User
triggers:read

Bot User
triggers:write

Bot User
usergroups:read

Bot User
usergroups:write

Bot User
users.profile:read

Bot User
users.profile:write

User
users:read

Bot User
users:read.email

Bot User
users:write

Bot User
aworkflow.steps:execute

Bot