Language: 🇺🇸 English | 🇨🇳 简体中文

CoolQ Telegram Bot X is a message forwarding bot. This bot can help to forward messages from one QQ / Telegram group to another. With simple config, you can customize the forwarding logic in a convenient way. Feel free to link between QQ and Telegram, or merge different messages to one place.

CoolQ Telegram Bot X is an integration of QQ Bot and Telegram Bot. CoolQ Message SDK ensures the stability and availability of receiving and sending QQ messages every time. Telegram C++ SDK based on official Telegram Bot API shows its power to handle different kinds of messages. Forwarding logic unit will parse and transfer messages which QQ Bot or Telegram Bot receive to another group according to forward config.

All message SDKs and forwarding logic unit are packed into a CoolQ plugin. Start CoolQ, enable the plugin, and enjoy :)

CoolQ Telegram Bot X supports various forwarding type. No matter QQ to Telegram, or Telegram to QQ, it can parse and transfer messages correctly. Besides, QQ to QQ and Telegram to Telegram message forwarding can help you organize and merge messages from different groups.

In some cases, you may need one-direction forwarding rather than bi-direction forwarding. Don't worry, CoolQ Telegram Bot X is still capable to do it.

You may notice that QQ faces are special characters. CoolQ Telegram Bot X is so smart, converting QQ faces to emoji automatically when sending to Telegram group. In future work, we will support more special message conversion.

Quite easy, just follow these steps:

1. Install CoolQ Main Program.

   For Windows users, please download CoolQ from official website.

   For Linux users, it is recommended to deploy Docker image from coolq/wine-coolq.

2. Download CoolQ plugin and example configuration json file from relesase page.

3. Place the cpk file to CoolQ_Root_Directory/app/ and place the json file to CoolQ_Root_Directory/app/top.jogle.ctbx/config/(You need to make the new directory yourself).

4. Start CoolQ Main Program, enable the plugin.

For more details, please visit the installation guide in repository wiki.

Generally, if you need message sending to / receiving from Telegram groups, a Telegram bot token is needed to fill in config file. Then customize the forwarding rule in config file, you will find the bot works functionally.

For more details, please visit the configuration guide in repository wiki.

The source code is a Visual Studio 2017 project, and requires a compiler supporting C++ 17 standard. Please use Microsoft/vcpkg to install dependencies: boost、libiconv、jsoncpp.

For more details, please visit the development guide in repository wiki.

If you find some trouble in using or developing CoolQ Telegram Bot X, you can join our Support Group (Telegram).

You know, There is a Python version: jqqqqqqqqqq/CoolQ Telegram Bot.

What to choose? In short, the Python version focuses more on new features and extensiblility, but the C++ version cares more on convenience and simple deployment.

CoolQ Telegram Bot X is derived from jqqqqqqqqqq/CoolQ Telegram Bot.

CoolQ Message SDK is based on richardchien/coolq-cpp-sdk

Telegram C++ SDK uses the code from reo7sp/tgbot-cpp