Slack

Open-source and On-premise editions of Ylem require separate specific configurations for this integration. See below

Integration type: Write

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

Data for the connection:

Please note that you need admin permissions for your Slack organization to authorize Ylem to send messages to it.

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".

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.

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.

Add the following as Bot Token Scopes:

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:

https://%%YOUR_DOMAIN_NAME%%/slack/authorize

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.

Step 2. Configure Ylem .env parameters

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

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".