Skip to main content
Skip table of contents

Advanced Microsoft Teams Confluence Connector (Server and Data Center)

Microsoft Teams Confluence Connector provides one-way integration from Confluence to Microsoft Teams. It is a much more secure and robust integration.

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

The main benefit

  • Do not miss important content updates with notifications and scheduled reports.

  • Stay on top of your content when somebody updates it.

  • Know when Confluence tasks are done to move work forward with a scheduled report.

  • Receive notifications when a new Confluence Question or Answer is created (if the Confluence Questions app is used).

  • Get to know about Confluence Calendar events with notifications in Microsoft Teams.

Main features

1-way integration between Microsoft Teams and Confluence On-Premise

  • Set up notifications from Confluence to Microsoft Teams about events in Confluence like pages created, commented, spaces created, etc.

  • Filter down the events to receive only what matters to you. The filters include labels, spaces, and pages.

  • Receive alerts and scheduled reports about issues in status, not transitioned issues, project reports and many more.

  • All of the above can be done on the global and space level.

Demo

Generic demo

Questions for Confluence or Questions and Answers integration demo

Frequently Asked Questions

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

Configuration

There is a global and project-level configuration.

The space-level configuration is in the space settings. The guide for Space administrators is located here.

The global configuration is in the Confluence Administration → Configuration → Microsoft Teams.

Microsoft Teams Confluence Connector Global Configuration

Navigate to the configuration page, select the projects you want to get a notification, and paste the webhook URL.

Set up the filters and the configuration names. Remember that some values are only available when there is only 1 space selected.

Select the events you want to be notified about.

The configuration gets stored in Confluence automatically after every change.

You can have multiple configurations.

To get the page id you may use the page information menu.

Microsoft Teams Workflows app configuration

Follow this guide on how to configure Microsoft Teams Workflows app to receive messages into a Microsoft Teams channel.

Workflows app URLs support is available since 4.01.09

Microsoft Teams channel configuration

Please note, due to the upcoming retirement of Incoming Webhook connector in Microsoft Teams, you must use the Workflows app to generate webhook URLs to receive notifications in Microsoft Teams channels.

Workflows app URLs support is available since 4.01.09.

How to create webhook URL with Workflows app?

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.

Scheduled reports

With a task reminder scheduled report, you can nudge your team about incompleted tasks by scheduling a reminder report.

The report has a few settings:

  • Task created by is a set of users who created the task

  • Task assigned to is a set of users who is assigned to the tasks

  • Task due date/expiration is a parameter that helps you to filter the state of the Confluence tasks. Days are the parameters used in combination with Expiring within and Expiring After.

  • The amount of tasks is the maximum number of tasks to display in the report. If the number is bigger than 20, the message can be rejected by Microsoft Teams due to size limitations.

An example.

Additional global settings

We do NOT notify about events that came from content that has view restrictions by default. However, you can change this in the Global configuration → Settings tab.

Webhook URL management

Are you tired of creating URLs and searching for them? No need to remember anymore. You or your global admins can configure those URLs in the Global configuration → Webhook Url Management tab. Administrators can manage them, and restrict in which spaces they can be used.

You can create a new URL using the Create button and the dialogue that comes after.

When the URL is created it can be changed afterwards.

You can now use the named webhook URL when you create a rule on the global or other levels.

Important: When the managed URL has been deleted, all rules that use will be disabled.

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 has been fixed.

Network

Please make sure Confluence can reach the Microsoft Teams Incoming Webhook URLs (for instance, https://moveworkforward.webhook.office.com).

Please use the “Test” button to check the network connectivity. Please see this info for more details about IP or domain whitelisting.

Debug mode

If you see some problems with the App we recommend checking the browser console for errors and enabling debug mode for the App's namespace to see any errors.

App namespace to enable DEBUG log level: com.moveworkforward

Here is Atlassian’s documentation on how to do this.

Download the support zip

You can send us the support zip, which contains the log files. You can download it following this official Atlassian documentation.

Here is Atlassian’s documentation on how to download the support zip.

Get help

You can create a Jira Service Desk support request with all information you can 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

Trello board link.

Updated:

JavaScript errors detected

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

If this problem persists, please contact our support.