๐ŸŒŸ Mattermost & kChat Integration

Updated today

โ€ข

3 min read

Connect your Perfect Wiki knowledge base with Mattermost or Infomaniak kChat to get instant AI answers from your internal docs - right where your team is already communicating. The integration works with any Mattermost-compatible chat via a standard slash command, no plugins or add-ons required.

๐ŸŒŸ Mattermost & kChat Integration

Why Integrate Perfect Wiki with Mattermost / kChat?

  • Ask questions in plain language and get AI-generated answers from your wiki, without leaving the chat
  • Every answer includes references to the source pages, so your teammates can open them and continue reading in Perfect Wiki
  • Answers are posted to the channel, so the whole team benefits from the question
  • Works with any Mattermost-based platform: self-hosted Mattermost, Mattermost Cloud, Infomaniak kChat and others

How do I connect Perfect Wiki to Mattermost / kChat?

๐ŸŒŸ Mattermost & kChat Integration
  1. Get your API token. Open the Perfect Wiki admin panel, select your knowledge base, go to the API Access section and generate (or copy) your API token.
  2. Create a slash command. In Mattermost / kChat open Main Menu โ†’ Integrations โ†’ Slash Commands โ†’ Add Slash Command.
  3. Fill in the form. You can use these recommended values:
TitlePerfect Wiki
DescriptionInstant AI answers from your Perfect Wiki knowledge base
Command Trigger Wordask
Request URLhttps://api.perfectwiki.xyz/integrations/mattermost/[API_TOKEN]
(replace [API_TOKEN] with the token from step 1)
Request MethodPOST
Response UsernamePerfect Wiki
Response Iconhttps://app.perfectwiki.xyz/logo.png
AutocompleteEnabled
Autocomplete Hint[your question in natural language]
Autocomplete DescriptionAsk your company knowledge base and get an AI answer with links to source pages

4. You're done! Save the slash command and try it out:

/ask What is the wi-fi password?

Perfect Wiki will post an AI-generated answer to the channel, together with a "Related pages" list linking to the wiki pages the answer is based on.

โš ๏ธ Keep your API token secret

The Request URL contains your API token. Anyone who knows this URL can query your knowledge base, so treat the whole URL like a password: do not share it, do not post it in public channels, and do not show it to anyone outside your team. If you think the token has leaked, regenerate it in the API Access section - the old URL will stop working immediately.

FAQ

Can I connect several knowledge bases?

Yes! Create as many slash commands as you want - for example /ask_hr for your HR knowledge base and /ask_it for your IT knowledge base. Just use a different API token (from the corresponding knowledge base) in each command's Request URL.

Does it support conversation context?

No. Each slash command answers exactly one question and does not know anything about the previous ones - this is a limitation of how slash commands work. Simply include all the details in a single question.

How do I disable the integration?

Regenerate the API token in Perfect Wiki (knowledge base โ†’ API Access). The integration will stop working immediately. You can also delete the slash command in Mattermost / kChat.

Do these questions count towards my AI query limit?

Yes. Every question asked through the slash command counts as one AI query in your Perfect Wiki plan, the same as questions asked in the Perfect Wiki app.

Need Help?

If you need assistance, feel free to contact us at [email protected] - we're happy to help you get set up.

Was this page helpful?