The set-up is relatively straightforward and should only take about 10 minutes to set-up.
Steps:
Make sure you’re using a Slack Workspace Owner or Admin Account within Slack.
Visit https://api.slack.com/apps and click the green “Create New App” button.
Then select the “From scratch” option.
For the app name, enter “SkyPrep (LMS)” or something similar — this is the name that the notifications will come from. Alternatively, you can name it something that doesn’t include the SkyPrep branding (like “Acme Company LMS”) or whatever name you’d like.
Under “Pick a workspace to develop your app in:” select the Slack workspace you’d like to have the app installed in.
Then click the green “Create App” button.
On the next screen, click on the “OAuth & Permissions” tab.
Scroll down to the “Scopes” section and click “Add an OAuth Scope” button. You’ll need to add the following scopes:
chat:write
im:write
users:read
users:read.email
Scroll back up, and under oAuth Tokens, click “Install to Acme” (or whatever you named your app) button in green. “Acme”, in this case, will be your Slack workspace name.
You’ll be presented with a consent page. Click the “Allow” button in green
On the next screen, the Bot User OAuth Token will be visible. Copy this token and paste it in the Slack settings page inside SkyPrep at https://yourdomain.skyprepapp.com/admin/integrations/slack.
The token will start with “xoxb-”
Then within the SkyPrep settings, Enable the Slack integration and paste the token above into the “Slack Bot Token” field. If you don't see the field, ensure that the integration is enabled.
Click “Update Settings” at the bottom.
Try clicking the “Send Test Message” in the top-right to send yourself a test message (if your current SkyPrep email matches your Slack username). You should receive a Slack message from a bot that’s named the same as the App you named above, and if you receive one, it means the integration is successfully set up.
You can now enable the specific notifications on the same page that you wish to enable. When these events occur, the corresponding user will be notified in Slack (if their email addresses match).
Optional:
If you’d like to configure the icon of the integration in Slack (or rename the App/integration), you can do this via the “Basic Information” section within the App settings in Slack.
Scroll to to “Display Information” section and customize the colors and icons of the integration.
If you’d like to uninstall the App, just visit https://app.slack.com/apps-manage, enter your Slack domain, and uninstall the app you created above.