Contact Lists & Drip Campaigns
Relevant source files
The following files were used as context for generating this wiki page:
Contact Lists & Drip Campaigns manage user outreach and audience segmentation within the TelePilot ecosystem. This system organizes imported contacts into structured lists to enable targeted messaging through bulk and drip campaign modes.
The module operates via two primary methods: a standard bot mode capable of 20 messages per second and a high-volume Business mode utilizing the Telegram Business API. These features support automated sequences to improve engagement across managed channels and groups.
Sources: README.md:144-150
Audience Segmentation & Organization
The system categorizes members and contacts to facilitate specific campaign targeting. You can export member data to CSV and apply advanced filters to identify segments such as active, new, or premium users.
Targeting Segments
The broadcasting engine utilizes seven specific audience segments for drip and bulk campaigns:
- All: Every reachable user or member.
- VIP: High-priority contacts.
- Premium: Users with premium status.
- Active: Members showing recent engagement.
- New: Recently joined members.
- By Channel: Contacts filtered by their specific channel affiliation.
Sources: README.md:109-114, README.md:120-122
Management Workflow
This diagram illustrates the flow of contact data from import to campaign execution.
Sources: README.md:109-110, README.md:144-148
Campaign Execution Modes
The system provides two distinct technical paths for delivering campaign messages based on volume requirements and account types.
Messaging Throughput and Methods
| Mode | Delivery Rate | Interface |
|---|---|---|
| Bot Mode | 20 messages/second | Standard Telegram Bot API |
| Business Mode | Variable High-Volume | Telegram Business API |
Sources: README.md:147-148
Message Media Support
Campaigns support diverse content types to maintain high engagement rates. The Smart Broadcasting engine processes:
- Standard Text
- Media (Photos, Videos, Documents)
- Interactive Polls
Sources: README.md:123-124
Drip Campaign Logic
Drip campaigns utilize scheduled post functionality and retry logic to ensure message delivery over time. The system manages engagement by tracking interactions and automating administrative actions.
Automated Sequence Features
- Scheduling: Posts are queued for specific times across multiple channels.
- Retry Logic: The system attempts redelivery if initial transmission fails.
- Auto-Cleanup: Supports pinning, unpinning, and automatic deletion of campaign messages after a set period.
Sources: README.md:127-130
Drip Communication Flow
This sequence diagram shows the interaction between the TelePilot control panel and the Telegram API during a campaign.
Sources: README.md:128-129, README.md:154-156
Integration with Templates & Media
Campaign efficiency relies on the Templates and Media Library. You can save message structures and access a centralized repository of assets for use across all contact lists.
- Templates: Save and reuse message structures for consistent branding.
- Media Library: Centralized storage for images and videos used in drips.
- Placeholders: Dynamic fields like
{name},{username}, and{channel}personalize drip content.
Sources: README.md:133-135, README.md:151-152
Summary
The Contact Lists & Drip Campaigns system provides the infrastructure for scalable member engagement. By combining granular audience segmentation with high-speed delivery modes and automated scheduling, it enables sophisticated marketing and management workflows within Telegram. The integration of AI insights and detailed analytics further allows for the refinement of campaign strategies based on real-time performance data.
Sources: README.md:154-156, README.md:158-161