How to integrate Slack for Scheduled Reports

Auto-hébergement

The Matomo Slack plugin lets you deliver reports directly to Slack 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 Slack in Matomo and configure your scheduled report for Slack delivery.

Step 1: Get the Slack OAuth token

You will need to first obtain your Slack OAuth token before setting up the integration. If you are unsure how to get it, can follow this guide for detailed instructions.

Step 2: Set up Slack in Matomo

  1. In Matomo, navigate to Administration Settings Cog Icon > System > General settings > Slack.
  2. Enter your Slack OAuth Token in the field provided.
  3. Save your settings.
    Slack OAuth token

Step 3: Configure your scheduled report

  1. Navigate to Administration Settings Cog Icon > Personal > Schedule Reports.
  2. Click Create and Schedule a Report.
  3. Select the relevant report settings.
  4. In the section, Send report via, choose SLACK.
  5. Select the preferred Report Format.
  6. Enter the Slack Channel ID of the channel that will receive these reports. To find the ID, go to the Slack channel and click Open channel details. The Channel ID is located at the bottom of the About tab.
  7. Note: If you have not yet provided your Slack OAuth Token in Matomo, the Slack Channel ID field will be disabled. Follow Step 2 (described above) to enable Slack.
  8. Complete the report setup and click Create Report.

Note: You’ll need to add the new Slack bot to the channel before it can post there. For example, run: /add @Matomo Slack Bot

Step 4: 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 Slack channel according to the defined frequency.

Troubleshooting

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

  • If you did not receive the report in Slack: Check the Slack OAuth token is valid and correctly added in General settings > Slack (refer to Step 2 above).
  • 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.
  • If the report went to the wrong channel: Confirm that the Slack Channel ID is correct. The ID is not the same as the channel name and must be copied from Slack.

With the correct setup in place, your Matomo reports will flow reliably to Slack and keep your team up to date.