OAuth Scope

BOT TOKEN SCOPES

Scopes that govern what your app can access.

OAuth Scope Description

app_mentions:read

View messages that directly mention @attendancebot in conversations that the app is in

Request Reason: To identify when someone is mentioning AttendanceBot and give response accordingly.

channels:read

View basic information about public channels in a workspace

Request Reason: To read purpose of the channel created.

chat:write

Send messages as @attendancebot

Request Reason: To send replies to people who writes to AttendanceBot.

files:read

View files shared in channels and conversations that AttendanceBot has been added to

Request Reason: To read the file attached by the user while applying for leave like medical certificate etc.

files:write

Upload, edit, and delete files as AttendanceBot

Request Reason: To upload all the relevant reporting files.

groups:read

View basic information about private channels that AttendanceBot has been added to

Request Reason: To read the purpose of the group created.

im:history

View messages and other content in direct messages that AttendanceBot has been added to

Request Reason: To read DM history as and when required for responding to the user.

im:read

View basic information about direct messages that AttendanceBot has been added to

Request Reason: To read the message sent by the user.

im:write

Start direct messages with people

Request Reason: For sending messages to the user.

team:read

View the name, email domain, and icon for workspaces AttendanceBot is connected to

Request Reason: To uniquely identify a team and respond based on that.

users:read

View people in a workspace

Request Reason: To uniquely identify a user and response based on that.

users:read.email

View email addresses of people in a workspace

Request Reason: For dashboards outside Slack and to let some users subscribe to reports.

workflow.steps:execute

Add steps that people can use in Workflow Builder

Request Reason: To identify when a workflow has been executed.

Scopes that access user data and act on behalf of users that authorize them.

OAuth Scope Description

identity.basic

View information about a user’s identity

Request Reason: To uniquely identify a user and take action accordingly.

identity.email

View a user’s email address

Request Reason: To uniquely identify email of a user and take action accordingly.

users.profile:read

View profile details about people in a workspace

Request Reason: To read the slack status of the user.

users.profile:write

Edit a user’s profile information and status

Request Reason: To update the slack status of the user when they punch in/out in AttendanceBot.