Microsoft Teams Confluence Connector provides two-way integration from Confluence to Microsoft Teams.

Atlassian Marketplace link: https://marketplace.atlassian.com/apps/1216348/microsoft-teams-confluence-connector?hosting=cloud&tab=overview

Microsoft Publisher Certification: https://docs.microsoft.com/en-us/microsoft-365-app-certification/teams/move-work-forward-confluence-connector?pivots=general

Main functionality

  • Setup notifications from Microsoft Teams to Confluence using Global, Space, Content or Personal settings.

    • In Global Settings, you can limit the Confluence spaces that can use Microsoft Teams and Confluence integration

    • Global configuration can be done only by system administrators

    • Space configuration can be done only by space administrators

    • Content configuration allows getting notified about page or blog related events

    • Personal configuration allows a person to get personally notified about authored content

  • Have multiple rules and filters to fine-grain your notifications. Includes space filter, label filter, included and excluded users and authors, path filters and event filters.

  • Comment Confluence content directly from Microsoft Teams. You need to link Microsoft Teams and Confluence user accounts. `connect` command

  • Search Confluence content and embed cards in Microsoft Teams. Using the message box extensions or top search bar.

  • Link unfurling. Paste a Confluence page or blog link and it will be enriched with a card that displays more information about the link.

  • Incoming Webhook integration is still available, but the functionality is limited because it is a one-way integration from Confluence to Microsoft Teams.

  • If something is missing please let us know via our Service Desk.

Demo

You can watch a short video below with the setup process and functionality demo.

Microsoft Teams Confluence Connector Bot functionality

Search Confluence blog posts and pages from Message Input Box.

Use the search and insert rich cards into chat to provide more context.

Enrich Confluence link information to provide more context.

Comment content without leaving Microsoft Teams

Installation

Microsoft Teams Bot

Navigate to the App store inside a Microsoft Teams client and search for “Confluence“ or “Confluence Connector“.

Afterwards, select Microsoft Teams Confluence Connector from the App list and add it to your team.

Pick a team where you want to work with Confluence.

Make sure you mention @Confluence Connector in any public channel of that room in order to be able to send notifications to any public team channel. We recommend to use help command.

Afterwards you can follow this part of the document https://moveworkforward.atlassian.net/wiki/spaces/DOCS/pages/891125777/Microsoft+Teams+Confluence+Connector+with+Bot+Cloud#How-to-setup-Microsoft-Teams-Confluence-Connector-Bot

Video demo how to connect and enable Bot in Confluence

Configuration

Global configuration

Global configuration for Microsoft Teams Confluence Connector accessible at the main Confluence Settings section.

When you start you will not have any rules configured.

Go ahead and click "Add rule", you will be navigated to the window where you can setup triggers, filters and actions for a particular rule.

There are multiple triggers available - you can get notified when a page is created or updated, comment changed or a new interesting blog post is created in a particular Confluence space.

Afterwards you can narrow down your notifications by applying some filters.

For instance, you can include or exclude particular spaces, users, labels or apply a url filter.

When you are done with the filters you can name the rule.

You can pick one of two delivery methods:

  • Microsoft Teams Incoming Webhook. You will need to generate a url (see below for how to do this)

  • Confluence Connector Microsoft Teams bot. It needs to be installed and connected before it can be used.

Important: for every change do not forget to press "Save" button as rules do not auto-save.

When the rule is saved it can be viewed in the list of the Global, Space or Content specific rules. Space specific rules are configured in the Space Settings section.

Additionally, in the Global Configuration, you can restrict the spaces that can use Microsoft Teams Confluence Connector.

Space Configuration

In the Space Settings (Integrations → Microsoft Teams Connector) you can find Space specific rules only. As a consequence, there are space filters in the Space Settings, as all rules here apply to a particular space only.

Content Configuration

Do you want to get notified when a particular page changed or commented? Maybe it is your blog post?

Go to the page you want to receive notifications from, use the top right menu and select there Microsoft Teams Notifications.

This action will trigger a content configuration dialog where you can setup a rule for this page.

Personal settings (only works with Bot)

You can navigate to Personal settings by clicking on your user avatar and picking Microsoft Teams in the menu.

 

Afterwards you can setup your personal notifications.

Important: Personal notifications only work with Microsoft Teams Confluence Connector Bot.

Additionally, on this page you can disconnect your Microsoft Teams account.

How to setup Microsoft Teams Confluence Connector Bot

Connect or link Microsoft Teams and Confluence accounts

In order to interact with the Bot (search, unfurl, comment, etc) you need to connect your Microsoft Teams and Confluence Cloud accounts. Accounts are connected between Microsoft Teams and Confluence tenants.

After the Confluence Connector Bot has been installed you need to use "Connect" command to trigger the connection process.

After you type connect or select connect command you will get a card where you need to insert you Confluence base url and select the Confluence companion App installed (Pro or Lite). 

Important: Microsoft Teams Confluence Connector Confluence app must have been installed before the connection process.

Confluence url usually looks like https://company-name.atlassian.net/wiki. For instance, https://moveworkforward.atlassian.net/wiki or https://microsoft-teams.atlassian.net/wiki

Enter everything and press "Connect Confluence App". If you don't have the Microsoft Teams Confluence Connector companion App installed you can press "Install Pro" or "Install Lite" buttons and install them from Atlassian Marketplace.

Afterwards the special unique user link is generated to connect Microsoft Teams and Confluence accounts. The card from above will be swapped by the card displayed below.

Important: do not share the link or do not use it in a team channels.

When you press the Connect button a special page in your Confluence will be opened to map Microsoft Teams and Confluence accounts.

When you are ready to map press "Connect accounts". From now on you can use Bot functionality.

The message in Microsoft Teams should change to

How to configure Microsoft Teams Incoming Webhook url

Go to the Microsoft Teams channel configuration and add a connector.

microsoft teams Jira connector add connector

Find Incoming Webhook and add one. Put the name as Confluence and set the Confluence logo.

Set the name and the icon of the Connector.

Copy the webhook URL that will be used later on during the configuration process.

Difference between Lite and Pro

  • The Lite version currently has a limit of 100 Microsoft Teams messages sent per month.

  • The rest of the functionality is the same.

How to migrate Microsoft Teams Confluence Connector Lite to Pro

There are 3 simple steps:

  • Start the Free trial of Microsoft Teams Confluence Connector Pro

  • Migrate data from Lite to Pro in the Global configuration page. The black button is like this.

  • Uninstall the Free version or you will have 2 versions running in parallel which will make you different problems (double menu entries, double notifications etc).

If you need help please contact us.

Frequently Asked Questions

You can find frequently asked questions at Microsoft Teams Confluence Connector product page.

Troubleshooting

Update

Please make sure that you have the latest App version, we fix the issue pretty quickly and there is a chance that your problem had been fixed.

Get help

You can create a Jira Service Desk support request with all information you could gather, please include the screenshot of the configuration (please don't worry about the webhook URLs, we won't store or use them) and the logs or errors you could find in the browser or on the server-side.

Official Roadmap

Updated: