​

Mattermost

Connect to a self-hosted Mattermost instance. Since Mattermost is self-hosted, all data stays within your infrastructure — combined with Pawz’s local-first architecture, no data ever leaves your network.

​

Setup

1. In your Mattermost admin panel, go to Integrations → Bot Accounts and create a bot
2. Copy the bot token
3. In Pawz, go to Settings → Channels
4. Select Mattermost
5. Enter:
   • Server URL — e.g., https://mattermost.yourcompany.com
   • Bot token — from Mattermost admin
6. Start the channel

​

Configuration

​

Connection

Pawz connects via Mattermost’s WebSocket API for real-time message delivery. The bot authenticates using the bot token and listens for new posts in channels it’s been added to, as well as direct messages.

​

Features

• DMs and channel messages via WebSocket (real-time, no polling)
• Thread support — replies stay in the correct thread context
• Per-user sessions with persistent memory across conversations
• Prompt injection scanning on all incoming messages
• Agent routing via channel routing rules — different agents for different channels
• Channel-specific context — lean context strategy for fast, low-cost responses

​

Troubleshooting

​

Tips

:::tip

• Self-hosted = full control — Mattermost runs on your infrastructure, matching Pawz’s privacy-first approach.
• Use channel routing to assign different agents to different Mattermost channels (e.g., #dev → coding agent, #support → customer agent).
• Bot tokens don’t expire — unlike user sessions, bot tokens remain valid until explicitly revoked. :::