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 Webhook.
Connect Mattermost Bot
To receive personal notifications in your Mattermost direct messages, you need to connect the Mattermost Bot.
1. Go to Integrations > Mattermost Bot. Activate the tumbler.
2. The status of integration will be Not configured. Click Connect Mattermost Server.
3. Follow the instructions to connect Mattermost.
4. Check if there is access to add new bots in Mattermost. Go to System Console.
5. 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 > Create New Token. Copy Token and paste it in the form in Ducalis.
4. 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 Webhook
To receive team notifications in your Mattermost channels, connect the Mattermost Webhook.
1. Go to Integrations > Mattermost Webhook. Activate the tumbler.
2. Go to Team Notifications.
3. Choose any notification you need and click edit icon.
4. The window will appear.
Step By Step Instruction
1. Add a Webhook url.
In Mattermost go to Main Menu > Integrations > Incoming Webhooks > Add Incoming Webhook.
Fill in title, description, channel, username and profile picture (optional). They can be understandable for you.
Click Save. Copy URL and paste it in Ducalis.
2. Add channel name.
Fill in the channel you want to get this notification in. Use system name (like town-square), not Town Square.
3. Click Save.
4. Repeat for other notifications.
Disable Mattermost Integration
Go to Integrations > Enabled.
For Mattermost Bot
Click Edit Configuration
Scroll down to Remove Integration button.
For Mattermost Webhook
Find Mattermost Webhook. Click Remove Integration.
