1. Eingehende Webhooks freischalten (System Admin)
Eingehende Webhooks muss ein System Admin einmal für den Server erlauben:- Öffne System Console → Integrations → Integration Management.
- Setze Enable incoming webhooks auf True und speichere.
- 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
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
- Ö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.
- Wähle Incoming Webhooks → Add Incoming Webhook.
- 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.
- Klicke Save. Mattermost zeigt die Adresse an, z. B.
https://chat.example.org/hooks/xxxxxxxxxxxxxxxxxxxxxxxxxx. Kopiere sie und schließe mit Done.
Behandle die Adresse wie ein Passwort – wer sie kennt, kann in den Kanal posten.
3. In QuickTribe eintragen
- Öffne Einstellungen → Integrationen und klicke auf Kanal hinzufügen → Mattermost.
- Gib einen Namen ein und füge die Webhook-Adresse ein. Sie muss mit
https://beginnen und/hooks/enthalten. - 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.
- Wähle Ereignisse, Sprache und Zeitzone, Speichern und Testnachricht senden.
Mattermost im internen Netz
QuickTribe stellt aus Sicherheitsgründen nur an öffentlich erreichbare Adressen überhttps:// 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, 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
Zur Fehlersuche auf eurem Server hilft System Console → Logging → Enable Webhook Debugging.