How to integrate Microsoft Teams and Matomo

The Matomo Microsoft Teams plugin lets you deliver reports and custom alerts directly to Microsoft Teams where your team can receive regular analytics updates. Instead of logging into Matomo to check updates, you can view key metrics where your team already collaborates, making it easier to track performance and share insights in real time. Matomo On-Premise users can install it from the Matomo Marketplace.

The guide explains how to enable Microsoft Teams in Matomo and configure your scheduled report for Microsoft Teams delivery.

Step 1: Get the Microsoft Client Id, Client Secret, Tenant Id and Teams Id

You will need to first obtain your Client Id, Client Secret, Tenant Id and Teams Id before setting up the integration. If you are unsure how to get it, can follow this guide for detailed instructions.

Step 2: Get the Microsoft Webhook URL

You will need the Webhook URL for the endpoint that Matomo uses to deliver event notifications, such as alerts or scheduled reports to Microsoft Teams. Read the guide on how to get the Microsoft Teams Webhook URL.

Step 3: Set up Microsoft Teams in Matomo

1. In Matomo, navigate to Administration > System > General settings > Microsoft Teams.
2. In the fields provided, enter your Microsoft Client Id, Client Secret, Tenant Id and Teams Id obtained in Step 1: Get the Microsoft Client Id.
3. Save your settings.

Step 4: Configure your scheduled report

1. Navigate to Administration > Personal > Schedule Reports.
2. Click Create and Schedule a Report.
3. Select the relevant report settings.
4. For Send report via, choose TEAMS.
5. Select the preferred Report Format.
6. Enter the Teams Webhook URL generated in Step 2: Get the Microsoft Webhook URL.
7. Note: If you have not yet provided required fields in Matomo, the Teams Webhook URL field will be disabled. Follow Step 3: Set up Microsoft Teams in Matomo to enable the field.
8. Complete the report setup and click Create Report.

Step 5: Test the scheduled report

1. Once everything is configured, you can test the setup in Personal > Schedule Reports.
2. For the configured report, click Send Report now to trigger an immediate delivery.
   

In future, the report should be automatically delivered to the specified Microsoft Teams channel according to the defined frequency.

Troubleshooting

If your scheduled report is not appearing in Microsoft Teams, check the following issues:

• If you did not receive the report in Ms Teams: Check the Microsoft Client Id, Client Secret, Tenant Id and Teams Id is valid and correctly added in General settings > Ms Teams.
• If the report is still not sending: Review your report configuration under Personal > Schedule Reports to ensure the frequency, format, and delivery options are saved correctly.

With the correct setup in place, your Matomo reports will flow reliably to Teams, keeping stakeholders up to date. Learn more about sending custom alerts to Microsoft Teams.