# Slack

{% hint style="info" %}
Open-source and On-premise editions of Ylem require separate specific configurations for this integration. See [below](#configuring-integration-for-open-source-and-on-premise-versions)
{% endhint %}

**Integration type**: `Write`

Integration with Slack allows you to send messages to various channels including private ones.

**Data for the connection:**

<figure><img src="https://3180830455-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD0FT8l3QzMrw546vOdHU%2Fuploads%2Fj5TCevVqnAAXrSl0YKgm%2FScreenshot%202024-04-23%20at%2016.58.30.png?alt=media&#x26;token=af8e8258-7910-46a2-9e00-dcefd7d64a02" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Please note that you need admin permissions for your Slack organization to authorize Ylem to send messages to it.
{% endhint %}

## Authorizing Ylem in private Slack channels

To publish messages in private groups on Slack, you need to add Ylem (app) into the group first.

To do it, type @Ylem in the group and click on "**Invite Them**".

<figure><img src="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD0FT8l3QzMrw546vOdHU%2Fuploads%2Fk8SJ3ORqG41g49iHpPj3%2FScreenshot%202023-01-15%20at%2014.00.20.png?alt=media&#x26;token=f4728aad-b83a-47b4-b1c9-9a80a004d3c5" alt=""><figcaption></figcaption></figure>

## Configuring integration for open-source and on-premise versions

If you don't use the cloud version of Ylem but have it installed on your infrastructure under your domain name, you need to create your own Slack OAuth 2.0 application to make this integration work.

### Step 1. Create Slack Application

As the first step, you need to go to the <https://api.slack.com/apps> and create your own "OAuth 2.0" application.

{% hint style="info" %}
You don't need to distribute your application publically on Slack Marketplace because it belongs to the same workspace you are planning to use it for.
{% endhint %}

Add the following as **Bot Token Scopes**:

<figure><img src="https://3180830455-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD0FT8l3QzMrw546vOdHU%2Fuploads%2FO6hhHmcfMkzkl4mypymd%2FScreenshot%202024-09-23%20at%2023.27.16.png?alt=media&#x26;token=07cefae2-8efe-4a4c-943f-be7a13828a96" alt=""><figcaption></figcaption></figure>

Slack App also needs a redirect URL to return users to after a successful authorization. Use this one and just replace the domain name with your one that internally proxies the request to `ylem_integrations:7337`:

```bash
https://%%YOUR_DOMAIN_NAME%%/slack/authorize
```

<figure><img src="https://3180830455-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FD0FT8l3QzMrw546vOdHU%2Fuploads%2FR95cxR4mCH3hlNYZKMOZ%2FScreenshot%202024-09-23%20at%2023.34.13.png?alt=media&#x26;token=0a3085d6-b3b5-446b-8ec4-033f15127a1b" alt=""><figcaption></figcaption></figure>

As soon as the application is ready, you can open its "Settings" and copy your CLIENT\_ID and CLIENT\_SECRET. These two values you will need to add to your Ylem configuration now.

Additional information about creating and configuring Slack Apps can be found in their [official documentation](https://api.slack.com/quickstart#creating).

#### Step 2. Configure Ylem .env parameters

The following parameters need to be changed on the `backend/integrations/.env` file:

```bash
INTEGRATIONS_SLACK_OAUTH_CLIENT_ID=%%REPLACE_IT_WITH_THE_CLIENT_ID_OF_YOUR_APP%%
INTEGRATIONS_SLACK_OAUTH_CLIENT_SECRET=%%REPLACE_IT_WITH_THE_CLIENT_SECRET_OF_YOUR_APP%%
INTEGRATIONS_SLACK_AFTER_AUTHORIZATION_REDIRECT_URL=https://%%REPLACE_IT_WITH_THE_DOMAIN_NAME_OF_YOUR_YLEM_INSTANCE%%/jira-authorizations/{uuid}/?justConnected
```

Now you can open **https\://%%YOUR\_YLEM\_DOMAIN\_NAME%%/slack-authorizations** and try to authorize Slack Integration by clicking on the button "**Add Slack authorization**".