Use Slack and Confluence together

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

On this page:


How do I install the Confluence Server for Slack app in Confluence?

Head to the Atlassian Marketplace to download the Confluence Server for Slack app. 

 

How do I connect the Confluence Server for Slack app to my Confluence site?

As an administrator, you'll now have a "Slack Integration" navigation item under "Confluence administration"

From here, select "Connect Slack Team"

You'll then be taken to Slack's App Directory to install the Confluence Server Slack app. Click the green "Install" button for the Slack app and complete Slack's OAuth process.

Once you complete the OAuth process in Slack, you'll then see a new configuration page for your integration. Scroll to the bottom to see the two fields you need to complete. First, add your Confluence Server web address. Please do not include a trailing / after your web address. Second, you'll want to copy the contents of box #2 back into your Confluence setup. 

Paste the credentials into the Confluence configuration on the Confluence Server side. Click save here, and be sure to click "Submit" in your Slack window (screenshot above).

Once the connection has been setup, you'll receive a success notification from Confluence Server in your direct message with Slackbot.

How do I set up a space to post notifications into Slack?

As a Confluence Administrator

In the Applications section of Administration, you'll see "Slack Integration" listed under Integrations. From here, you can connect Confluence spaces to to different slack channels.

Once you've selected a channel, you'll now see the connection to Slack listed below. You will also receive a notification in Slack that Confluence notifications have been set up to appear in the channel.

From the configuration menu in Confluence, you can filter exactly what notifications you want sent to that channel, by subscribing or unsubscribing to Blog post created, Page created, and page updated events.

As a Space Administrator

Space Administrators are able to set up and configure their Slack notifications. In a Confluence space, under Space Tools, you should see a link for the Slack integration. From this page, space administrators can see current Slack channel connections for that space, as well as set up new ones. 

How do I connect to a private channel?

In order to connect to a private channel, you must first confirm access to your Slack account. On the Slack integration screen in Jira (in both Project and Global Admin), you'll see a link to do this under "Connection status" if you haven't done it yet. Clicking this link will take you to a Slack auth link, which will give the app the ability to view your channels.

Once you've completed this step, you should now see "You're accessing Slack as [Your Name]", and should now be able to select private channels from the drop down. Each user who wants to connect their private channels to the Slack integration will need to do this step.

How do I connect Confluence Server to a direct message or multi party direct message?

Unfortunately, it's not possible to set up Confluence Server notifications into Slack's direct messages or multi party direct messages.
Alternatively we suggest setting up a private channel and configuring notifications to route there.

How do I connect to a different Slack Workspace?

The Confluence Server for Slack app supports the ability to connect to multiple Slack Workspaces, such as in a Slack Enterprise Grid. To do so, on any of the Slack integration pages in Confluence, you should see a dropdown of workspaces at the top. To connect to a new workspace, click this and click "Connect to a new team." Please follow the steps from above to connect your new workspace to this Confluence Server instance.

I use multiple Confluence Server instances. How do I connect them to Slack?

The process for setting up additional Confluence Server instances to Slack takes some manual configuration to setup. Please ensure that you follow the below steps perfectly to ensure proper connectivity between your Confluence Server instance and Slack. You can repeat this process multiple times for each additional Confluence Server instance you have.

First, visit https://api.slack.com/apps and click the green "Create New App" button.

Slash Commands

Once you've created the app, select "Slash Commands" under Features in your app settings. Then, click "Create New Command"


Copy the details of this command over from the above screenshot. Please replace {{url}} with your Confluence Server's url (eg. confluence-demo.company.com). Once saved, your new slash command should show up in the list. Now continue to "OAuth & Permissions" under Features.

OAuth & Permissions

First, we'll click "Add New Redirect URL". Set this to http://{{url}}/slack/oauth. Again, replace {{url}} with your Confluence Server's URL. Make sure to click "Save URLs".

Next, scroll down to the Scopes section. Please add the following scopes 

channels:read
chat:write:bot
links:read
groups:read
groups:write
links:write

Double check that you've added all scopes, and hit "Save". Without all of these scopes, it's possible that the bot will not function correctly. If you're having issues with the bot working later, please reference that you've asked for all required permissions.

Bot Users

Click "Bot Users" in the Features navigation bar and click "Add a Bot User"

You can set the Display name and default username to whatever you'd like (for instance, "Finance Confluence"). Click the green "Add Bot User" button at the bottom.

Event Subscriptions

Click on the "Event Subscriptions" navigation menu item and click the "Enable Events" toggle button.

Add your Request URL https://{{url}}/slack/event and click Change. Please validate that it says "Verified" to ensure your connection between Slack and your Confluence Server instance

Now you can subscribe to the following events under "Workspace Events"

app_uninstalled channel_archive channel_deleted channel_unarchive group_archive
group_deleted group_unarchive link_shared tokens_revoked

Scroll down to Bot Events and add the following events here:

app_mention member_joined_channel message.channels
message.im message.mpim message.groups

Validate all of the events have been added and click "Save Changes"

Install the App

You can now install your app to your workspace by clicking "Install App" under settings and "Install App to Workspace"

In the Confluence config screen, click the "Connect to a new Team" menu item. Then click on "advanced" for connection type. You'll need to copy each of the settings from your Slack app configuration into this screen. Once completed, you'll be able to start using your Confluence Server integration.

Is this supported by Atlassian?

Yes, absolutely. This integration is built and maintained by Atlassian. If you need support, visit support.atlassian.com.

Last modified on Mar 5, 2019

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.