Telegram
The Telegram bridge allows you to link Matrix rooms with Telegram chats. Users who are active on Matrix can also communicate with participants on Telegram without using the Telegram app directly. This also creates seamless integration in groups where individual members are on Telegram or Matrix, for example, and allows you to collaborate across different platforms.
We currently host the Telegram bridge from mautrix.
Features of the bridge
You can find the official feature list at mautrix.
Here is a selection of the key features:
Legend:
- M→T Matrix to Telegram
- T→M Telegram to Matrix
- M↔T Bidirectional
- Message content (text, formatting, files, etc.) M↔T
- Edit and delete messages M↔T
- Reactions to messages M↔T
- Group membership changes M↔T
- Pin messages M↔T
- Profile pictures of users M↔T
- Typing notifications M↔T
- Synchronize message history T→M
- Chat room metadata changes (name, topic, avatar) M↔T
- Custom emojis/stickers, polls and games T→M
- Online status M↔T
- Read receipts (T→M only in private chats) M↔T
- Messages from unauthenticated Matrix users via relay bot M→T
Prerequisites
To use the Telegram bridge, you must meet the following requirements:
- Matrix account on an instance hosted by us with the bridges option booked
- Telegram account to be linked to the bridge
Setup
Setting up the Telegram bridge takes just a few steps:
- Start a new direct message in Matrix with
@telegrambot:bridges.osrx.chator click here. - Use
helpto display a list of available Telegram bridge commands. - First, log in with your Telegram account, either with your phone number (command
login) or by scanning a QR code (login-qr). - If you have enabled two-factor authentication in Telegram, send the password you set for it next. It is automatically deleted from the history after verification.
- The Telegram bridge will now start synchronizing your chats. This can take a while depending on the number of current requests. Private chats are usually synchronized and displayed when new messages are received.
FAQ
- How can I exclude individual chats from syncing with Matrix? - Leave the chat room. You can have the room recreated later using the bot command
create-portal. - How can I delete all Telegram chats in Matrix? - Send
logoutto the Telegram bridge bot. You will then be removed from all Telegram chats automatically, and the data will be completely deleted a few days later. - How many chats and messages are synchronized? - Initially, the 15 most recent chats are synchronized, including groups with up to 1,000 members. The last 100 messages are loaded. For other chats, a room is created automatically when the next message arrives.
- How long is my data stored? - The bridge server stores text messages for 24 hours and media data for one year. After that, they are deleted. They may remain in server backups for a certain period of time. Please note: to transfer messages between Matrix and Telegram, the bridge has to decrypt them on the bridge server and process them in plain text. End-to-end encryption ends there, so the data stored on the bridge server is not protected in the same way as with true end-to-end encryption.
Security and data protection
Security and the protection of your personal data are important and sometimes difficult issues when using bridges. The Telegram bridge connects two systems with different data protection guidelines and standards. It is important to consider the following aspects when bridging:
- Privacy policies: We provide you with the Telegram bridge as a processor. As the controller, you must be familiar with Telegram's privacy policy and know how data is processed. By using the Telegram bridge, data will be transferred from one system to another, which affects the applicability of the respective data protection guidelines. Furthermore, data may be transferred to countries with different levels of data protection.
- Encryption: On the Matrix side, chats via the Telegram bridge are always end-to-end encrypted - we enforce this in the bridge configuration. This encryption ends at the bridge: it has to decrypt the messages and process them in plain text in order to transfer them between Matrix and Telegram. From there on, the protection level of Telegram applies, which does not necessarily match that of Matrix.
Requests / comments / notes
Something missing from this guide? Let us know.