Instructie
Moeilijkheidsgraad:
Beheer > Integraties > Mattermost
Mattermost-koppeling instellen: stappen aan de Mattermost- en i-Reserve-kant
De Mattermost-koppeling vereist configuratie aan twee kanten: eerst een bot-account (en eventueel een outgoing webhook) in Mattermost, daarna de koppeling zelf in i-Reserve.
1. Aan de Mattermost-kant
1.1 Bot-account + token
- Maak een bot-account aan (System Console → Integrations → Bot Accounts → Add Bot Account).
- Genereer een personal access token voor de bot en noteer het.
- Voeg de bot toe als lid van het kanaal waarin gespiegeld moet worden (en van eventuele notificatiekanalen).
1.2 Kanaal-id('s)
- Maak/kies het kanaal waarin gesprekken worden gespiegeld.
- Noteer het Channel ID (kanaalmenu → View Info).
- Maak eventueel extra kanalen voor losse notificatietypen.
1.3 Outgoing webhook (fase 2, inkomend)
- System Console → Integrations → Outgoing Webhooks → Add.
- Zet de Callback URL op de inbound-webhook-URL die i-Reserve toont.
- Mattermost genereert een token; noteer dat voor i-Reserve.
2. Aan de i-Reserve-kant
Ga naar Beheer → Integraties en voeg een Mattermost-koppeling toe. De koppeling heeft een authenticatie- en een configuratie-scherm.
2.1 Authenticatie-scherm
| Veld | Wat in te vullen |
|---|---|
| Server-URL | De basis-URL van de Mattermost-server (bv. https://mattermost.example.com). |
| Bot-token | Het personal access token van het bot-account. |
| Outgoing-webhook-token | (Fase 2) Het token uit de Mattermost outgoing webhook, voor authenticatie van inkomende verzoeken. |
| Inbound-webhook-URL | Alleen-lezen; kopieer deze waarde naar de Callback URL van de Mattermost outgoing webhook. |
2.2 Configuratie-scherm
| Veld | Wat in te vullen |
|---|---|
| Kanaal | Het kanaal waarin gesprekken worden gespiegeld. De keuzelijst toont de kanalen waar de bot lid van is; een al opgeslagen kanaal blijft selecteerbaar. |
| Notificaties → kanaal | Koppel per notificatietype een doelkanaal (leeg = niet versturen). |
2.3 Activeren
Sla op en zet de koppeling op actief. Gebruik de test-knop om een proefbericht naar het kanaal te sturen en zo de bot-rechten te verifiëren.
De bot moet lid zijn van elk kanaal waarin hij post — anders weigert Mattermost met een 403. Voeg de bot dus toe aan het spiegelkanaal en aan elk notificatiekanaal.
De inkomende richting (antwoorden vanuit Mattermost) is fase 2 / beta. Het outgoing-webhook-token en de inbound-webhook-URL zijn alleen nodig als je die richting gebruikt.
