Slack App configuration for Unimus

In Unimus 2.0.0 we migrated our Slack integration to a full-featured Slack App. This was necessary since we added full Config Change notifications over Slack in 2.0.0.

Here is an example of a Slack Config Change notification:

This article shows how to configure a Slack App for usage with Unimus.

1) Open https://api.slack.com/apps and click "Create App" to start:

2) Slack will ask you if you want to create an app from scratch, or from a manifest. Select "From a manifest", then select the workspace where the app will be installed:

3) Next you will need to paste this manifest into the app creation:

{
    "display_information": {
        "name": "Your-Unimus-bot-name-here"
    },
    "features": {
        "bot_user": {
            "display_name": "Your-Unimus-bot-name-here",
            "always_online": false
        }
    },
    "oauth_config": {
        "scopes": {
            "bot": [
                "users:read",
                "channels:read",
                "groups:read",
                "im:read",
                "mpim:read",
                "im:write",
                "mpim:write",
                "files:write",
                "chat:write"
            ]
        }
    },
    "settings": {
        "org_deploy_enabled": false,
        "socket_mode_enabled": false,
        "token_rotation_enabled": false
    }
}

Make sure to replace the name and display_name for something more relevant to you.

4) Click "Create":

5) At the bottom of the "Basic Information" section, you can Change the name and add a logo that your Slack Bot will use in your Workspace:

6) Go to "OAuth & Permissions" in the left menu, and install the bot to your Workspace:

7) You will get an "Bot User OAuth Access Token", copy the token:

8) In your Slack Workspace, invite the Unimus Bot user to the channel it will post to:

9) Now navigate to the "Notifications > Slack settings" in your Unimus server:

10) Paste in your "Bot User OAuth Access Token" and your channel. You can use "#channel" to post in a channel, or "@user" to DM messages to a person:

Don't forget to "Save" your settings after pasting them in. You can use the "Run test" feature to check if your notifications are working.

If the test works, the Unimus Slack Sender is fully configured. You will now receive Config Change Notifications into Slack as soon as Unimus detects a config change in your network.