Skip to main content
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: 
[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.