Skip to content

Latest commit

 

History

History
76 lines (48 loc) · 2.69 KB

README.rst

File metadata and controls

76 lines (48 loc) · 2.69 KB
Raw

Telegram Groups Bridge

https://pepy.tech/badge/simplebot_tggroups

A SimpleBot plugin that allows to bridge Telegram and Delta Chat groups.

For channel subscriptions use: https://github.com/simplebot-org/simplebot_tgchan

Installation

To install run:

pip install simplebot-tggroups

To convert Delta Chat voice messages to mp3 before sending them to the Telegram side, pydub is used, you might need to install ffmpeg in your system, check: https://github.com/jiaaro/pydub#dependencies, for example to install it in an apt-based system:

sudo apt install ffmpeg

Configuration

See https://github.com/simplebot-org/simplebot to know how to configure the bot with an e-mail account.

Before you start using the bot, you need to get your own API ID and hash, go to https://my.telegram.org, you also need a bot token, got to @BotFather on Telegram and create a bot, then to set API ID, API hash and bot token, execute:

simplebot -a bot@example.com telegram

After configuration you can start the bot:

simplebot -a bot@example.com serve

Then you can start bridging Telegram and Delta Chat groups, send /help to the bot in Delta Chat for more info.

To bridge a Telegram group to a Delta Chat group:

  1. Add the bot in Telegram to your group.
  2. Send /id command in the Telegram group, copy the ID returned by the bot.
  3. Add the bot in Delta Chat to your group.
  4. Send /bridge 1234 where 1234 is the group ID obtained in the Telegram group.
  5. Then all messages sent in both groups will be relayed to the other side.

Tweaking Default Configuration

You can tweak the maximum size (in bytes) of attachments the bot will bridge:

simplebot -a bot@example.com telegram --max-size 5242880

By default the bot will download attachments of up to 5MB.