Note: The following article shows the Betterworks NextGen interface. If the steps and/or screenshots do not match what you see in your organization's Betterworks instance, try this article, which shows the same feature in the Betterworks Classic interface.
Contents
Overview
The Betterworks Slack integration (the Betterworks Slackbot) connects Betterworks to your Slack workspace so users can interact with Betterworks from Slack.
With the Betterworks bot for Slack, you can:
- Give and request feedback to/from coworkers
- Receive a weekly summary of your activities
- View and update your goals, and add comments to others' goals and milestones
- Receive notifications about cheers, nudges, and @ mentions for your goals and milestones
- Give and receive recognition to/from coworkers
Requirements
- You must be a Betterworks Super Admin and the Slack workspace administrator (or have permission to install apps) to enable the Betterworks Slackbot.
- Confirm all users are added to the Slack workspace, have accepted invitations and completed their profiles, and that email addresses match between Slack and Betterworks.
- This integration is intended for Slack's Pro and Business+ plans. The Slack Enterprise plan is not fully supported.
- Only one Slack workspace per organization is supported.
Configuration
- Go to Admin → Platform Configuration → Third-party integrations → Slack
- Click the toggle to Enable the integration
- Authorize Betterworks to access your Slack workspace.
- Once authenticated, the button in the Betterworks Admin module will change to Re-install and can be used whenever you have new users who have joined the Slack workspace or to upgrade the bot version.
-
(Optional) You can designate a Slack channel specifically for recognition by enabling the Share recognition submitted to a Slack channel.
Note: Do not include the hashtag (#) in your channel name.
- Go to your Slack channel → View all members → Integrations → Apps → Add an app → and select the Betterworks Slackbot.
Note: When the Slackbot is enabled, it is enabled org-wide. User notifications are on by default after installation, and new Betterworks users will have the Betterworks Slackbot installed automatically.
Considerations
- The bot must be installed via the Betterworks Admin module, not the Slack Apps directory (installing from the Apps directory will not function).
- If you enabled recognition sharing, the Betterworks Slackbot must be invited to the designated channel. Otherwise, recognition will not post.
- Slackbot commands are fixed. Administrators cannot rename or disable individual commands.
Troubleshooting
Symptom |
Cause |
Fix |
|---|---|---|
| Notifications/recognition not posting to the channel | Slackbot not invited to the channel | Invite the Betterworks Slackbot to the designated channel |
| Bot not working after install | Installed via Slack Apps directory instead of Betterworks | Remove and re-install from Admin → Platform Configuration → Third-party integrations → Slack |
| Some users not receiving messages | Email mismatch between Slack and Betterworks | Align user email addresses across both systems |
| Integration unreliable on Enterprise plan | Slack Enterprise is not fully supported | Use a Pro or Business+ workspace |
FAQs
I'm a Betterworks Super Admin but not the Slack workspace administrator, what should I do?
Follow your organization's Slack policy at the workspace level. This may mean getting approval from, or coordinating installation with, your Slack workspace administrator.
Can I enable the Slack integration for only a select group of users?
No. When enabled, the Betterworks bot applies org-wide and installs automatically for new users.