---
title: "Mattermost"
description: "Benachrichtigungen in einen Mattermost-Kanal: eingehende Webhooks freischalten, Webhook anlegen, selbst gehostete Server im internen Netz, Absendername und Profilbild"
---

QuickTribe schickt Nachrichten über einen **eingehenden Webhook** (Incoming Webhook) an Mattermost – egal ob bei Mattermost gehostet oder auf eurem eigenen Server.

## 1. Eingehende Webhooks freischalten (System Admin)

Eingehende Webhooks muss ein **System Admin** einmal für den Server erlauben:

1. Öffne **System Console → Integrations → Integration Management**.
2. Setze **Enable incoming webhooks** auf **True** und speichere.
3. Optional, damit Nachrichten unter einem eigenen Namen und mit dem Symbol der Plattform erscheinen:
   - **Enable integrations to override usernames** → **True**
   - **Enable integrations to override profile picture icons** → **True**

Ohne diese beiden Optionen erscheinen Nachrichten unter dem Namen der Person, die den Webhook angelegt hat, mit dem Kennzeichen „BOT“. Mattermost weist darauf hin, dass Integrationen mit diesen Optionen andere Personen nachahmen könnten – entscheidet das bewusst.

Bei selbst gehosteten Servern lassen sich dieselben Einstellungen auch in der `config.json` bzw. über Umgebungsvariablen nach dem Schema `MM_SERVICESETTINGS_…` setzen (z. B. `MM_SERVICESETTINGS_ENABLEINCOMINGWEBHOOKS=true`). Ob normale Mitglieder selbst Webhooks anlegen dürfen, regeln die Berechtigungen in der System Console.

## 2. Webhook anlegen

1. Öffne das **Produktmenü** (Raster-Symbol oben links; in älteren Versionen das Hauptmenü) → **Integrations**. Fehlt der Punkt, sind eingehende Webhooks noch nicht freigeschaltet oder du darfst sie nicht anlegen.
2. Wähle **Incoming Webhooks** → **Add Incoming Webhook**.
3. Trage einen Titel (z. B. „QuickTribe“) und optional eine Beschreibung ein und wähle den **Channel**. Mit **Lock to this channel** kann der Webhook nur in diesen Kanal posten – das empfehlen wir.
4. Klicke **Save**. Mattermost zeigt die Adresse an, z. B. `https://chat.example.org/hooks/xxxxxxxxxxxxxxxxxxxxxxxxxx`. Kopiere sie und schließe mit **Done**.

<Note>
Behandle die Adresse wie ein Passwort – wer sie kennt, kann in den Kanal posten.
</Note>

## 3. In QuickTribe eintragen

1. Öffne **Einstellungen → Integrationen** und klicke auf **Kanal hinzufügen** → **Mattermost**.
2. Gib einen **Namen** ein und füge die **Webhook-Adresse** ein. Sie muss mit `https://` beginnen und `/hooks/` enthalten.
3. Optional: **Absendername** (z. B. „QuickTribe“) und **Plattform-Symbol als Profilbild**. Beides wirkt nur mit den Override-Optionen aus Schritt 1; sonst ignoriert Mattermost die Angaben stillschweigend.
4. Wähle Ereignisse, Sprache und Zeitzone, **Speichern** und **Testnachricht senden**.

## Mattermost im internen Netz

QuickTribe stellt aus Sicherheitsgründen nur an **öffentlich erreichbare Adressen** über `https://` und Port 443 zu. Liegt euer Mattermost in einem internen Netz – etwa im selben Docker-Netz wie QuickTribe oder unter einer Adresse wie `chat.intern` –, lehnt QuickTribe die Adresse mit „Die Adresse ist nicht erreichbar oder zeigt in ein internes Netz“ ab.

Dann muss der **Betreiber** eurer QuickTribe-Installation den Host freigeben: über die Umgebungsvariable [`APP_INTEGRATION_ALLOWED_HOSTS`](/konfiguration#integrationen), z. B. `APP_INTEGRATION_ALLOWED_HOSTS=chat.intern`. Freigegebene Hosts dürfen auch `http://` und einen anderen Port nutzen (z. B. `http://mattermost:8065/hooks/…`). Wende dich dafür an den Betreiber; als Owner kannst du die Freigabe nicht selbst setzen.

## So sieht eine Nachricht aus

QuickTribe nutzt das Slack-kompatible Format von Mattermost mit einem farbigen Anhang: blau für Informationen, orange für „wartet auf das Team“, rot für Warnungen. Der Titel verlinkt auf die passende Seite in QuickTribe, darunter stehen Text, Felder und die Fußzeile mit Community und Zeit. Namen aus der Community erscheinen als reiner Text – Markdown-Zeichen und Erwähnungen wie `@channel` oder `@all` in einem Anzeigenamen lösen nichts aus.

## Typische Fehler

| Meldung in QuickTribe | Ursache | Lösung |
| --- | --- | --- |
| „Mattermost-Webhook-Adressen enthalten /hooks/ …“ | Andere Adresse kopiert (z. B. die des Kanals) | Adresse unter **Integrations → Incoming Webhooks** kopieren |
| „… zeigt in ein internes Netz …“ | Server ist nicht öffentlich erreichbar | Betreiber gibt den Host in `APP_INTEGRATION_ALLOWED_HOSTS` frei |
| Kanal **pausiert – Webhook existiert nicht mehr** | Mattermost meldet „Invalid webhook.“ (Webhook gelöscht – Mattermost antwortet dann mit 400, nicht 404), der Kanal ist gelöscht (404) oder eingehende Webhooks wurden abgeschaltet (501) | Webhook neu anlegen bzw. wieder freischalten, Adresse eintragen oder **Fortsetzen** |
| Name und Bild werden nicht übernommen | Override-Optionen sind aus | System Admin schaltet sie ein (Schritt 1) |

Zur Fehlersuche auf eurem Server hilft **System Console → Logging → Enable Webhook Debugging**.
