Loading ...

Slack Administration Setup | Axero Documentation

Home » axero documentation » Wiki » Documentation » Third-Party Integrations » Slack Administration Setup
Axero Documentation  Wiki
Public Space
Activity Stream Content
Version 12

Slack Administration Setup

0 
 /5
0 (0votes)

With the Slack integration, you can 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. The next screen will show you your workspace. Click on it and re-navigate to the 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 & choose 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 must 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 you added it to the channel.

Configure Axero 

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

  1. In Axero, go to Control Panel > System > Integrations > Add Connected Account.
  2. 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>




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

 Option 1: Add a 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 the page and copy the Webhook URL.

5. The next screen will show the Slack Integration

Once set up, users will start receiving message alerts in Slack:

Option 2: Add multiple channels to your App

You can add multiple channels in the same app.

  1. Create a new channel in Slack.

  2. Give the channel a name and click Create.

  3. Navigate to the Slack API page and select the App you have already created.

  4. Click Incoming Webhooks.


  5. Click Add New Webhook to Workspace.

  6. Type the channel name you just created. Click Allow.

  7. Copy the new Webhook URL

  8. In Axero, go to Webhooks under Manage Space settings or, for the top level,  Control Panel > System > Integrations > Webhooks). In this example, we are adding a new channel to a space.

  9. Click Add Webhooks > Slack.

  10. 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.


  11. You will now see a second webhook added to the 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 Axero 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 Axero, go to Control Panel > System > System Properties.

6. Search for SlackApiClientSecret & SlackApiClientID.

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

8. In Control Panel > Content > Notification Permissions.

9. Select the role in which you want to enable Slack notifications.

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.

Related: Content Notifications 

Revoking Slack Account Access

Each person can revoke access to their Slack account whenever they choose.

  1. Simply navigate to Activity Stream > Integrations.  

  2. Click on the Delete button linked to your Slack integration.

Wiki Index

Pages