Join Requests & Invite Links
Relevant source files
The following files were used as context for generating this wiki page:
The Join Requests & Invite Links module manages how users access Telegram channels and groups controlled by the bot. It provides automated workflows for approving member entry and tracking the effectiveness of different invitation sources. This system integrates with the broader MiniApp control panel to allow administrators to oversee community growth from a centralized dashboard.
Sources: README.md:144-147, README.md:188-190
Management and Automation
The bot automates the process of handling users who wish to join a private group or channel. Administrators configure custom approval workflows to determine if a user should be granted access immediately or requires manual review.
Feature Summary
| Feature | Description |
|---|---|
| Join Request Management | Approves or rejects users waiting to join. |
| Auto-Approval | Automatically admits users based on predefined rules. |
| Invite Link Tracking | Monitors the performance and conversion of specific links. |
| Workflow Customization | Defines specific steps for the approval process. |
Sources: README.md:144-147
Join Request Flow
The following diagram illustrates the high-level logic for processing a user's request to join a managed chat.
This flow represents the logic used to manage member entry into groups and channels.
Sources: README.md:121-122, README.md:144-147
Invite Link Performance Tracking
The system tracks metadata associated with Telegram invite links. This allows the bot to identify which specific links are driving growth and provides analytics on member retention and source attribution.
Tracking Components
- Link IDs: Unique identifiers for each generated invite link.
- Performance Metrics: Data points including total joins, leaves, and current active members per link.
- Audience Segments: Categorization of users based on the link they used (e.g., VIP, Premium, or New).
Sources: README.md:113-116, README.md:144-147
Administrative Control Panel
The MiniApp dashboard serves as the interface for configuring join rules. Administrators can toggle auto-approval settings and view real-time statistics on pending requests.
The sequence shows how settings from the dashboard influence the bot's interaction with the Telegram API.
Sources: README.md:98-102, README.md:144-147
Configuration Parameters
While the minimal bot.py handles message processing, the full management suite utilizes environment variables and database records to persist link settings.
| Parameter | Type | Description |
|---|---|---|
AUTO_APPROVE | Boolean | Enables automatic acceptance of join requests. |
LINK_ID | String | Identifies the source of a new member. |
WORKFLOW_TYPE | String | Sets the logic (e.g., CAPTCHA, manual, or instant). |
Sources: README.md:42-48, README.md:144-147
Conclusion
The Join Requests & Invite Links system provides essential tools for scaling Telegram communities. By automating approvals and tracking link performance, it reduces administrative overhead while providing actionable insights into member acquisition and group growth.