Instructie
difficulty level:
Beheer > Integraties > Mattermost
Mattermost-Verbindung einrichten: Schritte auf der Mattermost- und der i-Reserve-Seite
Die Mattermost-Verbindung erfordert eine Konfiguration auf zwei Seiten: zunächst ein Bot-Konto (und gegebenenfalls einen Outgoing-Webhook) in Mattermost, anschließend die Verbindung selbst in i-Reserve.
1. Auf der Mattermost-Seite
1.1 Bot-Konto + Token
- Erstellen Sie ein Bot-Konto (System Console → Integrations → Bot Accounts → Add Bot Account).
- Generieren Sie einen Personal Access Token für den Bot und notieren Sie ihn.
- Fügen Sie den Bot als Mitglied des Kanals hinzu, in dem gespiegelt werden soll (sowie eventueller Benachrichtigungskanäle).
1.2 Kanal-ID(s)
- Erstellen/wählen Sie den Kanal, in dem Gespräche gespiegelt werden.
- Notieren Sie die Channel ID (Kanalmenü → View Info).
- Erstellen Sie gegebenenfalls zusätzliche Kanäle für einzelne Benachrichtigungstypen.
1.3 Outgoing-Webhook (Phase 2, eingehend)
- System Console → Integrations → Outgoing Webhooks → Add.
- Setzen Sie die Callback URL auf die Inbound-Webhook-URL, die i-Reserve anzeigt.
- Mattermost generiert einen Token; notieren Sie diesen für i-Reserve.
2. Auf der i-Reserve-Seite
Gehen Sie zu Verwaltung → Integrationen und fügen Sie eine Mattermost-Verbindung hinzu. Die Verbindung verfügt über einen Authentifizierungs- und einen Konfigurations-Bildschirm.
2.1 Authentifizierungs-Bildschirm
| Feld | Was einzutragen ist |
|---|---|
| Server-URL | Die Basis-URL des Mattermost-Servers (z. B. https://mattermost.example.com). |
| Bot-Token | Der Personal Access Token des Bot-Kontos. |
| Outgoing-Webhook-Token | (Phase 2) Der Token aus dem Mattermost-Outgoing-Webhook, zur Authentifizierung eingehender Anfragen. |
| Inbound-Webhook-URL | Schreibgeschützt; kopieren Sie diesen Wert in die Callback URL des Mattermost-Outgoing-Webhooks. |
2.2 Konfigurations-Bildschirm
| Feld | Was einzutragen ist |
|---|---|
| Kanal | Der Kanal, in dem Gespräche gespiegelt werden. Die Auswahlliste zeigt die Kanäle, in denen der Bot Mitglied ist; ein bereits gespeicherter Kanal bleibt auswählbar. |
| Benachrichtigungen → Kanal | Ordnen Sie jedem Benachrichtigungstyp einen Zielkanal zu (leer = nicht versenden). |
2.3 Aktivieren
Speichern Sie und setzen Sie die Verbindung auf aktiv. Verwenden Sie die Test-Schaltfläche, um eine Testnachricht an den Kanal zu senden und so die Bot-Berechtigungen zu überprüfen.
Der Bot muss Mitglied jedes Kanals sein, in dem er postet — andernfalls verweigert Mattermost mit einem 403. Fügen Sie den Bot also zum Spiegelkanal und zu jedem Benachrichtigungskanal hinzu.
Die eingehende Richtung (Antworten aus Mattermost) ist Phase 2 / Beta. Das Outgoing-Webhook-Token und die Inbound-Webhook-URL sind nur erforderlich, wenn Sie diese Richtung verwenden.
