Whenever you set up an integration with Slack, you will be prompted to permit certain access from the requesting app. Guru requires certain authorizations in order for the Guru app in Slack to work. Below, we have broken down what authorizations Guru requests and why.
❗️ Important
The most up-to-date list of authorizations can always be found on Guru's Slack app page in Slack's App Directory under the Permissions tab (which updates to the Configuration tab after the Guru app is installed in your team's Slack instance).
✍️ Note
Please keep in mind that Guru's Slack app is subject to the same security standards as the rest of our platform, so you can be assured that your data is safe. To learn more, review Guru’s security standards and Guru's Slack app Security & Compliance.
What will Guru be able to view?
View messages and other content in public channels, private channels, direct messages, and group direct messages that Guru has been added to | This permission, known as the history scope, allows Guru to unfurl links, respond to bot DM commands (ie. help, create Card, search commands), create Cards from messages and threads, add to existing Cards from messages and threads, and analyze messages for Guru's Trending Topics functionality. |
View basic information about public channels in your workspace | Guru needs to see which public channels you have access to in order to create Guru feeds. |
View files shared in channels and conversations that Guru has been added to | Guru needs to be able to read the contents of files posted to channels to be able to support the creation of Guru Cards from these files. |
View basic information about private channels that Guru has been added to | Allows users to create Cards or add to existing Cards out of messages and threads in private channels. |
View basic information about direct messages that Guru has been added to | This allows Guru to open a DM with new users where they can receive notifications and interact with the bot. |
View emoji reactions and their associated content in channels and conversations that Guru has been added to | This allows Guru to create Cards and initiate searches with the use of emojis (Reactjis). |
View people/email addresses of people on your workspace | Guru needs to list your users and read their email addresses in order to associate Slack users with Guru users. The Guru integration will attempt to do this upon installation so that your users can immediately start using the integration. |
View the Guru link contained in a Slack message | Guru needs to be able to read the Guru Card link within a Slack message in order to create a Card content preview. |
What Guru will be able to do?
View messages that directly mention @guru in conversations that the app is in. | This allows Guru to search via mentioning @guru from any channel. |
Send messages as @guru. | The Guru integration will need to send messages to your Slack users to send them notifications and interact with them as they use the integration to search knowledge, create knowledge, monitor feeds, etc. |
Manage private channels that Guru has been added to and create new ones. | Guru needs this permission to create Guru activity feeds in private channels. |
Start direct messages with people. | Guru needs to start a DM with installing users. Through this DM, users can ask for help, create Guru Cards, and take Admin actions. |
Add and edit emoji reaction. | Guru needs to add preset reactions to message requests that are sent to admins to invite their users to Guru. |
Add shortcuts and/or slash commands that people can use. | This is simply stating that the Guru integration for Slack will install a slash command and shortcuts to be used to query your Guru knowledge and input knowledge into Guru. |
📑 Related article