Slack Security & Privacy
For the Clockwise Slack app to work, you will need both a Clockwise account, and a Slack account. You can sign up for a Clockwise account here to get started. To install the Clockwise Slack integration, please view this guide.
Explanation of permission requested and access required
Current Slack Scope Permissions
If you’re interested in learning more about Slack API scopes, feel free to check out their documentation. As we continue to add new features to our Slack integration, there may be times when we need to make adjustments to our Slack permissions. We’ll never ask for more permissions than we actually need in order to provide you with the best experience using Clockwise in Slack.
Slack Scope Permissions |
Functionality |
| app_mentions:read | Allows Clockwise to respond to @ mentions in conversations Clockwise has been added in |
| channels:read | Allows Clockwise to appropriately surface notifications from public channels |
| chat:write | Allows Clockwise to provide users with daily notifications and schedule digest as @Clockwise Required for chat:write.public permission scope |
| chat:write.public | Allows Clockwise to send schedule updates in public Slack channels where users have opted in to receive them |
| commands | Allows users to utilize shortcuts and slash commands |
| groups:read | Used exclusively to clarify scheduling requests when users explicitly invoke the Clockwise bot in private channels. For example, this permission helps Clockwise determine the list of attendees for a meeting or decide whether to respond within a specific thread. |
| im:history | Allows Clockwise to view history in the Direct Message (DM) between Clockwise and the user |
| im:read | Used exclusively to clarify scheduling requests when users explicitly invoke the Clockwise bot in direct messages (DMs). For example, this permission helps Clockwise determine the list of attendees for a meeting or decide whether to respond within a specific thread. |
| im:write | Allows users to initiate a direct message (DM) with the Clockwise bot |
| mpim:read | Used exclusively to clarify scheduling requests when users explicitly invoke the Clockwise bot in group direct messages (DMs). For example, this permission helps Clockwise determine the list of attendees for a meeting or decide whether to respond within a specific thread |
| mpim:write | Allows Clockwise to respond in group direct messages (DMs) when a user explicitly invokes Clockwise for a scheduling request |
| users:read | Allows Clockwise to view users in a workspace to support internal processes like user mapping |
What will Clockwise be able to view?
- Content and information about user
- Validation required to confirm the user has access to the Slack account attempting to be synced with Clockwise
- Basic information about public channels
- Allows access and correct functionality of Team availability Slack sync notification settings
- View messages and other content in direct messages that Clockwise has been added to
- Allow user to reply to a message in Clockwise bot direct message
- View Do Not Disturb for people in your workspace
- Enable Automatic do not disturb feature
- View people in your workspace
- Allows for inviting colleagues within Slack
- View messages that directly mention @clockwise
- Users can mention @clockwise to schedule with Prism
What will Clockwise be able to do?
- Edit your Do Not Disturb settings
- Edit profile information and status
- Allow for correct functionality of Automatic Do Not Disturb and Status Sync features
- Send messages as @clockwise
- Allows for notifications to be sent to users like Daily Forecast and Flexible meeting notifications
- Send messages to channels @ clockwise isn't a member of
- Allows for the Team availability Slack sync to update channels chosen by users
- Start direct messages with people
- Allow access for Clockwise bot to update users for Daily Forecast and Daily Flexible meeting notifications
- Add shortcuts / slash commands
- Allows users to access Clockwise settings with /cw settings command
Slack account says "Update Now"
As Clockwise adds new features to the Slack integration, we periodically need to request access to different permissions within Slack. Because we never ask for more than we need, and we can't add them without your approval, we will prompt you to update your Slack integration to approve adding these permissions.
For example, when we released the ability to automatically put Slack in Do Not Disturb mode, we needed to request access to "modify your workspace's Do Not Disturb settings".