From 2304ade651c0fd65986a78f337bad0a968a0f989 Mon Sep 17 00:00:00 2001 From: Nikolay Shaplov Date: Mon, 2 May 2022 19:36:36 +0300 Subject: [PATCH 1/2] Telegram bridging gide fixed: now see difference between group and channel, explain why cannles should not be bridged, and some more improvements --- content/telegram/body.md | 29 +++++++++++++++++------------ 1 file changed, 17 insertions(+), 12 deletions(-) diff --git a/content/telegram/body.md b/content/telegram/body.md index 59ec851..a530d0f 100644 --- a/content/telegram/body.md +++ b/content/telegram/body.md @@ -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. + 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. +2. On Telegram, invite `@matrix_t2bot` to the group then run `/id` to get the group's ID (a long number that starts with `-100`) 3. Back in your Matrix room, say `!tg bridge ` - the bridge should then ask for confirmation. -4. Confirm the bridge and you'll be all set! +4. Confirm the bridge 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 @@ -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. @@ -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. From 4175ad6c09a927948a5ea25a0201e799270f833c Mon Sep 17 00:00:00 2001 From: Nikolay Shaplov Date: Mon, 2 May 2022 19:38:45 +0300 Subject: [PATCH 2/2] Minor fixes --- content/telegram/body.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/telegram/body.md b/content/telegram/body.md index a530d0f..4620e8d 100644 --- a/content/telegram/body.md +++ b/content/telegram/body.md @@ -4,9 +4,9 @@ Your Telegram group can be bridged into Matrix with these steps: 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. -2. On Telegram, invite `@matrix_t2bot` to the group then run `/id` to get the group's ID (a long number that starts with `-100`) -3. Back in your Matrix room, say `!tg bridge ` - the bridge should then ask for confirmation. -4. Confirm the bridge saying `!tg continue` and you'll be all set! +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 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.