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

# Mattermost Integration

> Configure Mattermost bot integrations for Hiroshi gateway communications.

Hiroshi provides native support for connecting to self-hosted Mattermost instances using active HTTP webhooks or web socket messaging configurations.

## ⚙️ Configuration Setup

Enable the integration inside your `~/.hiroshi/config.toml` file:

```toml theme={null}
[mattermost]
enabled = true
server_url = "https://mattermost.yourdomain.com"
bot_token = "your-bot-token-here"
allowed_channels = ["town-square", "dev-ops"]
```

## 🚀 Deployment Steps

1. **Create Bot Account**: Navigate to Mattermost **System Console > Integrations > Bot Accounts** and create a new bot with appropriate read/write channel permissions.
2. **Retrieve Token**: Copy the generated Access Token.
3. **Configure Allowlist**: Add the channel IDs to the `allowed_channels` array to isolate agent access.
4. **Boot Daemon**: Restart the Hiroshi daemon to initialize the listener.