Instructie
Moeilijkheidsgraad:
Mattermost-koppeling implementeren: checklist test en productie
Praktische implementatiegids voor de Mattermost-koppeling, met een checklist voor test en productie. De genummerde stappen beschrijven de volgorde; gebruik daarna de checklists per omgeving.
Aandachtspunten
- De bot moet lid zijn van alle betrokken kanalen.
- Voor de inkomende richting (fase 2) moet het i-Reserve inbound-webhook-endpoint publiek bereikbaar zijn vanaf de Mattermost-server.
- Verzending is synchroon; controleer het integratie-log bij uitblijvende berichten.
Checklist — testomgeving
- ☐ Mattermost-bot-account aangemaakt + personal access token genoteerd.
- ☐ Bot toegevoegd als lid van het spiegelkanaal (en notificatiekanalen).
- ☐ Channel ID('s) genoteerd.
- ☐ Auth-scherm gevuld: server-URL + bot-token.
- ☐ Kanaal gekozen en notificatie→kanaal-mapping ingevuld.
- ☐ Test-bericht succesvol in het kanaal geplaatst.
- ☐ (Fase 2) Outgoing webhook in Mattermost met Callback URL = i-Reserve inbound-URL; token in i-Reserve gezet; endpoint publiek bereikbaar.
- ☐ End-to-end getest: webchat gestart → thread in Mattermost; bericht → threaded reply.
Checklist — productieomgeving
- ☐ Productie-bot-account + token (apart van test).
- ☐ Bot lid van de productiekanalen.
- ☐ Productie-server-URL en kanaal-id's ingevuld.
- ☐ (Fase 2) Inbound-webhook-endpoint publiek bereikbaar op productie; outgoing-webhook-token gezet.
- ☐ Koppeling actief; test-bericht geverifieerd.
- ☐ Rollback bekend: koppeling op inactief zetten stopt de spiegeling.
Maak in Mattermost een bot-account, genereer een personal access token en voeg de bot toe als lid van de betrokken kanalen.
Kies het spiegelkanaal en eventuele notificatiekanalen en noteer de Channel IDs.
Vul in i-Reserve de server-URL en het bot-token in, kies het kanaal en stel de notificatie-mapping in.
Maak in Mattermost een outgoing webhook met de i-Reserve inbound-URL als Callback URL en zet het gegenereerde token in i-Reserve. Zorg dat het endpoint publiek bereikbaar is.
Zet de koppeling actief, stuur een test-bericht en test end-to-end vanaf een webchat.
