# Slack API
# Connecting Slack and Cocoom
The Cocoom / Slack connection provides two distinct and independent functions:
- SSO authentication: using Slack to authenticate users (Users use their Slack credentials to log in to Cocoom)
- Notifications: use Slack to notify users of actions performed on the Cocoom platform.
# Step 1: Create an App
In a web browser, go to api.slack.com
Once you are on this page, you need to login to your Slack "Go to Slack" space.
Once logged in, go back to https://api.slack.com and click on "Your Apps".
Click on “create an app”
Fill in the "App Name" field, select the appropriate "workspace", then click on "Create App"!
# Step 2: Configure the App visually
In the "Basic Information" section, scroll down to "Display information".
Fill in the following information:
- 1- App name: Cocoom
- 2- Short description: optional description
- 3- App Icon: download the official icon here: Logo
- 4- Background color: #0F5AE5
Save the changes.
# Step 3: Configure SSO Slack Authentication
If and only if you wish to use Slack's user IDs to connect to your Cocoom platform. This means that when they connect to Cocoom, it is your Slack platform that will take over to authorize them to connect.
In the "OAuth & Permissions" section, click on "Add New Redirect URL".
Then copy and paste the address of your Cocoom platform like this : https://YOURDOMAIN.cocoom.com/oidc
Don't forget to back up!
Scroll down the OAuth & Permissions page to the "Scopes" section.
and add the following scopes
# Step 4: Configure Cocoom notifications in Slack
To receive Cocoom notifications directly in your Slack channels, you need to add a BOT.
Go to the "App Home" section and go to the "You're App presence in Slack" section. We'll start by editing the display by clicking on "edit" of the app display name" and fill in the fields identically:
# Step 5: Finalize the installation
In the "Install App" section, click on "Install App to Workspace".
It's almost done! Your application is ready, we need to link it to Cocoom 🎉!
# Step 6: Send the Slack connection elements to the Cocoom team
Slack has generated connection elements to allow the Cocoom App to communicate securely with Slack. All that remains now is to send these elements to the Cocoom support address to connect them.
Prepare your email for support@cocoom.com and add :
- For SSO authentication: Client ID and Secret Client :
Note: You can either send these information directly in the body of the email (please append your Cocoom domain name as well, called YOURDOMAIN in this help page), or send them by filling in the following PDF document: OIDC Cocoom Form
- For the notification BOT: Bot User OAuth Access Token
✌️ The support team will get back to you within several minutes to 48h maximum to validate your App!