Circuit Breakers
Circuit breakers protect your Telegram accounts from blocks by automatically pausing campaigns when issues are detected.Overview
The circuit breaker system monitors your Telegram accounts for signs of detection and automatically pauses campaigns to prevent further damage.
How Circuit Breakers Work
Detection Triggers
The system monitors for these issues:| Issue | Description | Severity |
|---|---|---|
| FloodWait | Telegram rate limit exceeded | High |
| PeerFlood | Too many messages to non-contacts | High |
| Smart Block | Hidden restriction by Telegram | Medium |
| Privacy Error | Cannot message user | Low |
| Auth Error | Authentication issues | High |
Automatic Response
When issues are detected:- Detection: System identifies the issue type
- Pause: All campaigns using that account pause
- Notify: User is alerted to the issue
- Wait: System tracks required wait time
- Resume: User manually resumes when safe
Error Types
FloodWait
What it means: Telegram has rate-limited the account Causes:- Too many messages sent quickly
- Exceeded daily message limits
- Violated Telegram terms
- Minimum 48-hour lockout
- Additional wait time based on severity
- Account health score reduced
PeerFlood
What it means: Account sent too many messages to users who haven’t saved the contact Causes:- Messaging too many new contacts
- Low response rate
- Spam-like behavior detected
- All active campaigns pause immediately
- Minimum 48-hour cooldown
- Requires manual review before resume
Smart Block
What it means: Telegram has silently restricted the account Causes:- Suspicious activity patterns
- User reports
- Automated behavior detection
- Account marked as warning status
- Reduced daily limits
- Health score capped at 60%
Privacy Error
What it means: Cannot send messages to specific user Causes:- User privacy settings
- User blocked the account
- User hasn’t saved contact
- Skip that lead
- Continue with other leads
- Log error for review
Account Health Score
Score Calculation
Health score (0-100%) based on:| Factor | Weight |
|---|---|
| FloodWait count | -10% each |
| PeerFlood count | -15% each |
| Smart Block count | -20% each |
| Error rate | -5% per error |
| Recent activity | +10% positive |
Health Status
| Score | Status | Action |
|---|---|---|
| 80-100% | Healthy | Normal operation |
| 60-79% | Warning | Monitor closely |
| 40-59% | Critical | Reduce activity |
| 0-39% | Blocked | Manual intervention |
Circuit Breaker Configuration
Per-Account Settings
Configure error handling per account:FloodWait Pause Duration
| Value | Behavior |
|---|---|
| 0 | Use Telegram’s wait time |
| 1-24 | Hours of additional pause |
| -1 | Indefinite (manual intervention) |
Auth/PeerFlood Pause Duration
| Value | Behavior |
|---|---|
| 0 | No additional pause |
| 24-72 | Hours of pause |
| -1 | Indefinite (manual intervention) |
High Error Threshold
- Default: 10 errors in 24 hours
- Auto-pause: Toggle to pause account when threshold reached
Manual Control
Clearing Rate Limits
Manually clear rate limit status:Checking Resume Eligibility
Check if campaign can resume:can_resume: booleanblock_reason: string (if blocked)account_status: current status
Manual Resume
Resume campaigns after issues resolved:- Navigate to Telegram Security
- Find affected account
- Click Reactivate
- Confirm resume
Best Practices
- Proactive Warming: Always warm up new accounts
- Rate Limit Profiles: Use appropriate profiles for account age
- Monitor Health: Regularly check account health scores
- Respond Quickly: Address issues when detected
- Patience: Wait full cooldown period before resuming
- Reduce Activity: Lower limits after any block
Counter Reset Times
Daily Limits
- Reset Time: Midnight UTC
- Applies to: Daily message counters
Hourly Limits
- Reset Time: Start of every hour
- Applies to: Hourly rate limits
Troubleshooting
Account Blocked Indefinitely
If account shows indefinite block:- Do not try to use the account
- Wait 7 days minimum
- Try small test messages
- Gradually increase activity
- Consider account replacement
Frequent FloodWaits
If experiencing frequent FloodWaits:- Lower rate limit profile
- Increase delays between messages
- Check for automation issues
- Review message content
- Consider warming up account
PeerFlood Loop
If stuck in PeerFlood cycle:- Pause all campaigns immediately
- Wait minimum 72 hours
- Review lead quality
- Improve targeting
- Resume with lower limits