FAQ

Something doesn't work

First, create a basic configuration following https://github.com/42wim/matterbridge/wiki/How-to-create-your-config

Also, read the Features page.

FAQ for:

Slack
Discord
Telegram
Mattermost
Steam
Rocket.Chat
Keybase
Teams

General

Message being skipped

(From https://github.com/42wim/matterbridge/discussions/1566)

Matterbridge does not relay messages from the user account that it is logged in as. Make sure it has its own account.

Slack

Messages come from Slack API tester

Did you set RemoteNickFormat?
Try adding RemoteNickFormat="<{NICK}>"

Messages from other bots aren't getting relayed

If you're using WebhookURL in your Slack configuration, this is normal. If you only have Token configuration, this could be a bug. Please open an issue.

Gitter

Messages deleted on Gitter aren't deleted on other bridges

Gitter doesn't send delete events to their API, so we can't pick those up.
When you delete a message on another bridge Slack, they will be deleted on Gitter though. (matterbridge can delete messages on Gitter, but we do not get an event when a message on Gitter is deleted).

So Slack <=> Gitter bridge, deleting messages when on Gitter doesn't get deleted on Slack.
On the same bridge, deleting messages on slack gets also deleted on Gitter.

Discord

Discord is not getting or receiving messages

Did you specify the correct channel name?
Try using the ID instead of the channel name.

You can find the number in the URL of the channel: https://discordapp.com/channels/number1/number2

Instead of channel="name", set channel="ID:number2".

Also, make sure your bot hasn't been banned from the server for some reason.

Seeing IDs instead of usernames on the other bridges?

If you want roles/groups mentions to be shown with names instead of ID, you'll need to give your bot the "Manage Roles" permission.

Can I join the bot to a server I don't own?

You need permissions on the server to be able to join the bot, if you're allowed to here's how you do it: Click on the bot here: https://discordapp.com/developers/applications/me

Click the "Generate OAUTH" button, copy the URL and paste it into your address bar, open the page and you'll see the drop down menu for adding the bot to any server you have permissions on.

Messages not being edited, but a new message with (edit) appears?

Message editing is not supported by discord using webhooks. If you want message editing, disable webhooks and use token only

Error obtaining server members: HTTP 403 Forbidden

Discord changed its API:

See https://github.com/42wim/matterbridge/wiki/Discord-bot-setup#privileged-gateway-intents for a fix
See https://github.com/42wim/matterbridge/issues/1263 for more info

Do I need to allow inbound connections for webhooks to work

No.

Telegram

Matterbridge is not relaying messages from Telegram

See

If your bot is not getting messages:

Disable privacy mode with @Botfather.

Go to BotFather send /setprivacy.
Select the username of the bot.
Select Disable.
Kick bot from chat if it's already in it.
Invite bot to chat.

The order is important.

Matterbridge is not relaying images/stickers/files from Telegram

Because images/stickers/files are from non-public url's, you'll need to setup a mediaserver

Matterbridge is not relaying messages to Telegram

Did you enable MessageFormat="HTML" in your config?
You could be sending invalid HTML. Set it to MessageFormat=""

More info in https://github.com/42wim/matterbridge/blob/master/matterbridge.toml.sample#L836-L838

Matterbridge is not deleting messages from Telegram to other bridges

Telegram doesn't has "deleted messages" metadata, so we don't know which messages are deleted.

Users are shown as "unknown user"

Telegram channels will always return unknown users. Telegram groups will show usernames if possible

Mattermost

mattermost not sending to other bridges.

Did you create a dedicated account for matterbridge? See https://github.com/42wim/matterbridge/wiki/Section-Mattermost-(basic)

"version not supported error"

By default, matterbridge tries HTTPS to connect to your Mattermost setup.
If you're using a test setup for Mattermost, this will probably listen on HTTP and on port 8065.

Add NoTLS=true and use Server="yourmattermostserver.domain:8065" to your Mattermost configuration.
See also https://github.com/42wim/matterbridge/wiki/Section-Mattermost-(basic)

Mattermost doesn't show the IRC nicks

If you're running the webhooks version, this can be fixed by either:

enabling "override usernames". See mattermost documentation
setting PrefixMessagesWithNick to true in mattermost section of your matterbridge.toml.

If you're running the login/password version, you'll need to: