# Slack API

# Connecting Slack and Cocoom

The Cocoom / Slack connection provides two distinct and independent functions:

  1. SSO authentication: using Slack to authenticate users (Users use their Slack credentials to log in to Cocoom)
  2. 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.

Image transférée par l’utilisateur : image.png

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!

Last Updated: 3 years ago