Platform Overview

AIBotBuilder is an AI-powered platform that enables you to create, deploy, and manage Telegram bots without writing code. This guide covers all major features and how to use them effectively.

🎯 What You Can Do

  • Generate bot commands using AI from plain English descriptions
  • Manage multiple bots from one dashboard
  • Create reusable templates for common bot commands
  • Integrate with OAuth services (Google Drive, Gmail, Calendar)
  • Schedule commands to run automatically
  • Trigger commands via webhooks from external services
  • Manage bot files and workspaces

Platform Architecture

Your bot commands run in isolated microservice containers, automatically managed by our platform:

  • AI Code Generation: Describe what you want, AI generates Python code
  • Automatic Deployment: Code is packaged with dependencies and deployed instantly
  • Microservice Architecture: Each command runs in its own isolated container
  • Auto-Scaling: Resources allocated based on usage
  • Built-in Monitoring: Track executions, errors, and performance

Dashboard

Your dashboard provides an overview of all your bots, commands, and usage statistics.

Key Metrics Displayed

📊 Total Executions

Number of times your commands have been run this month

🤖 Active Bots

Number of bots currently deployed and running

⚡ Commands Available

Total number of commands across all your bots

💎 Current Plan

Your active subscription plan and limits

Creating and Managing Bots

Step 1: Create a Bot on Telegram

  1. Open Telegram and search for @BotFather
  2. Send the command /newbot
  3. Follow the prompts to name your bot
  4. Copy the bot token (looks like: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz)

Step 2: Add Bot to Platform

  1. Navigate to the 'Bots' page in your dashboard
  2. Click the 'Add New Bot' button
  3. Paste your bot token
  4. Give your bot a friendly name and description (optional)
  5. Click 'Save' to register the bot

💡 Bot Settings

After creating a bot, you can configure:

  • Bot Name & Description: For organizational purposes
  • Debug Messages: Show/hide technical progress messages
  • Shard Assignment: Which server shard handles this bot
  • Group Limits: How many Telegram groups can use this bot

Bot Commands

Commands are the heart of your bot. Each command performs a specific action when triggered by users in Telegram.

Viewing Commands

Click on any bot in your dashboard to see its commands. Each command shows:

  • Command Name: The trigger (e.g., /weather)
  • Description: What the command does
  • Status: Enabled/Disabled
  • Type: The command handler type (usually BCIOF - Bot Command in Isolated Function)
  • Execution Count: How many times it's been used
  • Template Source: If created from a template

Command Actions

✏️ Edit Command

View and modify command code, parameters, and settings. Only available for commands you own.

🔄 Enable/Disable

Toggle command availability without deleting it. Disabled commands won't respond to user triggers.

📋 View Details

See command code, dependencies, environment variables, and execution logs.

🗑️ Delete

Permanently remove a command. This action cannot be undone.

Templates

Templates are reusable command blueprints. Create a command once, then deploy it to multiple bots instantly.

Creating a Template

  1. Navigate to the 'Templates' page
  2. Click 'Create Template'
  3. Use the AI command generator to describe what you want
  4. Configure template settings:
    • Template Name: Descriptive name for the template
    • Share Settings: Private, public, or shared between your bots
    • Parameters: Input fields users need to provide
    • Output Type: What the command returns (message, photo, file, etc.)
  5. Review and save the template

Using Templates

To deploy a template to a bot:

  1. Go to your bot's detail page
  2. Click 'Add Command from Template'
  3. Browse or search available templates
  4. Select a template and click 'Deploy'
  5. The command is instantly available in your bot

✨ Template Benefits

  • Deploy proven, tested commands instantly
  • Share commands across multiple bots
  • Marketplace for discovering useful bot commands
  • Version tracking and updates

Environment Variables

Environment variables store configuration values, API keys, and other secrets used by your bot commands.

Variable Types

🔵 Bot Owner Variables

Created by you for your bots. Examples: API keys, custom settings, configuration values.

🔴 System Variables

Platform-wide variables (admin only). Examples: service URLs, platform configuration.

🟣 Global Variables

Shared across all bots (admin only). Examples: common API endpoints, shared resources.

🟠 Command-Scoped Variables

Specific to individual commands. Created during AI command generation.

Creating Variables

  1. Navigate to 'Environment Variables' in your bot's detail page
  2. Click 'Create Variable'
  3. Fill in the details:
    • Name: Variable identifier (e.g., API_KEY)
    • Value: The actual value (sensitive values are encrypted)
    • Data Type: string, number, boolean, json, or file
    • Description: What this variable is used for
    • Optional: Whether commands must provide this value
    • Default Value: Fallback value if not provided
  4. Save the variable

⚠️ Security Best Practices

  • Never hardcode sensitive values in command code
  • Use environment variables for all API keys and secrets
  • Regularly rotate credentials
  • Use descriptive names but don't expose sensitive info in names

OAuth Integration

