tdlib/telegram-bot-api
Telegram Bot Api
该项目是一个自托管的 Telegram Bot API 服务器，实现了 REST 网关以独立于官方云基础设施管理机器人。它充当消息平台中间件，利用转换层通过基于 TDLib 的核心将高级 REST API 调用转换为低级函数。
该服务器允许本地托管，从而能够移除云端文件上传和下载的大小限制，并使用任意本地 IP 地址和端口进行 Webhook 交付。它提供了一种用于处理大文件的本地文件系统存储机制，并支持基于会话的状态持久化，以促进机器人实例在服务器环境之间的迁移。
该系统涵盖了广泛的机器人功能，包括富媒体、交互式投票和 HTML5 游戏的交付，以及托管微型应用程序。它包括用于商业账户自动化、论坛主题组织和货币化功能（如支付处理和订阅管理）的工具。此外还提供了用于聊天成员管理、用户验证和批量广播协调的管理实用程序。
该服务器源码可编译为适用于各种操作系统的二进制文件，以实现本地部署。
Features
- Bot API Server Self-Hosting - Implements a self-hosted HTTP server to manage bot operations independently of cloud infrastructure.
- Local File Storage - Uses local file system storage to handle large file transfers beyond cloud-imposed limits.
- REST Gateways - Implements a translation layer that converts high-level REST API calls into low-level TDLib functions.
- Bot File Management - Coordinates the retrieval of file information and prepares media files for download from the server.
- Messaging Middleware - Functions as a bridge translating external HTTP requests into platform-specific actions for bots.
- Telegram Webhook Receivers - Configures specific URLs to receive real-time HTTPS POST updates whenever an event occurs.
- Messaging Protocol Cores - Utilizes a low-level client library to handle messaging network protocols, encryption, and state.
- Transfer Limit Overrides - Removes official cloud restrictions on upload and download sizes when running the API server locally.
- Long-Polling Event Pushing - Uses a request-response mechanism that holds connections open until new events trigger a response.
- Rich Media Transmission - Transmits photos, videos, audio, documents, animations, and voice notes to target chats via the API.
- Update Polling - Implements a long-polling mechanism to retrieve incoming updates from the server in a continuous loop.
- Telegram Bot Frameworks - Implements the core API gateway necessary for building interactive agents on the Telegram platform.
- Text Message Transmission - Implements the transmission of formatted text messages and interactive keyboards through the bot API.
- Standardized Event Webhook Delivery - Implements a push-based system for delivering real-time event updates via HTTPS POST requests.
- Protocol Translation Layers - Provides a translation layer that converts high-level REST API calls into low-level TDLib functions.
- Rich Messenger Interfaces - Supports the creation of mini apps, HTML5 games, and complex polls to provide rich user interfaces.
- Chatbot Monetization - Processes payments, manages subscriptions, and handles digital gifts within the chat interface.
- Payment Processing Systems - Processes invoices, creates payment links, and manages refunds using virtual currency or third-party providers.
- Direct Local Path Access - Allows direct access to files via local paths to eliminate the need for separate HTTP download requests.
- Session State Persistence - Persists bot states and user sessions in local directories to facilitate server migration.
- Session Migration - Enables the transfer of bot instances across local server environments by moving session subdirectories.
- Bulk Senders - Sends high-volume messages to subscribers using a paid system to bypass standard rate limits.
- Business Account Configuration - Provides capabilities to handle profile details, settings, and messaging on behalf of connected business accounts.
- Business Account Integration - Enables the integration of bots with professional business accounts to automate messages and profile settings.
- Custom Webhook Delivery - Provides the ability to route webhooks using local IP addresses to bypass cloud network restrictions.
- Webhook Connectivity Tuning - Enables the use of arbitrary local IP addresses and ports while increasing maximum concurrent webhook connections.
- Inline Query Processors - Processes inline search queries to provide interactive result lists for users to send.
- Mini Application Hosting - Supports embedding web-based mini applications with access to local storage and geolocation.
- Mini App Runtimes - Provides a runtime environment for hosting custom JavaScript mini-applications embedded within the messenger.
