RdpGuard Custom Actions and Telegram Integration

• Telegram Integration Overview
• How to create a Telegram bot
• Sending messages to a Telegram chat
• Sending messages to a Telegram channel

Telegram is a popular messaging app that allows you to send messages, photos, videos, and files to your contacts. You can also create Telegram Bots and Channels to send messages to multiple users.

RdpGuard can send notifications to your Telegram chat or channel using the Telegram Bot API.

To send messages to a Telegram chat or channel, you need to create a new Telegram Bot and obtain the API Token. You also need to know the Chat ID of the chat or the Channel ID of the channel you want to send messages to.

To help you get started, we have prepared a step-by-step guide on how to create a new Telegram Bot, obtain the API Token, and get the Chat ID and Channel ID.

You can use the obtained API Token, Chat ID, and Channel ID to configure the Send Telegram message action in RdpGuard.

Create your bot using @BotFather, Telegram's official bot for creating and managing bots.

1. Open Telegram and search for @BotFather. Choose the verified account, as shown below.

   

2. Open the chat with BotFather and click Start.

   

3. Send /newbot to create a new bot.
4. Choose a name for your bot.
5. Choose a unique username ending in bot.
6. Copy the API Token provided by BotFather.

Keep your API Token secure and do not share it with anyone.

Use a private chat with your bot to receive notifications in your own Telegram account. RdpGuard can retrieve the Chat ID for you.

1. Open your bot in Telegram, click Start, and send it a message.

   

2. Run RdpGuard Dashboard as administrator. Open Tools, Custom Actions / Notifications and click Add.
3. Choose an Event, such as IP Blocked, and select Send Telegram message in the Task field.

4. Paste the token from BotFather into Bot token and click Get chats.

   

5. Select your chat in the Chat list. Edit the Message if needed; you can use the custom action variables to include the IP address, user name, and other event details.
6. Click Run test and confirm to send a test message to the selected chat.

7. Keep Enable this custom action checked and click Add action.

   

8. Click Save changes in the Custom Actions dialog.

If you see No chats found or your chat is missing, send a new message to your bot and click Get chats again. RdpGuard finds chats in the bot's recent updates, which Telegram keeps for no more than 24 hours. Once the action is saved, you do not need to send daily messages to keep receiving notifications.

Use a Telegram channel to share RdpGuard notifications with multiple subscribers. Add your bot as an administrator with permission to post messages, then select the channel in RdpGuard. You can use an existing channel or create a new one below.

To create a new Telegram channel:

1. Open the Chats tab in Telegram and click New Message.

   

2. Click New Channel.

   

   If Telegram displays an introduction, click Create Channel.

   

3. Choose a name for your channel and click Next.

   

4. Choose the privacy settings for your channel and click Next.

   

To add your bot as a channel administrator:

1. Open your channel from the Chats tab.

   

2. Click the channel name to open its settings.

   

3. Click Administrators.

   

4. Click Add Admin.

   

5. Search for your bot and select it.

   

6. Allow Post Messages and click Add Admin.

   

Publish a new message in the channel so RdpGuard can find it.

To configure channel notifications in RdpGuard:

1. Run RdpGuard Dashboard as administrator. Open Tools, Custom Actions / Notifications and click Add.
2. Choose an Event and select Send Telegram message in the Task field.

3. Paste your bot token into Bot token and click Get chats.

   

4. Select your channel in the Chat list and enter the notification Message.
5. Click Run test and confirm to send a test message to the channel.

6. Keep Enable this custom action checked and click Add action.

   

7. Click Save changes in the Custom Actions dialog.

If the channel is missing, check that your bot is an administrator with permission to post messages. Publish a new channel message and click Get chats again.