# 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](https://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](/docs/scraper/supported-blockchains))
- Check the Activity page log for any error messages

## Addresses not being forwarded

- Make sure the Maestro bot ([`@maestro`](https://t.me/maestro) or [`@maestropro`](https://t.me/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.