Slack Integration with Simpplr

■

Table of Contents

• Introduction
• Set up as an End user
• Push content to a Slack channel
• Unfurl links
• Set up Slack as an App manager
• Disable Slack

 

Introduction

When pasting a Simpplr url into Slack, the user will unfurl a rich preview that allows two-way interaction. Users can follow sites and people, as well as like content. Content can also be promoted.

Note:

This is a one-way communication method. You cannot post Slack messages to Simpplr.

Slack is one of the most widely used instant message services for businesses. It offers real-time chat, whereas Simpplr's feed is better for organization-wide communication that's often done asynchronously.

Set up Slack as an End user

Back to top

Once Slack has been installed at the application level, you can connect your Simpplr account to it. To do so:

1. Navigate to your profile image and click Profile & settings. Then click Edit profile & settings.
2. Click into the External apps tab and locate Slack. You should see two options for connecting Slack; Slack - Post content from {App name} Intranet to Slack, and Slack - Display a rich preview in Slack. Click Connect account. You'll be taken to an authentication page. Review the information and click Allow.
   
3. To authenticate the account, take a page from any site on the intranet and post it in a Slack channel. 
4. A blurb similar to the one below will appear. Click Connect. This will launch Simpplr and connect the account.
   
5. To verify the account is connected, you can go to Profile & settings > Edit profile & settings > External apps. The Slack integration should offer the option to disconnect your account. That's how you know that currently, your account is connected.
   

Push content to a Slack channel

Back to top

New content can be pushed to Slack from the Promote page menu upon publication.

You can also as use the Post in Slack button after publication. This will post the content directly in a Slack channel of your choice. Just navigate to the piece of content and click the three dots.

Note:

To promote content in a private Slack channel, that channel will need to allow the Simpplr for Slack (or Slack bot) user to push content via Posting permissions in Slack.

Unfurl links

Back to top

Any Simpplr user is able to unfurl (expand) the following links in Slack:

• Content
• Profile
• Site

To do so:

1. Copy & paste the Simpplr link to Slack. The connect prompt link is then displayed in Slack. 
2. Users can like content from within Slack and follow sites or people. When prompted, users click Connect. Now they'll be connected to Slack for unfurl. Their settings in Simpplr will show this change reflected.
   

Set up Slack as an Application manager

Back to top

The App manager will need to complete this step to set up Slack for your Simpplr intranet. Here you have two options:

Option 1

1. Navigate to Manage > Application > Integrations > Messaging.
   
2. Select Slack and click Save. You'll now see the Add to Slack button. Click on it. This will take you to the steps for allowing Slack to communicate with your intranet. Review the notification and click Allow. Now your intranet is connected with Slack.
   
   

Option 2

1. Navigate to the Slack App directory.
2. Search Simpplr for Slack and click on Learn more.
3. Enter the org's Dashboard url (see example below).
4. Click on Install.
   
5. You'll be prompted to log in to your Simpplr environment. If you're not yet logged in, you'll be prompted to. then you'll be taken to an authorization page. Review the information and click Allow.

Disable Slack from Simpplr

Back to top

To disable Slack from Simpplr at the application level:

1. Navigate to Manage > Application > Integrations > Messaging. Uncheck the Slack box and click Save. 
2. Note this does not remove Slack from the intranet entirely. At the User level, users must go to Profile & settings > Edit profile & settings and go to External apps. then they click Disconnect account next to the Slack option. When prompted, click Disconnect.