Connect your bot commands to external services like Google Drive, Gmail, and Calendar using OAuth authentication.

Supported Services

📧 Gmail

Send emails, read inbox, manage labels

📁 Google Drive

Upload files, create folders, share documents

📅 Google Calendar

Create events, check availability, send invites

🔧 Custom OAuth

Add your own OAuth providers with custom credentials

Setting Up OAuth

  1. Navigate to the 'OAuth' page
  2. Select a provider or create a custom one
  3. When creating a command that needs OAuth:
    • Check 'Requires OAuth' in command generation
    • Select which providers the command needs
    • AI will include OAuth authentication in the generated code
  4. Users will be prompted to authorize when they first use the command
  5. Tokens are securely stored and automatically refreshed

🔐 OAuth Flow

  1. User triggers a command requiring OAuth
  2. Bot sends authorization URL to the user
  3. User clicks link and authorizes in their browser
  4. Platform stores access token securely
  5. Command executes with authorized access
  6. Future uses don't require re-authorization

Command Scheduling

Schedule bot commands to run automatically at specific times or intervals using cron expressions.

Creating a Schedule

  1. Go to your bot's 'Schedules' tab
  2. Click 'Create Schedule'
  3. Configure the schedule:
  4. Save and enable the schedule
  • Command: Select which command to run
  • Cron Expression: When to run (e.g., 0 9 * * * for daily at 9 AM)
  • Timezone: Your local timezone
  • Target: Which group or chat to execute in
  • Parameters: Any required input values

Cron Expression Examples

Format: minute hour day month weekday

  • 0 9 * * * - Every day at 9:00 AM
  • */30 * * * * - Every 30 minutes
  • 0 0 * * 0 - Every Sunday at midnight
  • 0 8-17 * * 1-5 - Every hour during business hours (Mon-Fri, 8 AM-5 PM)
  • 0 0 1 * * - First day of every month at midnight

📅 Schedule Use Cases

  • Daily reports sent to your team
  • Hourly data sync from external APIs
  • Weekly reminders and notifications
  • Monthly analytics summaries
  • Real-time monitoring alerts

Webhooks

Trigger bot commands from external services using HTTP webhooks. Perfect for integrations with tools like Zapier, n8n, or custom applications.

Generating Webhook URLs

  1. Open your bot's detail page
  2. Go to the 'Webhooks' tab
  3. Select a command to generate a webhook for
  4. Configure webhook settings:
  5. Copy the generated webhook URL
  • Target Chat: Which Telegram chat receives the result
  • Parameters Mapping: Map webhook payload to command parameters
  • Authentication: Optional API key for security

Using Webhooks

Example: POST request to trigger a command

curl -X POST https://app.telegrambotbuilder.com/api/webhook/abc123 \
  -H "Content-Type: application/json" \\
  -H "X-API-Key: your_api_key" \\
  -d '{
    "param1": "value1",
    "param2": "value2"
  }'

🔗 Webhook Integration Ideas

  • GitHub: Send deployment notifications to your team
  • Stripe: Alert on new payments or subscriptions
  • Custom Apps: Trigger bot actions from your applications
  • IoT Devices: Send sensor data to Telegram
  • Monitoring: Alert on server issues or errors

File Workspace

Each bot command has its own file workspace for storing data, uploading files, and managing resources.

Accessing Workspace

  1. Navigate to your bot's detail page
  2. Click on a command to view details
  3. Go to the 'Workspace' tab
  4. Browse files and folders

File Operations

  • Upload Files: Add files your command needs to access
  • Create Folders: Organize files hierarchically
  • Download Files: Retrieve files generated by your command
  • Delete Files: Remove unnecessary files to save storage
  • View Content: Preview text files directly in browser

Storage Limits

Per-Bot Storage

  • Free: 20MB
  • Basic: 100MB
  • Pro: 300MB
  • Enterprise: 800MB

Shared Command Storage

  • Free: 10MB
  • Basic: 15MB
  • Pro: 20MB
  • Enterprise: 25MB

💾 Workspace Use Cases

  • Store configuration files for your commands
  • Upload images, templates, or data files
  • Cache API responses to reduce external calls
  • Save generated reports or exports
  • Manage static assets for your bot

Membership Plans

Choose the right plan for your needs. All plans include AI command generation and core features.

Plan Comparison

Feature Free Basic Pro Enterprise
Executions/Month 10 2,000 7,000 30,000
Bots Included 1 1 2 4
AI Command Gen
Command Scheduling
Webhook Access

Upgrading Your Plan

  1. Navigate to 'Membership' in the main menu
  2. Review available plans and features
  3. Click 'Upgrade' on your desired plan
  4. Complete payment using Telegram Stars
  5. Your new limits activate immediately

💡 Free Trial

New users get a 7-day free trial of the Enterprise plan. No credit card required. Test all features before committing.

Ready to Build?

Now that you understand the platform, learn how to create powerful bot commands with AI.