Bulk Sender
The Bulk Sender is TeleSender's core messaging feature, enabling you to send personalized messages to multiple Telegram users with intelligent pacing and comprehensive delivery tracking.
Overview
Send text messages, images, videos, and documents to your target audience while TeleSender handles rate limiting, error recovery, and progress tracking automatically.
How It Works
Select Targets → Compose Message → Add Media (Optional) → Configure Delays → Start Sending
The sender operates through:
- Target Selection — Import from scraper or upload list
- Message Composition — Write your text with optional media
- Delivery Configuration — Set delays and retry behavior
- Execution — Messages sent with rate limiting
- Monitoring — Track success, failures, and progress
Getting Started
Creating a Send Campaign
- Open TeleSender Options page
- Navigate to Campaigns tab
- Click "New Campaign"
- Select campaign type:
- Scrape-Send — Scrape then send
- Import-Send — Upload targets then send
Selecting Targets
From Scraper Results
- Choose "Scrape-Send" campaign
- Previous scrapes appear in the target selector
- Select which contacts to message
Manual Import
Upload a file with usernames:
Supported formats:
.txt— One username per line.csv— Username column.json— Array of username strings
Example text file:
john_doe
jane_smith
marketing_pro
Example CSV:
username,notes
john_doe,Lead from webinar
jane_smith,Interested in product
Message Composition
Text Messages
Write your message in the text area:
Hi there!
I noticed you're interested in digital marketing.
We have some great resources that might help you.
Check out our guide: example.com/guide
Best regards!
Keep messages under 4,096 characters (Telegram's limit). Shorter messages (under 500 characters) typically perform better.
Adding Media
TeleSender supports various media types:
| Type | Formats | Max Size |
|---|---|---|
| Images | JPG, PNG, GIF, WEBP | 10 MB |
| Videos | MP4, MOV | 50 MB |
| Documents | PDF, DOC, ZIP, etc. | 50 MB |
Single Media
- Click "Add Media"
- Select your file
- Optionally add a caption
Multiple Media
- Click "Add Media" multiple times
- Each file can have its own caption
- Files are sent in order
// Media configuration example
{
media: [
{
file: "image.jpg",
type: "image/jpeg",
caption: "Check out this infographic!"
},
{
file: "guide.pdf",
type: "application/pdf",
caption: "Download our free guide"
}
]
}
Delivery Configuration
Delay Settings
Configure time between messages:
| Setting | Description | Range |
|---|---|---|
| Delay | Seconds between messages | 5-300 seconds |
| Delay Type | Random or fixed | - |
| Min Delay | Minimum wait (random mode) | 5+ seconds |
| Max Delay | Maximum wait (random mode) | Up to 300 seconds |
Recommended Settings by Profile
| Profile | Delay | Best For |
|---|---|---|
| Ultra Safe | 90 seconds | Valuable accounts |
| Safe | 45 seconds | Regular use |
| Moderate | 30 seconds | Balanced speed/safety |
| Fast | 15 seconds | Testing only |
Retry Configuration
Handle failed sends automatically:
{
retry: {
maxAttempts: 3, // Try up to 3 times
initialDelay: 1000, // 1 second first retry
maxDelay: 30000, // Cap at 30 seconds
backoffFactor: 2, // Double delay each retry
}
}
Running the Sender
Starting a Send Operation
- Review your target list and message
- Confirm delay settings
- Select anti-ban profile
- Click "Start Sending"
Progress Monitoring
Track delivery in real-time:
┌────────────────────────────────────────┐
│ Sending Messages │
│ ████████████████░░░░ 78% │
│ │
│ ✓ Sent: 156 │
│ ✗ Failed: 8 │
│ ⏭ Skipped: 4 │
│ ⏳ Remaining: 32 │
│ │
│ Current: @john_doe │
│ Next delay: 45s │
└────────────────────────────────────────┘
Operation Controls
| Button | Action |
|---|---|
| Pause | Stop sending, preserve position |
| Resume | Continue from pause point |
| Stop | Cancel operation entirely |
Error Handling
TeleSender automatically handles common errors:
Error Types and Responses
| Error | Response | User Action |
|---|---|---|
USER_NOT_FOUND | Skip user | None needed |
USERNAME_INVALID | Skip user | Check username format |
PRIVACY_RESTRICTED | Skip user | User blocks messages |
FLOOD_WAIT | Pause for duration | Automatic recovery |
PEER_FLOOD | Stop operation | Wait 24+ hours |
NETWORK_ERROR | Retry | Check connection |
Error Severity Levels
{
low: "Minor issue, operation continues",
medium: "User skipped, operation continues",
high: "Temporary pause required",
critical: "Operation must stop"
}
Delivery Results
Success Metrics
After completion, view results:
{
statistics: {
sent: 156, // Successfully delivered
failed: 8, // Could not deliver
skipped: 4, // Privacy restrictions
totalTime: "45m 23s",
avgDelay: "47.2s"
}
}
Failed Deliveries Report
Export failed usernames for review:
{
"failed": [
{
"username": "user123",
"error": "PRIVACY_RESTRICTED",
"message": "User has restricted who can message them"
}
]
}
Best Practices
Message Quality
High-quality messages get better responses and fewer spam reports.
Do:
- Personalize when possible
- Keep messages concise
- Provide clear value proposition
- Include a clear call-to-action
Don't:
- Send identical messages to thousands
- Use ALL CAPS or excessive punctuation!!!
- Include suspicious links
- Make false promises
Timing Strategy
| Time | Performance | Notes |
|---|---|---|
| Morning (8-10 AM) | Good | People checking messages |
| Midday (12-2 PM) | Moderate | Lunch break browsing |
| Evening (6-9 PM) | Best | Peak Telegram usage |
| Night (10 PM-6 AM) | Variable | Depends on audience |
Volume Management
Spread large campaigns across multiple days:
| Day | Volume | Cumulative |
|---|---|---|
| Day 1 | 100 messages | 100 |
| Day 2 | 150 messages | 250 |
| Day 3 | 200 messages | 450 |
| Day 4 | 200 messages | 650 |
This gradual increase looks more natural to Telegram's systems.
Account Warming
For new or recently added accounts:
- Week 1: Light manual usage only
- Week 2: Send 10-20 messages/day
- Week 3: Increase to 30-50 messages/day
- Week 4+: Normal operation
Demo Limits
In demo mode, sending is limited:
| Feature | Demo Limit |
|---|---|
| Messages per session | 10 |
| Media attachments | Yes |
| Retry logic | Yes |
| Progress tracking | Yes |
Troubleshooting
"PEER_FLOOD" Error
Problem: Account temporarily restricted from messaging
Solutions:
- Stop all sending immediately
- Wait 24-48 hours before resuming
- Use a safer anti-ban profile
- Consider using multiple accounts
Messages Not Delivering
Problem: Sent count stays at 0
Possible causes:
- Invalid usernames in target list
- All users have privacy restrictions
- Session expired
Solutions:
- Verify target usernames exist
- Try with known valid usernames
- Re-authenticate your Telegram account
Slow Delivery
Problem: Sending takes much longer than expected
This is intentional! Slow sending protects your account.
To speed up (at your own risk):
- Switch to "Moderate" or "Fast" profile
- Reduce delay settings
- Be aware of increased ban risk
Media Upload Failures
Problem: Files not attaching to messages
Solutions:
- Check file size limits
- Verify file format is supported
- Try a different file
- Ensure stable internet connection
Integration with Campaigns
Scrape-Send Workflow
Combine scraping and sending:
1. Scrape members from Group A
2. Filter by criteria (optional)
3. Score with AI (optional)
4. Send personalized message
5. Track delivery results
Using AI Message Generation
- Go to AI → Message Generator
- Describe your campaign goal
- Generate multiple variations
- Select the best performing version
- Use in your send campaign
Compliance Warning
Bulk messaging must comply with Telegram's policies:
- Only message users who can reasonably expect contact
- Don't send spam or unwanted promotional content
- Respect opt-out requests immediately
- Never send malicious content or links
Violations can result in permanent account bans.
Quick Reference
| Setting | Safe Value | Description |
|---|---|---|
| Delay | 45s | Between messages |
| Retry | 3 | Max attempts |
| Profile | Safe | Anti-ban level |
| Batch | 20 | Messages before long pause |