Telegram Bot

The Telegram Bot lets you control RTILA X from your phone. Instead of sitting at your computer to run automations, check status, or download results, you simply open Telegram on your phone and send a command. It’s like having a remote control for your web automation.

The bot can:

• List your projects and run them
• Check the status of running automations
• View execution logs from your phone
• Download results (scraped data) directly to your phone
• Send notifications when runs start and complete
• Chat with the AI Assistant via Telegram

What the Telegram Bot Does

The Telegram Bot is a bridge between your phone and RTILA X. It runs inside RTILA X and communicates with Telegram’s servers. When you send a command to the bot on Telegram, RTILA X processes it and sends back the result.

Capability	Description
Run projects	Start any automation project from your phone
Check status	See which projects are currently running
View logs	Read execution logs from your phone
Download results	Download scraped data files to your phone
Notifications	Get notified when runs start, complete, or fail
AI Assistant	Chat with the AI Assistant directly from Telegram

Setup Overview

Setting up the Telegram Bot takes about 5 minutes:

1. Create a bot via Telegram’s @BotFather.
2. Get your bot token.
3. Find your Chat ID.
4. Enter the token and Chat ID in RTILA X.
5. Enable the bot.

Let’s walk through each step.

Step 1: Create a Bot via @BotFather

@BotFather is Telegram’s official bot for creating and managing other bots. You’ll use it to create your RTILA bot.

Instructions

1. Open Telegram on your phone or computer.
2. Search for @BotFather (it has a blue verification badge).
3. Click Start or type /start.
4. Type /newbot.
5. BotFather asks for a name for your bot. This is the display name users see. For example: My RTILA Bot.
6. BotFather asks for a username for your bot. This must end in bot. For example: my_rtila_bot or MyRtilaBot.
7. BotFather creates your bot and gives you an HTTP API Token.

The token looks like this:

7123456789:AAH1b2C3d4E5f6G7h8I9j0K1l2M3n4O5p6Q

Important: Keep this token secret. Anyone with the token can control your bot. Don’t share it publicly.

Step 2: Get Your Chat ID

Your Chat ID is a unique number that identifies your Telegram account. The bot needs this to know where to send responses and notifications.

How to Find Your Chat ID

The easiest way is to let RTILA X detect it automatically:

1. Start a conversation with your new bot on Telegram (search for its username and click Start).
2. Send any message to the bot (e.g., /start).
3. In RTILA X, a prompt appears asking you to authorize this user.
4. Click Approve.
5. Your Chat ID is automatically added to the authorized list.

Manual Chat ID Lookup

If you prefer to find your Chat ID manually:

1. Search for @userinfobot on Telegram.
2. Click Start.
3. The bot replies with your Chat ID (a number like 123456789).

Step 3: Configure in RTILA X

1. Click your profile name in the bottom-left sidebar.
2. Click Preferences.
3. Go to the General tab.
4. Scroll to the Telegram Bot section.
5. Toggle Enable Telegram Bot to On.
6. Paste your Telegram Bot Token in the token field.
7. Enter your Authorized Chat IDs (comma-separated). For example: 123456789 or 123456789, 987654321.
8. Optionally enable:
   • Send Notifications to Telegram — Get notifications when runs start and complete.
   • Enable AI Assistant via Telegram — Chat with the AI from Telegram.
9. Click Test Connection to verify your setup.
10. Save your settings.

Telegram Bot Commands

Once the bot is set up, you can use these commands in Telegram:

Command	Description
/start or /help	Shows the main menu with all available options
/projects	Lists all your automation projects
/status	Shows the status of currently running automations

The Bot Menu

After sending /start, the bot shows a menu with inline buttons:

Button	Action
📁 List Projects	Shows a list of all your projects with buttons for each
🔄 Check Status	Shows running/pending jobs

Project Actions

When you click a project in the list, you see:

Button	Action
▶️ Run Project	Starts the project immediately
📊 View Last Logs	Shows the most recent execution logs
📥 Download Last Results	Downloads the most recent scraped data file
❌ Cancel	Goes back to the project list

Available Commands in Detail

/start and /help

Shows the welcome message and main menu:

🤖 Welcome to RTILA Bot!

📁 List Projects
🔄 Check Status

/projects

Lists all your automation projects. Each project appears as a button you can click to see its actions (Run, Logs, Download).

/status

Shows the current status of all running and pending jobs:

🔄 Running Jobs:

Project: Amazon Product Scraper
Status: Running
Started: 2025-01-15 14:32:00

If no jobs are running:

✅ No projects are currently running.

Running a Project from Telegram

1. Send /projects.
2. Click the project you want to run.
3. Click ▶️ Run Project.
4. The bot confirms: “Project ‘Amazon Product Scraper’ has been queued.”
5. You’ll receive a notification when the run completes.

Viewing Logs from Telegram

1. Send /projects.
2. Click the project.
3. Click 📊 View Last Logs.
4. The bot sends the most recent log entries.

Downloading Results from Telegram

1. Send /projects.
2. Click the project.
3. Click 📥 Download Last Results.
4. The bot sends the most recent result file as a Telegram attachment.

