Error Codes Reference

Telegram API Errors

| Error Code | Name | Description | Action |

|---|---|---|---|

| 420 | FLOOD_WAIT_X | Rate limit — wait X seconds | Auto-handled by TelePilot Pro |

| 400 | PEER_FLOOD | Spam restriction | Cooldown account 24h |

| 400 | USER_PRIVACY | Privacy settings block | Skip user |

| 400 | CHAT_WRITE_FORBIDDEN | No write permission | Leave / request access |

| 400 | CHANNELS_TOO_MUCH | Joined too many channels | Leave some channels |

| 400 | INVITE_HASH_INVALID | Bad invite link | Check link validity |

| 400 | INVITE_HASH_EXPIRED | Expired invite | Request new link |

| 401 | AUTH_KEY_UNREGISTERED | Session expired | Re-login |

| 403 | CHAT_ADMIN_REQUIRED | Need admin rights | Get promoted |

| 420 | SLOWMODE_WAIT_X | Slow mode active | Wait or disable slow mode |

Application Errors

| Error | Solution |

|---|---|

| "No accounts connected" | Add and connect accounts first |

| "Database locked" | Close other instances |

| "Session file corrupt" | Delete .session file and re-login |

| "Module not found" | Run `pip install -r requirements.txt` |

Getting Help

Include these in support requests: