Skip to main content

Mattermost

Prefer guided AI setup?

Instead of following these steps manually, you can use the AI Credential Assistant — describe what you want to connect and the AI will walk you through the setup step by step, tailored to your account.

Overview​

Connect your Mattermost instance to Nirvai to send messages, manage channels, and automate team communications. Mattermost is an open-source, self-hosted messaging platform that serves as a Slack alternative with full data control.

Supported Authentication Methods​

  • Personal Access Token + Host URL - Required

Prerequisites​

  • A Mattermost account
  • Access to a Mattermost server (cloud or self-hosted)
  • Permission to create personal access tokens

Setup Instructions​

Step 1: Enable Personal Access Tokens (Admin Required)​

If you don't see the Personal Access Tokens option, an administrator needs to enable it:

  1. Log in to Mattermost as an admin
  2. Go to System Console > Integrations > Integration Management
  3. Set Enable personal access tokens to true
  4. Go to System Console > User Management > Users
  5. Find the user account that needs to generate tokens
  6. Click Actions > Manage roles
  7. Check Allow this account to generate personal access tokens
  8. Click Save

Step 2: Create a Personal Access Token​

  1. In Mattermost, go to Profile > Security > Personal Access Tokens
  2. Click Create Token
  3. Enter a description (e.g., Nirvai Integration)
  4. Click Save
  5. Copy the Token ID immediately (it won't be shown again)

Step 3: Add to Nirvai​

  1. In Nirvai, create a new Mattermost credential
  2. Paste the Token ID as the Access Token
  3. Enter your Mattermost server URL (e.g., https://your-mattermost.com)
  4. Save the credential

Important Notes​

  • Token security: Treat personal access tokens like passwords
  • Token permissions: Tokens have the same permissions as the user who created them
  • Self-hosted: URL should include the full server address without trailing slash

Features​

Mattermost API enables:

  • Messaging: Send and receive messages
  • Channels: Create and manage channels
  • Users: User lookup and management
  • Files: Upload and share files
  • Webhooks: Create integrations

Troubleshooting​

Cannot Find Personal Access Tokens Option​

  • Contact your Mattermost administrator
  • Tokens may not be enabled for your server
  • Your user may not have permission to create tokens

Token Not Working​

  • Verify you copied the complete token
  • Check if the token has been revoked
  • Ensure the server URL is correct

Cannot Access Certain Channels​

  • Tokens inherit user permissions
  • Verify the user has access to the channels
  • Check if the channel is private

SSL Certificate Errors​

  • For self-signed certificates, check SSL settings
  • Verify the server URL uses the correct protocol (http/https)

Documentation adapted for Nirvai platform

Next Steps​

Got your credential? Connect it to an agent

Use the AI Tool Creator to turn this credential into agent-callable tools. Describe what your agent should be able to do and the AI investigates the API, configures the endpoints, and gives you a reviewable toolkit before saving anything.