This #howto describes how to setup the Telegram provider included in
If you haven’t already, install the discourse-chat-integration plugin
- Talk to the Telegram “Botfather” and setup a new bot. detailed instructions here
- Make sure to copy the token that the BotFather gives you. It will look something like this:
In your site settings, paste the token you got earlier into the
chat integration telegram access tokensetting, and save it
chat_integration_telegram_enabledsetting, and save it
Go to the Plugins tab, then Chat Integrations
Go to the Telegram tab
Note: if the Telegram tab is not visible, it means something went wrong when connecting to their API. You should check your site logs, then try again by re-enabling the
- Note: if the Telegram tab is not visible, it means something went wrong when connecting to their API. You should check your site logs, then try again by re-enabling the
Adding a channel
Add your bot to a group chat on telegram (or just start a private chat with it)
You should receive a message like this
Copy the Chat ID. If there’s a minus sign before it, make sure to include it - it’s very important!
Go to your discourse admin panel, Plugins , Chat Integrations , Telegram
Click Add Channel
Enter a name for the channel (this is only displayed in the discourse admin panel, it can be anything)
Paste the Chat ID from earlier into the box, then click Save Channel
Use the Test button on the channel you just created to check that everything’s working. You should see something like this:
Setup some “Rules” for your channel, according to the discourse-chat-integration instructions.
Enjoy all the notifications
Using in a broadcast channel
To send notifications to a telegram broadcast channel, add the bot as a channel administrator, and then send the message
to obtain the chat ID. Then follow the instructions above to set up on Discourse.
In a broadcast channel you cannot use slash commands to manage rules.
You can use “slash commands” to control rules from Telegram. Check that the
chat integration telegram enable slash commands site setting is enabled. Note that this gives anyone who can post in the group chat permission to edit the rules.
To learn how to use them, just send
/help@my-forum-bot if in a group chat) and the bot will send you a help message.
Setting up command auto-complete (not necessary, but makes it much easier to use)
- Talk to the Telegram BotFather
- Select your bot, click edit bot, then edit commands
- Copy and paste this list of commands in
watch - [category] [tag:name] | notify this channel for new topics and new replies matching rule follow - [category] [tag:name] | notify this channel for new topics matching rule mute - [category] [tag:name] | block notifications to this channel for posts matching rule remove - [rule number] | remove a rule (see /status for numbers) status - list all rules for this channel help - display a help message
- You should get a success message
Other bot customisations
Talk to the Telegram BotFather to customise the name, description and icon for your bot. You should leave “Group Privacy” enabled, otherwise the bot will try and respond to every single message in a group chat.