Request a new Teleirc bridge bot

The Teleirc SIG is responsible for "bridges" between IRC channels and Telegram groups. Fedora community members may request new bridges to connect an IRC channel to a Telegram group. If you are part of a larger sub-community, discuss bridging with your team before making a request.

Create a Telegram bot

First, create a Telegram bot via the Telegram API account (BotFather). The upstream project provides documentation on how to do this. Follow all instructions for the bot to work as expected (note the bot privacy setting). The BotFather gives you a Telegram API token after creating the bot. Later, you will provide this token to the Teleirc SIG.

Note: Whoever creates the Telegram bot is the only person able to make configuration changes to the bot. It is not yet possible to "share" Telegram bots with other users.

Use bot to get Telegram chat ID

Add the bot to the Telegram group you want to bridge to IRC. Once the bot is added, use the Telegram API to retrieve the chat ID of the Telegram group. The chat ID is a unique number specific to your Telegram group.

Instructions on how to retrieve a Telegram chat ID are found on StackOverflow.

Open public ticket with request

Next, open a new issue on the Teleirc SIG infrastructure repository. In your ticket, include the following information:

  • Team / sub-project name

  • IRC channel to bridge to Telegram

  • IRC nicks to ignore on Telegram (e.g. fedmsg bots, if your channel has noisy fedmsg bots)

Send Telegram secrets via email

Finally, send the Telegram secrets in an email to the Teleirc SIG. Include the following in your email:

  • Telegram API token

  • Telegram group chat ID

Send these to the following address:

sysadmin-teleirc-members [at] fedoraproject [dot] org

Updates are posted in the public ticket. The ticket will be closed when the bot is created.

Questions?

If you have questions or need additional assistance, ask in the Fedora CommOps IRC channel / group.