Create a Slack Application
To create a Slack application for your workspace go to the following URL:
https://api.slack.com/apps. You should see a green
Create App button, but you may need to sign in to your workspace in order to see it.
Click on the Create App button and give the app a name and select the proper workspace as follows:
After naming your application and setting the workspace click on the Create App button. You should see a page similar to this:
First thing to do is set up the endpoint URLs that the app will use to communicate with Codebeamer, so select he Interactivity & Shortcuts option from the left side menu.
Here you need to enter two URLs, the first URL should be YOUR_URL/rest/chatops/interactive-message and the second should be YOUR URL/rest/chatops/slack/external-options-load.
where YOUR_URL is your Codebeamer's public URL with the context path. This URL should be reachable by Slack across the Internet.
The following feature will be the Slash Commands so select this menu option from the left side menu.
Click on the Create new Command button and fill in the fields as it is on the next screenshot. The most important part is the Request URL which should be YOUR_URL/rest/chatops/command.
Where YOUR_URL is the same as mentioned above.
After the command creation you should see something similar to this:
After saving the command will be visible on the Slash Commands page :
The next step is to set up the app permissions so select the OAuth & Permissions option from the left side menu.
Here you need to set two things. The first is to add a Redirect URL:
The URL should be YOUR_URL/connectSlackAccount.spr where YOUR_URL is the same as before.
Make sure you click on the Save URLs button too.
The second setting is the bot user's permissions. It can be set on the same page just scroll down a little:
The necessary permissions are the chat:write, team:read and the users:read permissions.
Click on the Save Changes button after the permission addition.
You are almost finished the configuration, the last step is to install the app to your workspace. Click on the Install App to workspace button at the top of the OAuth & Permissions page.
You should see a similar summary of the app's features and permissions like this:
Click on the Authorize button and you should see your Slack user's oAuth token and what is more important, the bot's oAuth token too.
You will need this bot oAuth token for further configuration so note it down.
There are also some information what should be noted at the Basic Information page selected from the left side menu.
At the App Credentials section you will need the Client ID, Client Secret and the Verification token.
The Slack app creation has been finished, the next step is to introduce this Slack app to Codebeamer.