Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 18 additions & 13 deletions content/telegram/body.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,16 @@
Your Telegram community can be bridged into Matrix with these steps:
Your Telegram group can be bridged into Matrix with these steps:

1. In your Matrix room (creating one if required), invite [@telegram:t2bot.io](https://matrix.to/#/@telegram:t2bot.io)
and wait for it to join.
2. On Telegram, invite `@matrix_t2bot` to the channel then run `/id` to get the channel's ID.
3. Back in your Matrix room, say `!tg bridge <the number>` - the bridge should then ask for confirmation.
4. Confirm the bridge and you'll be all set!
bot user and wait for it to join.
2. Give [@telegram:t2bot.io](https://matrix.to/#/@telegram:t2bot.io) user moderator privileges in the room, so it can
preform bans, kicks, and message deletion, the way they are done in original telegram group.
3. On Telegram, invite `@matrix_t2bot` to the group then run `/id` to get the group's ID (a long number that starts with `-100`)
4. Back in your Matrix room, say `!tg bridge <the number>` - the bridge should then ask for confirmation.
5. Confirm the bridge by saying `!tg continue` and you'll be all set!

Anything that is said after the bridge has been confirmed will be brought over to the other side. If
you run into any issues with this, visit [#help:t2bot.io](https://matrix.to/#/#help:t2bot.io) on Matrix.

Giving the bridge moderator privileges in Matrix is preferred to ensure that bans, kicks, and
message deletion all continue to work as expected.

If you want to later disconnect the bridge, say `!tg unbridge` in the Matrix room.

The source of the bridge can be inspected [on github](https://github.com/t2bot/mautrix-telegram), though
Expand All @@ -24,7 +23,7 @@ if you're looking to run your own then we recommend [the upstream project](https
Usually this means that the Telegram ID looks a bit weird to the bot. Try running the `/id` command in your Telegram
chat again and copy/pasting the ID (including the `-` (negative) sign) into the command. For example, `!tg bridge -1234`

### 2. How many Telegram channels can I bridge?
### 2. How many Telegram groups can I bridge?

As many as you'd like! The only requirement is that you need to be a moderator/admin of the Telegram chat to bridge it
to Matrix. Repeat the steps above as many times as required to bring all of your communities to Matrix.
Expand All @@ -39,9 +38,15 @@ Make sure the room isn't encrypted, and that the bot has joined the room. If the
not be able to see your messages - you will have to create a new room and try again. If the bot hasn't joined the
room, see Question 3.

### 5. It's working in one direction, but not the other. Help!
### 5. Does bridge support Telegram Channels?

Technically [mautrix-telegram](https://github.com/tulir/mautrix-telegram) that is used for bridging, supports
Telegram Channels (you presumably should add bot as an admin to the channel), but this feature should not be
used with public bridging service due to Telegram limitations. It is strongly recommended to use self-hosted
[mautrix-telegram](https://github.com/tulir/mautrix-telegram) for bridging telegram channels.

Typically this happens when the Telegram side is an announcement channel: the bridge isn't capable of supporting these
very well due to Telegram limitations. If you do have ideas/steps for how this can work, let us know in [#help:t2bot.io](https://matrix.to/#/#help:t2bot.io) so we can update this document.
### 6. It's working in one direction, but not the other. Help!

Otherwise, there may be a permissions issue or a general issue with the bot. Visit [#help:t2bot.io](https://matrix.to/#/#help:t2bot.io) for help.
Typically this happens when you telegram endpoint is a channel, and you should not bridge a channel with [t2bot.io](t2bot.io)
(See above). Otherwise, there may be a permissions issue or a general issue with the bot.
Visit [#help:t2bot.io](https://matrix.to/#/#help:t2bot.io) for help.