Scraper
Troubleshooting
Solutions for common issues with connection, channels, addresses, and login.
If you're running into issues, start here. Check the Activity page log for error messages first.
"Not connected to Telegram" error
- Make sure you have an active internet connection
- Try logging out and logging back in
- Verify your API credentials are correct at my.telegram.org/apps
No channels showing up
- Click the Refresh button on the Channels page
- Make sure you're connected to Telegram (check the connection status)
- If you just joined new channels, it may take a moment for them to appear
Addresses not being detected
- Verify that the channel is being scraped (at least one checkbox enabled on the Channels page)
- Check that the correct filter is enabled (e.g., if the address comes from an admin, make sure "Admins" is checked)
- The address format must match one of the supported patterns (see Supported Blockchains)
- Check the Activity page log for any error messages
Addresses not being forwarded
- Make sure the Maestro bot (
@maestroor@maestropro) is accessible from your Telegram account - Start a conversation with the Maestro bot on Telegram first if you haven't already
- Check the activity log for "error" entries that may explain the failure
Duplicate addresses being skipped
- This is expected behavior when "Ignore Duplicates" is enabled in Settings
- Duplicates are detected per channel - the same address from a different channel will still be forwarded
- To reset duplicate detection, go to Settings and click Clear Address History
App feels slow
- Check Settings for warnings about large activity logs or address histories
- Clear your activity logs and/or address history
- Lower the log retention period
Login issues
| Error | Solution |
|---|---|
| "API ID must be a valid number" | Enter only the numeric API ID from my.telegram.org |
| "API Hash must be 32 characters" | Copy the full API Hash string from my.telegram.org |
| "Invalid phone number format" | Include your country code (e.g., +1 for US, +44 for UK) |
| "Invalid verification code" | Double-check the code from your Telegram app |
| "Verification code expired" | Click "Resend code" to get a new one |
| "Incorrect password" | This is your Telegram 2FA cloud password, not your app password |
| "Too many attempts" | Wait a few minutes before trying again |
| "This phone number is banned" | Contact Telegram support |
"Keychain access is unavailable" warning (macOS)
If you see this warning when enabling "Remember credentials":
- You previously denied Keychain access when macOS prompted you
- Go to System Settings → Privacy & Security and allow Keychain access for Maestro Scraper
- Restart the app and try again
Without Keychain access, your credentials and session cannot be saved — you will need to log in again each time you restart the app.