> ## 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

> Répondre dans un canal public Mattermost avec un compte bot

Mattermost permet à l'assistant de répondre dans un canal public de votre serveur ou de Mattermost Cloud. L'équipe écrit dans town square, l'assistant répond dans ce canal, et le fil est conservé dans l'historique.

## Quand l'utiliser

Utilisez-le pour un canal d'aide interne ou une salle d'ops déjà sur Mattermost. Les webhooks sortants partent des canaux publics. Un message direct ou un canal privé n'envoie pas ce webhook.

## Ce que l'assistant entend

L'assistant entend les messages qui correspondent au webhook sortant : un canal public, un ou plusieurs mots déclencheurs, ou les deux. Le compte bot publie la réponse. Invitez le bot dans ce canal.

## Où trouver les clés

Le guide du fournisseur lié montre les écrans de ces clics. Suivez les clics ci-dessous avec ces images.

Deux valeurs sont nécessaires. Le jeton du bot se crée dans **Integrations → Bot Accounts** et ne s'affiche qu'une fois. Le jeton du webhook sortant est le **Token** de la page du webhook, pas un secret de signature séparé. Écrans officiels : [Bot accounts](https://docs.mattermost.com/developers/integrate/reference/bot-accounts) et [Outgoing webhooks](https://docs.mattermost.com/developers/integrate/webhooks/outgoing).

## Le créer chez le fournisseur

1. Dans **System Console → Integrations → Bot Accounts**, activez **Enable Bot Account Creation**. Un serveur auto-hébergé laisse cette option désactivée tant qu'un admin ne l'active pas.
2. Menu produit → **Integrations → Bot Accounts → Add Bot Account**. Copiez le jeton tout de suite.
3. Invitez le bot dans le canal public.
4. Dans **System Console → Integrations → Integration Management**, autorisez les webhooks sortants.
5. Menu produit → **Integrations → Outgoing Webhook → Add Outgoing Webhook**.
6. Choisissez le canal public, des mots déclencheurs facultatifs, et JSON ou formulaire. L'URL de callback se modifie après l'enregistrement.
7. Copiez le **Token** sur la page de confirmation.

## Le connecter dans Famulor

Votre forfait inclut ce canal. Ouvrez **Settings → Channels**, choisissez la carte, nommez la connexion, sélectionnez un assistant et enregistrez. Les paramètres de conversation communs — délai de réponse (5 secondes par défaut) et délai d'inactivité (30 minutes par défaut) — sont décrits sur la page [canaux de messagerie](https://docs.famulor.io/fr/channels/messaging.md).

Sur la carte **Mattermost**, collez l'**Mattermost server URL** publique (HTTPS), le **Bot access token**, et le **Token** du webhook dans **Outgoing webhook token**. **Bot username** est facultatif.

Après l'enregistrement, ouvrez le menu de la connexion et choisissez **Copy webhook URL**. Collez cette adresse exacte chez le fournisseur. Un domaine personnalisé vérifié fait déjà partie de l'adresse affichée.

## Pointer le fournisseur vers Famulor

1. Copiez l'URL de webhook Famulor.
2. Modifiez le webhook sortant Mattermost et mettez cette adresse comme URL de callback.
3. Écrivez dans le canal public, ou commencez par le mot déclencheur. La réponse apparaît dans le canal et dans l'historique.

## Historique

Ouvrez l'[historique](https://docs.famulor.io/fr/monitoring/history.md) et filtrez par **Mattermost**. Le fil, la réponse de l'assistant et l'analyse éventuelle y apparaissent. Vous pouvez mettre l'assistant en pause et répondre vous-même.

## API, MCP et ligne de commande

La même connexion se crée avec l'API publique, l'outil MCP `create_messaging_connector` ou la ligne de commande. Remplacez les exemples par vos propres valeurs.

```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.