# Botlify Cloud Developer Documentation

> Botlify Cloud (https://botlify.cloud) is an enterprise cloud hosting platform and developer studio designed specifically for high-speed Telegram Bots, SQLite databases, and Model Context Protocol (AI MCP) server integrations.

This index is structured for LLMs, AI agents, and code assistants (e.g. ChatGPT, Claude, Cursor, Windsurf, Copilot, Gemini). It contains direct links and summaries for all platform modules, Telegram Bot API 8.x guides, and REST APIs.

## Complete Documentation Bundle

- [Full Documentation in Single Text Format](https://docs.botlify.cloud/llms-full.txt): Complete uncompressed documentation containing all guides, code examples, schemas, and API references.

## Key Documentation Sections

### Getting Started

- [Welcome to Botlify Cloud](https://docs.botlify.cloud/?page=overview): High-performance, zero-config cloud hosting and developer studio for Telegram bots.
- [60-Second Quickstart](https://docs.botlify.cloud/?page=quickstart): Deploy your first Telegram bot from scratch to live production in 60 seconds.
- [Configuring @BotFather](https://docs.botlify.cloud/?page=botfather): Complete guide to setting bot profile photo, descriptions, slash commands, and privacy settings.
- [Obtaining Telegram Admin Chat ID](https://docs.botlify.cloud/?page=admin-chat-id): How to find your numeric User ID and link it to your Botlify account for full administrative control.

### Bot Studio & Development

- [Code Studio & Web IDE](https://docs.botlify.cloud/?page=editor): Edit multi-file codebases in real-time with syntax highlighting, automatic linting, and zero deployment latency.
- [SQLite 3 Studio & Data Explorer](https://docs.botlify.cloud/?page=sqlite-studio): Built-in zero-maintenance relational database engine with visual SQL query console and automatic WAL mode.
- [Automated Cron Scheduler](https://docs.botlify.cloud/?page=cron-jobs): Schedule background workers, reset daily rewards, and send automated notifications without external cron services.
- [Webhook Manager & Test Simulator](https://docs.botlify.cloud/?page=webhook-diagnostics): Simulate Telegram webhook payloads, test logic in-browser, and inspect live execution errors.

### Telegram Bot API (A-Z)

- [Native Commands & [Menu] Button](https://docs.botlify.cloud/?page=commands-menu): Configure slash command autocompletes, admin-only command scopes, and the persistent blue [Menu] button.
- [Animated Message Reactions](https://docs.botlify.cloud/?page=reactions): React to incoming user messages with animated emojis (👍, 🔥, 🎉, ❤️, ⚡) using setMessageReaction.
- [Mandatory Force-Subscribe System](https://docs.botlify.cloud/?page=force-subscribe): Protect bot features by requiring users to join your official Telegram channel or group before proceeding.
- [Telegram Stars & Paid Subscriptions](https://docs.botlify.cloud/?page=stars-subscriptions): Accept Telegram Stars digital currency and configure recurring subscription periods using createInvoiceLink.
- [Full-Screen Message Effects](https://docs.botlify.cloud/?page=message-effects): Trigger full-screen celebration fireworks, flames, and hearts using message_effect_id.
- [Styled Keyboards & Buttons](https://docs.botlify.cloud/?page=keyboards): Create interactive inline buttons, reply keyboards, pagination, and multi-row grids.
- [Media, Videos & Stickers](https://docs.botlify.cloud/?page=media-stickers): Send photos, audio, videos with custom covers and start timestamps, and animated stickers.
- [Seamless Telegram Web OAuth Login](https://docs.botlify.cloud/?page=web-oauth): Authenticate Telegram users onto web applications seamlessly with one tap using login_url.
- [Chat Join Requests & Auto-Approval](https://docs.botlify.cloud/?page=join-requests): Automatically approve or decline private channel and group join requests with instant welcome direct messages.
- [Complete Master API Reference (A to Z)](https://docs.botlify.cloud/?page=api-matrix): Comprehensive reference matrix covering all 100+ Telegram Bot API 8.x methods.

### AI Agent & MCP Integration

- [Model Context Protocol (MCP) Integration](https://docs.botlify.cloud/?page=mcp-overview): Supercharge your development workflow by connecting AI assistants directly to your Botlify Cloud workspace.
- [Complete MCP Tool Catalog](https://docs.botlify.cloud/?page=mcp-tools): Comprehensive reference of all 20+ Model Context Protocol tools supported by the Botlify Cloud engine.
- [Autonomous AI Bot Building Guide](https://docs.botlify.cloud/?page=ai-workflow): How to prompt AI assistants to build, test, and deploy Telegram bots with zero syntax errors.

### Storage & Architecture

- [Dedicated Per-Bot Storage Architecture](https://docs.botlify.cloud/?page=per-bot-storage): Understanding Botlify's isolated storage quota model and NVMe SSD sandbox limits.
- [Anti-Flood & Rate Limiting Rules](https://docs.botlify.cloud/?page=rate-limits): How Botlify Cloud protects your bots against spam, DoS attacks, and high traffic spikes.

### REST API Reference

- [REST API Overview & Authentication](https://docs.botlify.cloud/?page=api-auth): Complete developer REST API overview, base URL, request methods, and API key authentication headers.
- [User Profile & Account APIs](https://docs.botlify.cloud/?page=api-profile): Retrieve account quotas, bot slots, Telegram ID, per-bot storage limits, and referral links.
- [Complete Bot Management APIs (A-Z)](https://docs.botlify.cloud/?page=api-bots): List, create, deploy, update, restart, soft-delete, restore, and check webhooks remotely.
- [Bot Code Transfer System (A-Z)](https://docs.botlify.cloud/?page=api-transfers): Securely transfer bot source code and architecture between Botlify users with automatic credential sanitization.
- [File System & Code Editor APIs](https://docs.botlify.cloud/?page=api-files): List, read, write, create, upload, delete, and rename files inside the isolated bot sandbox.
- [Environment Variables (.env) APIs](https://docs.botlify.cloud/?page=api-env): Manage bot environment variables, API secrets, and configuration keys securely.
- [Automated Cron Scheduler APIs](https://docs.botlify.cloud/?page=api-crons): Schedule recurring tasks, daily bonuses, and background worker scripts down to 1-minute intervals.
- [SQLite Database Operations APIs](https://docs.botlify.cloud/?page=api-database): Query bot SQLite databases remotely with parameterized queries and schema inspection.
- [Mass Broadcast & Telemetry APIs](https://docs.botlify.cloud/?page=api-broadcast): Send high-speed mass broadcasts to all bot subscribers with inline buttons and delivery stats.
- [Scaffolding, Validation & Webhook Testing APIs](https://docs.botlify.cloud/?page=api-scaffold-test): Automate bot generation, syntax verification, local webhook simulation, and atomic deployment.

### Troubleshooting & Support

- [Troubleshooting & Error Diagnostics](https://docs.botlify.cloud/?page=troubleshooting): Common errors, how to read error.log, and fixing webhook handshake issues.

## Core Technical Specifications

- **Runtime:** PHP 8.2+ with OPcache and native cURL optimization
- **Database:** Embedded SQLite 3 with automatic Write-Ahead Logging (`PRAGMA journal_mode = WAL;`) at `database.db`
- **Storage:** Dedicated NVMe SSD isolated folder per bot (15 MB default quota, auto-managed)
- **AI MCP Server:** Native JSON-RPC 2.0 / SSE endpoint at `https://botlify.cloud/mcp.php` supporting tools like `list_bots`, `get_bot_code`, `update_bot_code`, `query_database`, `view_error_logs`
- **Security:** Environment isolated per-bot `.env` files with secret masking and strict access control
- **Telegram API:** Full compatibility with Telegram Bot API 8.x (Paid Media, Star Transactions, Reaction controls, Business connections, Webhook simulator)