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

> Responder en un canal público de Mattermost con una cuenta bot

Mattermost permite que el asistente responda en un canal público de vuestro servidor o de Mattermost Cloud. El equipo escribe en town square, el asistente responde en ese canal y el hilo queda en el historial.

## Cuándo usarlo

Úsalo para un canal interno de ayuda o una sala de operaciones que ya funciona en Mattermost. Los webhooks salientes se disparan en canales públicos. Un mensaje directo o un canal privado no envía este webhook.

## Qué oye el asistente

El asistente oye publicaciones que coinciden con el webhook saliente: un canal público, una o más palabras de activación, o ambas. La cuenta bot publica la respuesta. Invita al bot a ese canal.

## Dónde conseguir las claves

La guía del proveedor enlazada muestra las pantallas de estos clics. Sigue los clics de abajo junto con esas imágenes.

Hacen falta dos valores. El token de acceso del bot se crea en **Integrations → Bot Accounts** y se muestra una sola vez. El token del webhook saliente es el **Token** de la página del webhook, no un secreto de firma aparte. Pantallas oficiales: [Bot accounts](https://docs.mattermost.com/developers/integrate/reference/bot-accounts) y [Outgoing webhooks](https://docs.mattermost.com/developers/integrate/webhooks/outgoing).

## Crearlo en el proveedor

1. En **System Console → Integrations → Bot Accounts**, activa **Enable Bot Account Creation**. Un servidor propio lo deja apagado hasta que un admin lo activa.
2. Menú de producto → **Integrations → Bot Accounts → Add Bot Account**. Copia el token enseguida.
3. Invita al bot al canal público.
4. En **System Console → Integrations → Integration Management**, permite los webhooks salientes.
5. Menú de producto → **Integrations → Outgoing Webhook → Add Outgoing Webhook**.
6. Elige el canal público, palabras de activación opcionales y JSON o formulario. La URL de callback se puede cambiar después de guardar.
7. Copia el **Token** de la página de confirmación.

## Conectarlo en Famulor

Tu plan incluye este canal. Abre **Settings → Channels**, elige la tarjeta, ponle nombre a la conexión, selecciona un asistente y guarda. Los ajustes de conversación compartidos — retraso de respuesta (5 segundos por defecto) e inactividad (30 minutos por defecto) — están en la página de [canales de mensajería](https://docs.famulor.io/es/channels/messaging.md).

En la tarjeta **Mattermost** pega la **Mattermost server URL** pública (HTTPS), el **Bot access token** y el **Token** del webhook en **Outgoing webhook token**. **Bot username** es opcional.

Después de guardar, abre el menú de la conexión y elige **Copy webhook URL**. Pega esa dirección exacta en el proveedor. Un dominio personalizado verificado ya forma parte de la dirección que muestra Famulor.

## Apuntar el proveedor a Famulor

1. Copia la URL de webhook de Famulor.
2. Edita el webhook saliente de Mattermost y pon esa dirección como URL de callback.
3. Escribe en el canal público o empieza con la palabra de activación. La respuesta aparece en el canal y en el historial.

## Historial

Abre el [historial](https://docs.famulor.io/es/monitoring/history.md) y filtra por **Mattermost**. El hilo, la respuesta del asistente y el análisis, si existe, aparecen ahí. Puedes pausar el asistente y responder tú.

## API, MCP y línea de comandos

La misma conexión se crea con la API pública, la herramienta MCP `create_messaging_connector` o la línea de comandos. Sustituye los ejemplos por tus propios valores.

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