Efento Cloud – Slack integration

Before you start

To integrate Slack with Efento Cloud you will require:

• Slack account and Slack workspace either paid or free account

• Efento Cloud account with Administrator permission to the selected organisation

Slack configuration

1. Create a slack app

1. Log in to your Slack account
2. Go to Slack API: Your Apps
3. Click Create New App
4. Choose From scratch
5. Enter an app name (e.g. Efento Cloud notification bot) and select the workspace
6. Click Create App

2. Configure bot permissions

1. In the left-hand menu, go to OAuth & Permissions
2. Scroll down to Scopes section and under Bot Token Scopes, click Add an OAuth Scope and add permission to chat:write
   
3. If you wish, you can customise bot’s appearance.  In the left-hand menu, go to Basic Information and scroll down to Display Information section. Set colour, app icon and descriptions and save changes

3. Install the app to your workspace

1. Scroll to the top of the page and press Install to Workspace button
   
2. Authorise the requested permissions
3. After installation, copy the Bot User OAuth Token (starts with xoxb-...)

4. Invite the bot to a channel

1. Open Slack (web or desktop)
2. Navigate to the desired channel (e.g., #general)
3. Type /invite @YourBotName and press Enter
4. The bot must be a member of the channel to post messages

5. Copy the channel ID / name

1. Click on the channel name
   

2. Copy the channel ID
   

Important: You can also use the Channel name for the integration. However, using the Channel ID is more reliable, as it remains constant. If you choose to use the channel name and it’s later changed by someone in your workspace, the integration will stop working.

Efento Cloud configuration

1. Create a new Slack connection

1. In the left-hand menu go to Settings (gear icon) and Organisation settings
2. Navigate to Integrations
3. In the Slack section click the Add new Connection button
4. Set connection parameters by:
   1. Adding connection name (e.g. Slack integration channel)
   2. Pasting the Bot User OAuth Token (starts with xoxb-...) (this is the token you have copied in step 3 in the ‘Install the app to your workspace’ section of Slack configuration)
   3. Entering the channel ID / name (step 1 in the  ‘Copy the channel ID’ section of Slack configuration)
      
5. Click the Test connection button. If the connection is successful, you will see a test message in your Slack channel.
   
   If no message is received, verify if:
   1. The bot has been invited to the channel
   2. The token and channel ID are correct
   3. The app has the necessary permissions
6. Save the connection by clicking Add connection

2. Enable Slack notifications for selected rule(s)

1. In the left-hand menu go to Settings (gear icon) and Rules and notifications
2. Select rule name and parameters and press the Next button
3. Select sensors / location to which the rule will be assigned and press the Next button
4. In the Notifications section press the Connect integration button
5. In the Integrations drop down menu select Slack and  in the Connect Integration drop down select the name of the added integration. Press the Connect Integration button and save changes. From now on, if the rule is triggered, you will receive the integration to the selected Slack channel

Please note the following:

• You can reuse a single integration across multiple rules. Simply create several rules and select the same connection for each. With this setup, if any of the rules are triggered, the bot will send messages to the same Slack channel.
• You can use one Slack bot to send notifications to multiple channels. To do this, create additional integrations in the Organisation settings, using the same Bot User OAuth Token but different Slack Channel IDs.
• This integration allows Efento Cloud to send notifications to both public and private Slack channels, but it does not support sending direct (private) messages to individual users in your workspace.