45 FAQ
Wim edited this page 2022-04-12 00:02:15 +02:00
This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Something doesnt 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:

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 arent getting relayed

If youre 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 arent deleted on other bridges

Gitter doesnt send delete events to their API, so we cant 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 doesnt 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 hasnt 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, youll need to give your bot the “Manage Roles” permission.

Can I join the bot to a server I dont own?

You need permissions on the server to be able to join the bot, if youre allowed to heres 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 youll 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. 

Replies show the botname instead of the username/avatar

This is a discord limitation: https://github.com/42wim/matterbridge/issues/1558#issuecomment-1030713994 You can do a workaround by setting PreserveThreading=false

Telegram

Matterbridge is not relaying messages from Telegram

See * https://core.telegram.org/bots#privacy-mode * https://github.com/yagop/node-telegram-bot-api/issues/174#issuecomment-244632667

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 its already in it.
  • Invite bot to chat.

The order is important.

Matterbridge is not relay messages from other bots

Bots talking to each other could potentially get stuck in unwelcome loops. To avoid this, we decided that bots will not be able to see messages from other bots regardless of mode.

https://core.telegram.org/bots/faq#why-doesn-39t-my-bot-see-messages-from-other-bots

Matterbridge is not relaying images/stickers/files from Telegram

Because images/stickers/files are from non-public urls, youll 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 doesnt has “deleted messages” metadata, so we dont 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 youre 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 doesnt show the IRC nicks

If youre 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 youre running the login/password version, youll need to: * setting PrefixMessagesWithNick to true in mattermost section of your matterbridge.toml.

Also look at the RemoteNickFormat setting.

Session expire

Use personal access tokens that dont expire https://docs.mattermost.com/developer/personal-access-tokens.html or increase the session timeout, see https://forum.mattermost.org/t/solved-removing-the-session-timeout/3033

Steam

Bridge doesnt seem to work

See https://github.com/42wim/matterbridge/issues/351 and https://support.steampowered.com/kb_article.php?ref=3330-IAGK-7663 Apparently, the account you use needs to make a purchase on Steam for it to work.

Rocket.Chat

Keybase

Edit and deletes not working

Not support by the library we use (https://github.com/keybase/go-keybase-chat-bot/)

Teams

Receiving messages with attachments and images

Not supported by Microsoft API