> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Mattermost

> Einen öffentlichen Mattermost-Kanal mit einem Bot-Account beantworten

Mattermost lässt den Assistenten einen öffentlichen Kanal auf eurem eigenen Server oder in Mattermost Cloud beantworten. Ein Team schreibt in Town Square, der Assistent antwortet dort, und der Thread liegt im Verlauf.

## Wann du ihn nutzt

Nutze ihn für einen internen Hilfe-Kanal oder einen Ops-Raum, der schon auf Mattermost läuft. Outgoing Webhooks feuern in öffentlichen Kanälen. Eine Direktnachricht oder ein privater Kanal sendet diesen Webhook nicht.

## Was der Assistent hört

Der Assistent hört Beiträge, die zum Outgoing Webhook passen: ein öffentlicher Kanal, ein oder mehrere Auslösewörter oder beides. Der Bot-Account schreibt die Antwort. Lade den Bot in diesen Kanal ein.

## Woher die Schlüssel kommen

Die verlinkte Anbieter-Anleitung zeigt die Bildschirme zu diesen Klicks. Folge den Klicks unten zusammen mit diesen Bildern.

Zwei Werte sind nötig. Das Bot-Access-Token entsteht unter **Integrations → Bot Accounts** und wird einmal angezeigt. Das Outgoing-Webhook-Token ist das **Token** auf der Webhook-Seite, kein separates Signing-Secret. Offizielle Bildschirme: [Bot accounts](https://docs.mattermost.com/developers/integrate/reference/bot-accounts) und [Outgoing webhooks](https://docs.mattermost.com/developers/integrate/webhooks/outgoing).

## Beim Anbieter anlegen

1. Schalte unter **System Console → Integrations → Bot Accounts** **Enable Bot Account Creation** ein. Self-hosted Server lassen das aus, bis ein Admin es einschaltet.
2. Produktmenü → **Integrations → Bot Accounts → Add Bot Account**. Kopiere das Token sofort.
3. Lade den Bot in den öffentlichen Kanal ein.
4. Erlaube unter **System Console → Integrations → Integration Management** Outgoing Webhooks.
5. Produktmenü → **Integrations → Outgoing Webhook → Add Outgoing Webhook**.
6. Wähle den öffentlichen Kanal, optionale Auslösewörter und JSON oder Formular als Inhaltstyp. Die Callback-URL kannst du nach dem Speichern ändern.
7. Kopiere das **Token** auf der Bestätigungsseite.

## In Famulor verbinden

Dein Plan enthält diesen Kanal. Öffne **Settings → Channels**, wähle die Karte, benenne die Verbindung, wähle einen Assistenten und speichere. Die gemeinsamen Konversationseinstellungen — Antwortverzögerung (Standard 5 Sekunden) und Inaktivitätszeit (Standard 30 Minuten) — stehen auf der Seite [Messaging-Kanäle](https://docs.famulor.io/de/channels/messaging.md).

Füge auf der Karte **Mattermost** die öffentliche **Mattermost server URL** (HTTPS), das **Bot access token** und das Webhook-**Token** in **Outgoing webhook token** ein. **Bot username** ist optional.

Öffne nach dem Speichern das Menü der Verbindung und wähle **Copy webhook URL**. Füge genau diese Adresse beim Anbieter ein. Eine verifizierte eigene Domain ist in der angezeigten Adresse bereits enthalten.

## Den Anbieter auf Famulor zeigen lassen

1. Kopiere die Famulor-Webhook-URL.
2. Bearbeite den Mattermost Outgoing Webhook und setze diese Adresse als Callback-URL.
3. Schreibe im öffentlichen Kanal oder beginne mit dem Auslösewort. Die Antwort erscheint im Kanal und im Verlauf.

## Verlauf

Öffne den [Verlauf](https://docs.famulor.io/de/monitoring/history.md) und filtere nach **Mattermost**. Der Thread, die Antwort des Assistenten und eine vorhandene Auswertung erscheinen dort. Du kannst den Assistenten pausieren und selbst antworten.

## API, MCP und Kommandozeile

Dieselbe Verbindung lässt sich über die öffentliche API, das MCP-Tool `create_messaging_connector` oder die Kommandozeile anlegen. Ersetze die Platzhalter durch deine eigenen Werte.

```bash theme={null}
famulor create-messaging-connector --platform mattermost --name "Support" \
  --assistant-id ASSISTANT_UUID --base-url https://mattermost.example.com --bot-token BOT_TOKEN --webhook-secret OUTGOING_TOKEN --bot-username famulor-bot
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.