feat(mattermost): add Mattermost connector by ad4mou · Pull Request #1466 · getnao/nao

ad4mou · 2026-08-25T12:33:12Z

Summary

Adds Mattermost as a messaging connector, alongside Slack, Teams, Telegram and WhatsApp. Configure a server URL and bot token per project in Settings → Project → Mattermost; the bot holds an outbound connection per project, so no inbound webhook is needed.
Replies in the channel rather than a thread, matching Slack: one message in the channel, follow-up housekeeping in a thread. DMs stay unthreaded.
Answers mentions in channels, and everything in DMs. Follow-ups in an existing conversation don't need a repeat mention.
People are linked to their nao account automatically by their Mattermost email
Feedback is given by reacting 👍/👎 on an answer. Reactions arrive over the existing connection, so no network access back to nao is needed.
A Stop button appears while nao is answering. This needs Mattermost to reach nao over HTTP, so it's off by default with its own optional Callback URL setting, since the address Mattermost uses can differ from the one people use in a browser. Callbacks are verified with a signed token.

Out of scope

Slash commands, file uploads and modals.

github-actions · 2026-08-25T12:39:03Z

🚀 Preview Deployment


URL	https://pr-1466-3b62985.preview.getnao.io
Commit	`3b62985`

⚠️ No LLM API keys configured - you'll see the API key setup flow when trying to chat.

_{Preview will be automatically removed when this PR is closed.}

cubic-dev-ai

All reported issues were addressed across 53 files

_{Reply with feedback, questions, or to request a fix.

Re-trigger cubic}

Bl3f · 2026-08-26T07:54:54Z

 		supersededAt: integer('superseded_at', { mode: 'timestamp_ms' }),
 		versionGroupId: text('version_group_id'),
 		source: text('source', { enum: MESSAGE_SOURCES }),
+		mattermostPostId: text('mattermost_post_id'),


why this here?

This links a Mattermost answer thumbs up/down to its nao message so reaction feedback is saved against the correct message.

Basically, buttons look bad on mattermost, so I wanted to avoid having 2 for thumbs up/down which is why I found a way to store feedback via reactions on the message

I don't think we should do an exception in the data model to put mattermost in the chatMessage table

oh yeah fair enough, but so should we just not have reactions in Mattermost or use the very bad looking buttons?

i did not see the bad looking buttons this morning :/

cubic-dev-ai

All reported issues were addressed across 1 file (changes from recent commits).

_{Tip: Review your code locally with the cubic CLI to iterate faster.

Re-trigger cubic}

Bl3f

a few comments

Bl3f · 2026-08-26T13:49:57Z


 	void pingLicensesServer();
 	void slackService.startSocketModeForAllProjects();
+	void mattermostService.startForAllProjects();


Is it really necessary? shouldn't it be a reactive route instead?

Mattermost’s outgoing webhooks do not provide the full event flow we need, especially DMs, mentions, threads, and reactions.

So we use its WebSocket API. Unlike an HTTP route, that connection must be restored after every backend restart, which is why startForAllProjects() is necessary. Slack does the same for projects using Socket Mode.

Bl3f · 2026-08-26T13:51:43Z

 	return result;
 };

+export const deleteFeedbackVote = async (messageId: string, vote: 'up' | 'down'): Promise<void> => {


How is it handle elsewhere? Why do we need a specific function for this here but not elsewhere in the code?

yeah this is mainly because we used reactions instead of buttons for thumbs up/down.
I'll try to put it back as buttons

cubic-dev-ai

All reported issues were addressed across 12 files (changes from recent commits).

_{Tip: Review your code locally with the cubic CLI to iterate faster.

Re-trigger cubic}

ad4mou · 2026-08-28T18:18:50Z

So I kept 👍/👎 as native Mattermost reactions.
the fix is:
Mattermost sends 👍/👎 reactions to nao through the existing WebSocket. Because each Mattermost post includes its corresponding nao message ID, nao can save the vote directly in the existing feedback table.
This removes the need for a new chat_message column or migration, while keeping the Stop button unchanged.

feat(mattermost): add Mattermost connector

9101a26

ad4mou added 2 commits August 25, 2026 15:30

feat(mattermost): render tables and charts in answers

d3ab856

feat(mattermost): render tables and charts in answers

dd27c27

ad4mou marked this pull request as ready for review August 25, 2026 13:53

cubic-dev-ai Bot reviewed Aug 25, 2026

View reviewed changes

ad4mou added 2 commits August 25, 2026 17:51

Fix(cubic): harden callbacks and integration edge cases

c46b4ad

Fix login command parser bugs

bff7105

Bl3f reviewed Aug 26, 2026

View reviewed changes

ad4mou added 2 commits August 26, 2026 10:39

Unify thread replies behavior. Factorise Code. Cleanup logs

d992b9f

Unify thread replies behavior. Factorise Code. Cleanup logs

184b7a8

cubic-dev-ai Bot reviewed Aug 26, 2026

View reviewed changes

Comment thread apps/backend/src/services/mattermost-helpers.ts

Cleanup LLM's bad decisions

5d9ffa3

Bl3f reviewed Aug 26, 2026

View reviewed changes

ad4mou added 2 commits August 28, 2026 14:39

Cleaner way to store mattermost thumbs up/down

bfb499d

Cleaner way to store mattermost thumbs up/down

5790c85

cubic-dev-ai Bot reviewed Aug 28, 2026

View reviewed changes

Comment thread apps/backend/tests/mattermost-feedback-query.test.ts Outdated

fix(cubic): fix test

3b62985

Uh oh!

Conversation

ad4mou commented Aug 25, 2026 • edited by cubic-dev-ai Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Out of scope

Uh oh!

github-actions Bot commented Aug 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🚀 Preview Deployment

Uh oh!

cubic-dev-ai Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ad4mou Aug 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cubic-dev-ai Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Bl3f left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cubic-dev-ai Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

ad4mou commented Aug 28, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

ad4mou commented Aug 25, 2026 •

edited by cubic-dev-ai Bot

Loading

github-actions Bot commented Aug 25, 2026 •

edited

Loading

cubic-dev-ai Bot left a comment •

edited

Loading

ad4mou Aug 26, 2026 •

edited

Loading

cubic-dev-ai Bot left a comment •

edited

Loading

cubic-dev-ai Bot left a comment •

edited

Loading