Setting up BalkanID Slackbot

Requirements

To install the BalkanID Slackbot, the user has to be an admin in BalkanID and a Slack Workspace Admin.

To configure BalkanID Slackbot in your slack workspace

1. Log in to app.balkan.id and select the tenant which you will be linking slack workspace with and then click on the Slackbot installation url. At this time the Slackbot can handle one BalkanID tenant connection with one Slack workspace.

2. Navigate to the Configure > System Notifications page and under Notification Channels, click the Install BalkanID Slackbot button

   
3. From the top right corner, select the workspace you want to install the Slackbot in and click on “Allow” to approve the scopes required by the Slackbot.

   
4. The Slackbot is now installed in your workspace, and you'll be returned to the Configure > System Notifications page.

   

After it is installed in your Slack workspace, you can also find the Slackbot by clicking on “Add apps” and then search for “BalkanID”:

Authentication

The Slackbot delegates authenticating users to Slack itself. In order for Slackbot to make requests to the BalkanID backend systems on behalf of the slack user, there must be a corresponding user in your BalkanID tenant with the same email address as your slack user.

E.g. if your slack user Cameron Anderson has email address [email protected], they must have a corresponding BalkanID user with email address [email protected]in order to use the Slackbot.