# 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](https://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](https://app.balkan.id/configure/notifications) page and under `Notification Channels`, click the `Install BalkanID Slackbot` button

   <figure><img src="/files/jdDlpCenWF46jXjB33vg" alt=""><figcaption></figcaption></figure>
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.<br>

   <figure><img src="/files/snr6OChINHD8S6STrzhJ" alt=""><figcaption></figcaption></figure>
4. The Slackbot is now installed in your workspace, and you'll be returned to the Configure > System Notifications page.<br>

   <figure><img src="/files/SV99zJYm5p5SW5vxxJ2W" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/1vsdOhBirLAQRv43Sqj1" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/3guwjwZfvm1rXEiO9I2b" alt=""><figcaption></figcaption></figure>

## 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 `canderson@testuser.com`, they must have a corresponding BalkanID user with email address `canderson@testuser.com`in order to use the Slackbot.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.balkan.id/getting-started/balkanid-slackbot/setting-up-balkanid-slackbot.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.