Instruction
Difficulty level:
Beheer > Integraties > Mattermost
Setting up the Mattermost integration: steps on the Mattermost and i-Reserve side
The Mattermost integration needs configuration on two sides: first a bot account (and optionally an outgoing webhook) in Mattermost, then the integration itself in i-Reserve.
1. On the Mattermost side
1.1 Bot account + token
- Create a bot account (System Console → Integrations → Bot Accounts → Add Bot Account).
- Generate a personal access token for the bot and note it.
- Add the bot as a member of the channel to mirror into (and of any notification channels).
1.2 Channel id(s)
- Create/choose the channel conversations are mirrored into.
- Note the Channel ID (channel menu → View Info).
- Optionally create extra channels for separate notification types.
1.3 Outgoing webhook (phase 2, inbound)
- System Console → Integrations → Outgoing Webhooks → Add.
- Set the Callback URL to the inbound webhook URL i-Reserve shows.
- Mattermost generates a token; note it for i-Reserve.
2. On the i-Reserve side
Go to Administration → Integrations and add a Mattermost integration. It has an authentication and a configuration screen.
2.1 Authentication screen
| Field | What to enter |
|---|---|
| Server URL | The base URL of the Mattermost server (e.g. https://mattermost.example.com). |
| Bot token | The bot account's personal access token. |
| Outgoing webhook token | (Phase 2) The token from the Mattermost outgoing webhook, to authenticate inbound requests. |
| Inbound webhook URL | Read-only; copy this value into the Callback URL of the Mattermost outgoing webhook. |
2.2 Configuration screen
| Field | What to enter |
|---|---|
| Channel | The channel conversations are mirrored into. The dropdown lists channels the bot is a member of; an already-saved channel stays selectable. |
| Notifications → channel | Map a target channel per notification type (empty = do not send). |
2.3 Activate
Save and set the integration to active. Use the test button to send a sample message to the channel and verify the bot's permissions.
The bot must be a member of every channel it posts to — otherwise Mattermost refuses with a 403. So add the bot to the mirror channel and to every notification channel.
The inbound direction (replies from Mattermost) is phase 2 / beta. The outgoing-webhook token and inbound webhook URL are only needed if you use that direction.
