You can connect Mattermost to get:
To receive personal direct notifications, you need to connect the Mattermost Bot.
To receive team notifications in any public channel, you need to connect the Mattermost Channel.
Connect Mattermost Bot (My Notifications)
To receive personal notifications in your Mattermost direct messages, you need to connect the Mattermost Bot.
- Go to Integrations > Mattermost Bot. Activate the tumbler.
- The status of integration will be Not configured. Click Connect Mattermost Server.
- Follow the instructions to connect Mattermost.
- Check if there is access to add new bots in Mattermost. Go to System Console.
- Scroll down to Integrations > Bot Accounts. Check if it is True for Enable Bot Account Creation.
Step By Step Instructions
1. Your Mattermost Server URL.
In app click on Title bar, click Edit.
Copy URL from the window.
In the browser version, you can get it from the URL placement.
Paste the URL in the Ducalis form.
2. Create New Bot
In Mattermost go to Integrations > Bot Accounts > Add Bot Account.
- User Name – ducalis_bot
- Display Name to Ducalis.io Bot
- Bot Icon – download
- Description – Sends personal and channel notifications from Ducalis.io
- Role – Member
- post:all – Enabled
Click Create Bot Account.
If you don’t see the “Bot Accounts” option in your Integrations settings. Please ask your system admin to enable “Bot account creation” in Mattermost System Console > Integration Management > Bot accounts Official Docs.
3. Add ducalis_bot Token
- Go to Main Menu (Upper Left Corner) > Integrations > Bot Accounts > Choose previously created Bot > click Create New Token.
- Copy Access Token (not Token ID) and paste it in the form in Ducalis.
Then you’ll see the tumbler that is turned on. If you are allowed and able to grant the bot Admin access, users will be matched when connecting to the bot without needing to set up OAuth. To do this, go to the bot and change its role to ‘System Admin’, and click Update.
Then go to Ducalis and click Save Configuration.
Your integration is ready to work.
4. If you are NOT able to give the ‘System Admin’ role to the bot, turn off the tumbler and continue to set the configuration.
Create a new OAuth 2.0 Application.
In Mattermost go to Integrations > OAuth 2.0 Applications > Add OAuth 2.0 Application.
- Trusted – No
- Display Name – Ducalis.io
- Description – Sends personal and channel notifications from Ducalis.io
- Homepage – copy from the form
- Icon URL – copy from the form
- Callback URLs – copy from the form
Click Save and Done.
NOTE: check if it is allowed to add OAuth 2.0.
Go to System console > Integrations > Integration Management > Enable OAuth 2.0 Service Provider: True
5. Add OAuth 2.0 Application Client ID and Secret
Go to Integrations > OAuth 2.0 Applications > Add OAuth 2.0 Application and choose ducalis bot.
Copy Client ID and Secret and paste it in Ducalis form.
Click Save and allow Ducalis.io access.
Now you can configure your personal notifications.
Configure ‘My Notifications’ to Mattermost
1. Go to My Notifications.
2. Disable notifications you don’t want to receive in your direct messages on Mattermost.
3. Choose boards you need to get notifications.
Connect Mattermost Channel (Team Notifications)
To receive team notifications in your Mattermost channels, connect the Mattermost Channel.
- Go to Integrations > Mattermost Webhook. Activate the tumbler.
- Go to Team Notifications.
- Choose any notification you need.
- The window will appear.
- Choose a team you want to receive notifications in.
- Manually put the name of the channel you want to receive notifications in.
- Repeat for other notifications.
Edit or Delete Channel Integration
You can change the channel or delete this channel integration.
Choose the notification. Click Edit pencil icon.
Disable Mattermost Integration
Go to Integrations > Enabled.
For Mattermost Bot
Click Edit Configuration
Scroll down to Remove Integration button.
For Mattermost Channel
Find Mattermost Channel. Click Remove Integration.
