01
Enable Bot Accounts
- Log in as System Admin
- Go to System Console → Integrations → Bot Accounts
- Toggle Enable Bot Account Creation ON
- Click Save
All integrationsConnect Mattermost
Connect Mattermost
to Vatoo
Connect Vatoo to your self-hosted Mattermost server. Vatoo uses Mattermost's Outgoing Webhooks to receive messages and the REST API v4 to send replies · no external dependencies needed.
Estimated: 10–20 minutesMedium6 steps
Confirm connector availability, your account plan, and required permissions before setup. Test with a non-production record before enabling live actions.
VatooMattermost
Enable Bot Accounts01
Create a Bot Account02
Configure in Vatoo Botmaster03
Create an Outgoing Webhook04
Setup overview · illustrative
Have these
ready
- Vatoo botmaster account with a bot configured
- Mattermost server with System Admin access
- Mattermost version 5.0 or higher
6 steps
to go live
02
Create a Bot Account
- Go to Integrations → Bot Accounts → Add Bot Account
- Set Username to something memorable (e.g. niva-bot)
- Set Display Name and optionally an avatar
- Set Role to Member
- Click Create Bot Account
- Copy the Access Token immediately · it is only shown once
Note down the bot username · you need it to prevent reply loops.
03
Configure in Vatoo Botmaster
- Open your Vatoo botmaster → Omnichannel
- Click Configure on the Mattermost card
- Enter your Server URL (e.g. https://mattermost.yourcompany.com)
- Paste the Bot Access Token
- Enter the Bot Username (e.g. niva-bot)
- Leave Webhook Token blank for now, click Save & Activate
- Copy the Webhook URL
04
Create an Outgoing Webhook
- In Mattermost → Integrations → Outgoing Webhooks → Add Outgoing Webhook
- Set Content Type to application/x-www-form-urlencoded
- Select channel(s) or leave blank for all channels
- Paste your Vatoo Webhook URL into Callback URLs
- Click Save
- Copy the Token shown
Content Type must be form-encoded, not JSON.
05
Add Webhook Token to Vatoo
- Back in Vatoo Omnichannel → Edit the Mattermost config
- Paste the token into Outgoing Webhook Token
- Click Save & Activate
06
Add Bot to Channel and Test
- Open target channel → click channel name → Add Members
- Search for your bot username and add it
- Send a message · bot should reply in 2–3 seconds
Stuck?
Quick fixes
No reply at all
Check outgoing webhook URL is correct and server is reachable.
Token mismatch in logs
Webhook token doesn't match · re-copy from outgoing webhook settings.
Bot replies to itself
Bot Username field not set in Vatoo config.
channel\_id missing
Content Type must be application/x-www-form-urlencoded, not JSON.
More integrations
Connect Mattermost in one call
Book a demo and we'll set up the integration with you live.