SLACK INSTALLATION

The DataBased app allows you to quickly share "Insights" in Slack, either in direct messages or channels. Let your people know when something catches your eye by sharing it where they already communicate and bring the conversation back to the data to see how people are improving and excelling.

See the instructional guide below for how to setup and use the feature to send messages to your team.

SlackWorkflow.gif

Installation

  • Login to DataBased

  • With a team diamond on the quadrant selected

  • Panel on the right will show "Insights".

  • Click → "Send Congratulations" or "Send Reminder" in any of the insights that have that option

  • Click → the "Slack" icon to use Slack to send messages from DataBased 

  • A Redirect will occur to the Slack Authentication page

  • Sign in and click "allow" permissions

  • Close the Slack redirect window

  • Slack send messages is now enabled from DataBased.
     

Usage

  • Login to DataBased

  • With a team diamond on the quadrant selected

  • Panel on the right will show "Insights".

  • Click → "Send Congratulations" or "Send Reminder" in any of the insights that have that option

  • Click → the "Slack" icon to use Slack to send messages from DataBased 

  • Slack Workspace will be visible with list of channels, and message text

  • Select “Share with…” to choose public channel, private channel, group message, or direct message

  • Edit message text

  • Click → “Send Slack message” to send screenshot of the insight and text to the destination.

    • Note: Message sent to public and private channel will @mention the users on the insight or name if they do not exist on slack.

  • The message with picture will be sent to Slack.

PERMISSIONS

Asset 3.png

Data security is extremely important to DataBased. We understand that Slack contains extremely sensitive information that is restricted to your organization. We have minimized our permissions to the list below so that our application can communicate with your Slack workspace and does not access any of the private information in your Slack workspace.

We only store the authentication token in our database so that we do not require re-authentication on every sent message. This token is only loaded from the database when the previously authenticated user is accessing our send message functionality on the site. The information gathered below is only passed through to our servers to the client browser and not stored.

 

User Permissions: 

"Send messages on a user’s behalf"

- Reason: Sends a message to the specified Slack channel with screenshot and @mentions for users from the insight. This only occurs when the user initiates the request from app.databased.com.

View basic information about a user’s private channels

- Reason: List of channel names and identifier to private channels and does not permit reading message contents.

View basic information about a user’s direct messages

- Reason: List of user name and identifier to direct messages and does not permit reading message contents.

View basic information about a user’s group direct messages

- Request Reason: List of group messages with identifier and does not permit reading message contents.

 

Bot Permissions:

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

- Reason: Provides workspace icon url and name for displaying on site to show connect workspace details.

 

View basic information about public channels in a workspace

- Reason: List of channel names and identifier to public channels and does not permit reading message contents.

View email addresses of people in a workspace

- Reason: The application uses the user email address to @mention DataBased user in Slack message in public and private channels.

View people in a workspace

- Reason: Reads list of users to help add user icons, names and identifier for destination for message.