Slack Administration Setup

Communifire Documentation Wiki

Public Space

Version 11

Slack Administration Setup

JD Flores

Published: 11/5/2021

Vladana Garic

Updated: 8/21/2023

7171

0 (0votes)

Configure a Slack app and your Axero intranet to set up this integration. With the Slack integration set up, you will be able to connect your organization's Slack account to your Axero Intranet and send a content notification or view activity in your top level community in a selected Slack channel.

Connect Slack App to Axero

1. Navigate to Slack API page. On this page click sign in to your Slack account

2. The next screen will show the sign in page. Enter your credentials

3. You will receive an email from Slack with a 6 digit code. Enter the code.

4. Next screen will show you your workspace. Click on it and re-navigate to Slack API page

5. Click Create an App

6. If you have previously created Slack Apps, you'll instead click Create New App from within your API library:

7. On the following pop-up select From scratch

8. On the next pop-up Name app and Select a workspace. Click Create App

9. The app will now be created. On the Basic Information page that opens next, scroll down and copy App Credentials. Save them for later.

10. Enter Display Information Fields and click Save Changes

Push Space Activity To Slack Channels

After successfully connecting the Slack app to Axero (Above Section), to push space activity into Slack Channels do the following:

1. On the Slack API page for your new app. On the left hand side, click Incoming Webhooks

2. Activate Incoming Webhooks. Select Add New Webhook to Workspace

3. Click Allow

The next screen will show the added Webhook. Copy the URL and save it for later.

Navigate to your Slack App.

Select the channel you want to add where you want to activate the webhook.
- Integrating multiple Slack channels with your Axero Intranet is possible, though each will need to be set up independently with a unique webhook.
- At the top, next to the channel name, select the dropdown icon. Click Integrations> Add an App. Select your newly created app. The integration will show as added to the channel by you.

Configure Communifire

Slack can be configured to work at Top level or in a Space. To integrate Slack in a space, click Manage Space - Integrations - Add Connected Account.

In Communifire, go to Control panel - System - Integrations - Add Connected Account.
Fill in the following information

Display Name: This name will appear in My Integrations when a user has connected their account.
App ID: Paste the App ID
Client ID: Paste the Client ID
Client Secret: Paste the Client Secret
Signing Secret: Paste the Signing Secret
NOTE: Redirect URL - this field is already filled in by the Axero platform: <https://yoursitename.com/oauth2/slack/callback or https://yoursitename.communifire.com/oauth2/slack/callback>

Click Save Settings
The next page will list your newly created integration.

Option 1: Add single channel to your app

1. Click Webhooks

2. Click Add Webhooks - Slack

3. Fill in the following

Display Name: Give Integration a name. This will be shown on the Slack messages
Connected Account: Choose account from dropdown
Webhook URL: Paste Webhook URL.
Notification Template: Choose template of your choice.
Save Settings: To save the setting

To find Webhooks URL, go back to Slack API page and select Incoming Webhooks.

4. Scroll to the bottom of page and copy the Webhook URL

5. Next screen will show the Slack Integration

Once setup users will start receiving message alerts in Slack like shown

Option 2: Add multiple channels to your App

You can add multiple channels in the same app.

Create a new channel in Slack
Give channel a Name and click Create
Navigate to Slack API page and select the App you have already created.
Click Incoming Webhooks
Click Add New Webhook to Workspace
Type the channel name you just created. Click Allow.
Copy the new Webhook URL
In Communifire go to Webhooks under Manage space settings or for Top level (Control Panel - System - Integrations - Webhooks). In this example we are adding the new Channel in a Space.
Click Add Webhooks - Slack
Add

Display Name: Give Integration a name. This will be shown on the Slack messages
Connected Account: Choose account from dropdown
Webhook URL: Paste Webhook URL.
Notification Template: Choose template of your choice.
Save Settings: To save the setting
You will now see a second Webhook added in space

Content Notifications for Slack

After connecting the Slack app to Axero, you can send notifications for content to Slack through the custom notification feature:

1. Go to your Slack API page for your newly created app and select OAuth & Permissions.

2. Scroll down to Redirect URLs and click Add New Redirect URL.

3. Add your new URL following this pattern: https://YourURLHere/oauth2/Slack/callback (replace YourURLHere with the domain of your Communifire site)

4. Click Add and then click Save URLs. PLEASE ENSURE YOU HAVE CLICKED SAVED URLS AFTER THIS STEP, IT IS EASY TO OVERLOOK.

5. In Communifire go to Control Panel>System>System Properties

6. Search for SlackApiClientSecret & SlackApiClientID

7. Enter the value for each property (These were saved in your setup of the Slack App in the above section).

8. In Control Panel > Content > Notification Permissions

9. Select the Role you want to enable Slack notification.

10. Now when notifying users of content the Slack option appears:

11. The following modal will appear. Then click Connect to Slack:

12. Click Allow.

13. The full notification modal will show now.

You have the option to select a Slack channel of your choice. Utilizing your connected Slack account, you can include a personalized Slack message within the chosen channel. This message can include a link and a content summary (if applicable), positioned below your message for enhanced communication effectiveness.