How to get the Slack OAuth Token for Matomo integration

The Matomo Slack plugin lets you deliver reports directly to Slack where your team can receive regular analytics updates. Matomo On-Premise users can install it from the Matomo Marketplace.

The guide explains how to obtain the Slack OAuth token for Matomo integration.

1. Sign in to the Slack App management interface.

2. Click Create New App.
   

3. Select the From a manifest option.
   

4. Select your workspace and click Next.
5. Copy the JSON code below and replace the content in the JSON box:

{
    "display_information": {
        "name": "Matomo Slack Bot",
        "description": "Matomo Slackbot to get Matomo Scheduled Reports/Alerts via Slack",
        "background_color": "#000000"
    },
    "features": {
        "bot_user": {
            "display_name": "Matomo Slack Bot",
            "always_online": false
        }
    },
    "oauth_config": {
        "scopes": {
            "bot": [
                "chat:write",
                "files:write"
            ]
        }
    },
    "settings": {
        "org_deploy_enabled": false,
        "socket_mode_enabled": false,
        "token_rotation_enabled": false
    }
}

1. Review the app and click Create.
2. Click OAuth and Permissions in the left menu.

3. Click Request to Install to generate the OAuth token.
   
   Note: If you are not the owner of your workspace, you would need an approval to install this APP to your workspace and generate token.

4. Optional: Add a message for your workspace owner to install this APP.
   

5. Once approved, you would receive a notification on Slack.
   

6. Navigate back to https://api.slack.com/apps/ > click Matomo Select Bot > click OAuth and Permissions.

7. Copy Bot User OAuth Token, starting from xoxb-*.
   

Now that you have your Slack OAuth token, you can continue with the setup process. Follow the Slack integration guide to connect Matomo with Slack.