Telegram

Search…
​Telegram is an instant messenger app that allows other applications to send messages via a webhook. This functionality is used to allow users to receive alerts about LinuxGSM.
Setup a Telegram Bot
To enable Telegram alerts you need to create your own Telegram Bot.
1.To do this you will need to speak to @BotFather by visiting here.
2.Click start to begin the chat.
BotFather Chat
1.Type /newbot and follow the instructions to create a bot.
new Bot
1.Once complete an API token will be given. Enter the token to the LinuxGSM config.
1
   #Telegram Alerts | https://github.com/GameServerManagers/LinuxGSM/wiki/Telegram
2
​
3
   telegramalert="on"
4
   telegramtoken="401319987:AAGmgLWzYDprqkMHBjCT9qtzIRWCzqgoTLw"
5
   telegramchatid=""
Copied!
Telegram Group
Use this step If you want to send alerts to a group. If not skip to Retrieve the Chat ID.
Setup a New Group
1.Select New Group
2.Give your group a name
3.Select the Bot you just created by typing @ExampleBot.
The bot will now be added to the group.
Use an Existing group
If you are using an existing group, invite the bot to the group.
1
View group info -> Add Members.
Copied!
Retrieve the Chat ID
The chat id is used to identify where the alert is being sent. Each user and group has its own ID.
To obtain the chat id a message must be received by the bot. This will allow it to pick up the chat id
users: send the message LINUXGSM directly to the bot
groups: send the message LINUXGSM to the group
To retrieve the chat id visit the following url, replacing the XXXXX with your bot token from earlier.
1
https://api.telegram.org/botXXXXXXXXX:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/getUpdates
Copied!
Look for text LINUXGSM in the message and find the chat id part of that message.
note: A group number includes a dash in the chat id e.g -191537238
1
The number given is the chat id
2
​
3
> note: A group number includes a dash in the chat id e.g `-191537238`
4
​
5
Add the chat id to the [LinuxGSM config](../configuration/linuxgsm-config.md).
Copied!
The number given is the chat id
A group number might include a dash in the chat id e.g -191537238
1
"chat":{"id":-191537238,
Copied!
Add the chat id to the LinuxGSM config.
1
## Telegram Alerts | https://github.com/GameServerManagers/LinuxGSM/wiki/Telegram
2
​
3
telegramalert="on"
4
telegramtoken="401319987:AAGmgLWzYDprqkMHBjCT9qtzIRWCzqgoTLw"
5
telegramchatid="-191537238"
Copied!
Send Test Alert
Finally, test that everything correctly works by sending a test alert. You will now receive a message from the bot directly or to a chosen group.
1
./gameserver test-alert
Copied!
Custom cURL String
You can add a custom cURL string eg proxy (useful in Russia) in "curlcustomstring"
Slack
Dependencies
Last modified 1yr ago
Export as PDF
Copy link
Contents
Setup a Telegram Bot
Telegram Group
Setup a New Group
Use an Existing group
Retrieve the Chat ID
Send Test Alert
Custom cURL String