Telegram

Telegram is an instant messenger app that allows other applications to send messages via a webhook. This functionality is used to allow users to recieve 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.

#Telegram Alerts | https://github.com/GameServerManagers/LinuxGSM/wiki/Telegram
telegramalert="on"
telegramtoken="401319987:AAGmgLWzYDprqkMHBjCT9qtzIRWCzqgoTLw"
telegramchatid=""

Telegram Group

Use this step If you want to send alerts to a group. If not skip to retrieve 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.

View group info -> Add Members.

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.

```text
https://api.telegram.org/botXXXXXXXXX:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/getUpdates
Look for text `LINUXGSM` in the message and find the `chat id` part of that message.

"chat":{"id":-191537238,

The number given is the chat id
> note: A group number includes a dash in the chat id e.g `-191537238`
Add the chat id to the [LinuxGSM config](../configuration/linuxgsm-config.md).
```text
## Telegram Alerts | https://github.com/GameServerManagers/LinuxGSM/wiki/Telegram
telegramalert="on"
telegramtoken="401319987:AAGmgLWzYDprqkMHBjCT9qtzIRWCzqgoTLw"
telegramchatid="-191537238"

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.

./gameserver test-alert