Testing the Connection

After entering your bot token and Chat IDs, test the connection:

1. Click Test Connection in the Telegram Bot settings.
2. RTILA X sends a test message to Telegram’s API.
3. If successful, you’ll see: ✅ “Connection Successful — Shows the bot name and username.”
4. If it fails, you’ll see an error message explaining what went wrong.

Test Result	Meaning	Solution
✅ Connection Successful	Token is valid	You’re good to go
❌ Invalid token	Token is incorrect	Double-check the token from @BotFather
❌ Connection error	Network issue	Check your internet connection

Bot Logs

You can view the bot’s activity log in RTILA X:

1. In the Telegram Bot settings, click View Bot Logs.
2. A modal opens showing the bot’s recent activity.
3. Each log entry shows a timestamp and a message.
4. Click Clear Logs to clear the log history.

Bot logs show events like:

• Bot started/stopped
• Commands received from Telegram
• Project runs triggered via Telegram
• Errors encountered

Security

Authorized Chat IDs

The Telegram Bot only responds to authorized Chat IDs. This means:

• Only users whose Chat IDs are in the authorized list can use the bot.
• Anyone else who messages the bot gets no response.
• You can authorize multiple users by entering their Chat IDs separated by commas.

Authorization Flow

When an unauthorized user messages your bot:

1. RTILA X detects the message.
2. A prompt appears in RTILA X: “User [Name] (@username) is trying to use your bot. Chat ID: 123456789. Do you want to authorize this user?”
3. You can click Approve to add them to the authorized list, or Deny to reject them.

Security Best Practices

Practice	Why It Matters
Only authorize trusted users	Anyone authorized can run your automations and access your data
Keep your bot token secret	The token controls the bot. If compromised, regenerate it via @BotFather.
Review authorized users regularly	Remove users who no longer need access
Don’t share the bot username publicly	Prevents random people from finding and messaging your bot
Use notifications	Notifications tell you when runs are triggered, so you can detect unauthorized use

Notifications via Telegram

When Send Notifications to Telegram is enabled, RTILA X sends notifications to your authorized Telegram chats:

Event	Notification
Project run starts	“Project ‘Amazon Product Scraper’ has started.”
Project run completes	“Project ‘Amazon Product Scraper’ completed successfully.”
Project run fails	“Project ‘Amazon Product Scraper’ failed.”
Trigger chain run starts	“Trigger chain ‘Data Pipeline’ has started.”
Trigger chain completes	“Trigger chain ‘Data Pipeline’ completed successfully.”

Notifications are sent to all authorized Chat IDs.

AI Assistant via Telegram

When Enable AI Assistant via Telegram is enabled, you can chat with the AI Assistant directly from Telegram. Any message that isn’t a recognized command is sent to the AI Assistant.

Example Conversation

You: Scrape all product names and prices from https://example.com/products

RTILA Bot: I'll analyze the page and create a project for you.
[AI analyzes the page and generates a project configuration]

You: Run the project

RTILA Bot: Project 'Example Products Scraper' has been queued.

What You Can Do via AI

• Describe what you want to scrape, and the AI builds the project
• Ask questions about your existing projects
• Get help with selectors and commands
• Modify existing projects

Bot Status in the UI

The bot’s status is shown in the RTILA X interface:

Status	Meaning
Running	The bot is active and listening for Telegram messages
Stopped	The bot is not running
Error	The bot encountered an error (check logs)

The status is shown in the Telegram Bot settings section in Preferences.

Troubleshooting

Problem	Cause	Solution
Bot doesn’t respond	Bot is not enabled	Enable the Telegram Bot in Preferences
Bot doesn’t respond	Token is incorrect	Verify the token from @BotFather
Bot doesn’t respond	Chat ID not authorized	Add your Chat ID to the authorized list
“Invalid token” error	Token is wrong or bot was deleted	Create a new bot via @BotFather
Bot responds but commands don’t work	Bot token is for a different bot	Verify you’re messaging the correct bot
No notifications received	Notifications disabled	Enable “Send Notifications to Telegram”
AI Assistant doesn’t respond	AI Assistant disabled	Enable “Enable AI Assistant via Telegram”
Bot shows “Unauthorized”	Your Chat ID is not in the authorized list	Check the authorization prompt in RTILA X and click Approve
Bot stopped unexpectedly	Network issue or token expired	Check your internet connection and verify the token
Logs show errors	Configuration issue	Check the bot logs in RTILA X for details

Tips and Best Practices

Tip	Why It Matters
Test the connection before relying on it	Verify the setup works before depending on it for critical automations
Authorize only trusted users	Prevents unauthorized access to your automations
Enable notifications	Get alerted when runs complete, so you don’t miss important results
Use the AI Assistant for quick tasks	Build simple automations on the go from your phone
Check bot logs regularly	Catch configuration issues early
Keep your bot token secure	If compromised, regenerate it immediately via @BotFather
Use a dedicated Telegram account for automation	Keeps automation notifications separate from personal messages
Test with a simple project first	Run a basic project via Telegram to verify everything works before relying on it for complex automations