Skip to main content
Skip table of contents

Connecting your Slack Workspace

Task Reminder for Confluence can send reminder messages to your users in your Slack Workspace. For this to work, you will need to connect your Confluence to Slack via a custom Slack app as described below. You must be an administrator of your Slack Workspace.

Step 1: Create Custom Slack App

Navigate to https://api.slack.com/apps. Make sure to login as the Slack user of your Workspace that you would like to connect to. Click on “Create an App” (if you already have other apps, there will be a “Create New App” button instead):

tr-slack.png

Choose “From scratch”:

tr-slack2.png

Enter the details:

  • App Name: this will later appear as the sender name of the reminders in Slack. We recommend “Task Reminder”.

  • Development Slack Workspace: choose your Workspace you want to use

After entering the details, click on “Create App”:

tr-slack3.png

Step 2: Configure the Slack App

Scroll down to the section “Display Information” and upload an icon for your app. We recommend using the official Task Reminder logo:

task-reminder.png

Scroll up to the “Add features and functionality” section and add the “Bot” functionality to the app by clicking on the tile:

image-20201125-070655.png

Add the required scopes by clicking on “Review Scopes to Add”:

Click on “Bot Token Scopes > Add OAuth Scopes” (really make sure you click on the button in the “Bot Token Scopes” and NOT in the “User Token Scopes” section):

image-20201125-071037.png

Add the following scopes: chat:write, users:read, users:read:email.

Optional - Add the IP address of your Confluence server under “Restrict API Token Usage”:

image-20201125-071552.png

Click on “Save IP address ranges”. (Adding your IP address in this step will ensure that requests to your workspace will only be allowed from your Confluence server.)

Step 3: Install the Slack App

Click on “Install to Workspace” at the top of the page:

image-20201125-071401.png

Click on “Allow”:

image-20201125-071633.png

Step 4: Enter the Token into your Confluence Installation

Copy the OAuth token displayed by clicking on “Copy”:

image-20201127-090058.png

Navigate to the Confluence Administration and go to “Slack Settings > configuration”.

image-20201126-153343.png

Paste the token into the “Slack Token” field:

image-20201127-104916.png

Click on “Save”. Send a test message by clicking on the “Send Test Message” button. If the test message doesn’t work, please reach out to us and we will help!

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.