Skip to main content

Telegram

The Telegram Bridge allows you to link Matrix rooms with Telegram chats. Users who are active on Matrix can also communicate with participants in Telegram without using the Telegram app directly.This also creates seamless integration in groups where individual members are in Telegram or Matrix, for example, and allows you to collaborate across different platforms.

Our Matrix-Bridges Beta is running!

Thank you for your understanding that temporary outages may still occur, especially in the early days.

We are currently hosting the Telegram Bridge from mautrix.## Features of the bridge

Features of the bridge​

Features

You can find the official feature list at Mautrix.

Here is a selection of the central functions:> 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
  • Changing group memberships M↔T
  • Pinning messages M↔T
  • Profile pictures of users M↔T
  • Typing notifications M↔T
  • Synchronize message history T→M
  • Change chat room metadata (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) T↔M
  • Messages from unauthenticated Matrix users via relay bot M→T

Prerequisites​

To use the Telegram Bridge, you must fulfill the following requirements:

  • Matrix account on an instance hosted by Ossrox with a booked bridges option
  • Telegram account to be linked to the bridge

Setup​

The setup of the Telegram Bridge is divided into a few points:

  • Create a new direct message in Matrix to @telegrambot:bridges.osrx.chat or click here.
  • With help you can display a list of possible Telegram Bridge commands
  • First you have to log in with your Telegram account, you can do this either with your phone number (command login) or by scanning a QR code (login-qr).
  • If you have activated 2-factor authentication in Telegram, you must now send your chosen password. (This will be 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 synchronization with Matrix? - Simply leave the chat room. You can also have the room created again later via bot commands, this works via the command create-portal.
  • How can I delete all Telegram chats in Matrix? - Send logout to the Telegram Bridge Bot. You will then be automatically removed from all Telegram chats 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, even with groups of up to 1000 members. The last 100 messages are loaded. For further chats, a room is automatically created with the next incoming message.
  • How long is my data stored? - The Bridges server stores text messages for 24 hours and media data for one year. After that they are deleted. They may still be stored in server backups for a certain period of time, but not readable by us, as the chats themselves are end-to-end encrypted.

Security and data protection​

The security and protection of your personal data is an important and difficult issue 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 Policy: We provide you with the Telegram Bridge as a processor. As the responsible party, you must be familiar with Telegram's data protection regulations and be aware of the data processing. 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 data protection levels.
  • Encryption**: Although messages within Matrix are protected via end-to-end encryption, the protection provided by Telegram does not necessarily correspond to the same level.

Questions / comments / hints​

Something missing in this guide? Please let us know!