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
  • 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
  • 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?

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".