Neon Forward Documentation

The complete guide to setting up and using Neon Forward — the Telegram message forwarding tool that uses your own account.

About

Neon Forward is a userbot-powered Telegram forwarder. It connects to your Telegram account and automatically forwards messages from one or more source chats to one or more destination chats. Because it uses your own account (not a bot), it can access private groups, channels, and DMs that bots cannot reach.

You can filter messages, transform their content, add or remove text, delay forwarding, and much more — all controlled through the Telegram bot interface or the web dashboard.

Features

Forward from anything (public or private)
Real-time processing — no delays
Multiple sources to one destination
One source to multiple destinations
Rewrite mode (sends as you, not forwarded)
Native forward mode available
Filter by media type (photos, video, etc.)
Keyword whitelist & blacklist (with regex)
Find-and-replace (Power rules with regex)
Remove lines containing keywords
Format templates (custom headers/footers)
Strip URLs, mentions, captions (Cleaner)
Sender tag with custom name replacement
Mirror edits and deletes
Duplicate message blocking
Configurable delay per redirection
Time-based scheduling
Web dashboard for management
Bot bypass (Action feature)
100% free — no limits, no ads

Commands

Below you'll find every Neon Forward command with examples. All commands are issued to @NeonForwardBot on Telegram. Example values are dummy data — don't copy them directly.

Command Arguments

Argument	Meaning
`phone`	The connected phone number (with country prefix)
`name / redir_id`	A nickname for your redirection setup
`sources`	Source chat ID(s) — comma-separated. Get from `/chats`
`destinations`	Destination chat ID(s) — comma-separated
`pattern`	A keyword or regex pattern (wrap in `/slashes/` for regex)

Connect

Connect your Telegram account to Neon Forward. This must be done on the website (not in the bot chat) because Telegram blocks login codes entered in Telegram chats.

/connect

This shows instructions and a link to the website where you'll:

Log in with Telegram's official login widget
Enter the phone number you want to connect
Enter the login code on the website (never in any chat)
Enter your 2FA password if enabled

Important: Open the website in Chrome, Safari, or Firefox — not Telegram's built-in browser. Login codes entered inside Telegram will be detected and blocked.

Chats

List all your chats and their IDs. You need these IDs to set up redirections.

  # List all chats

  /chats

  # List chats for a specific account

  /chats +14155551234

The output shows the chat type (📢 channel, 👥 group, 👤 user) along with the chat ID you'll use in /redirection.

Redirection

Set up forwarding rules. Each redirection has a name, one or more sources, and one or more destinations. Run this after connecting an account.

Create a redirection

  /redirection add myRule

  # Or specify a phone if you have multiple accounts

  /redirection add myRule on +14155551234

After running this, the bot will ask for source chat ID(s), then destination chat ID(s). Use commas to separate multiple IDs.

  # Enter source IDs (comma-separated)

  -1001234567890

  # Enter destination IDs (comma-separated)

  -1009876543210, -1001111111111

View all redirections

/redirection

Shows all your redirections with inline buttons to enable/disable each one individually, or tap ⚙️ to configure filters, cleaner, sender tag, and more.

Remove a redirection

/redirection remove myRule

Tip: The engine auto-starts when you create a redirection. You don't need to manually start it afterward.

Redirection Settings

Each redirection has its own settings that control how messages are processed. Access them via /redirection → tap ⚙️ → Settings.

Setting	Description
Process Reply	Forward reply messages properly
Mirror Edits	When a source message is edited, update the forwarded copy
Mirror Deletes	When a source message is deleted, delete the forwarded copy
Process Own Msgs	Forward messages you send yourself in the source
Native Forward	Use Telegram's forward feature instead of rewriting
Allow Duplicates	Turn OFF to block duplicate messages
Style Fix	Fix formatting issues when text/links shift after transformations
No Read Receipt	Don't mark source messages as read

Filters

Filter messages by type. When a filter is ON, messages of that type are blocked (not forwarded).

Access via /redirection → ⚙️ → Filters.

Filter	What it blocks
Audio	Audio/music messages
Videos	Video messages
Voice Notes	Voice note messages
GIFs	Animated GIFs
Photos	Photo messages
Stickers	Sticker messages
Documents	Document/file messages
Text	Text-only messages (no media)
Captions	Messages with captions
Forwards	"Forwarded from" messages
Replies	Reply messages
URLs	Messages containing links
Mentions	Messages containing @mentions

Tip: You can combine multiple filters. For example, block stickers AND GIFs while allowing everything else.

Cleaner

Cleaner works like Filters but instead of blocking the entire message, it removes just the matching content and forwards the rest.

Access via /redirection → ⚙️ → Cleaner.

Cleaner	What it strips
Audio	Removes audio attachment, keeps text
Videos	Removes video, keeps text
Photos	Removes photo, keeps caption
Text	Removes all text from the message
Caption	Removes caption from media messages
URLs	Strips all links from the text
Mentions	Strips all @mentions from the text

Example: Forward photos from a source channel but strip the caption — enable Caption in Cleaner.

Transformation

Transform message content before forwarding. Neon Forward supports three transformation modes: Power (find-and-replace), Remove Lines, and Format templates.

Power (Find & Replace)

Use /power to add find-and-replace rules to a redirection. Supports both plain text and regex.

  # Add a plain text replacement

  /power myRule add red -> blue

  # Add a regex replacement

  /power myRule addregex (telegram\.me|t\.me)\/\S+ -> [link removed]

  # Remove a word (replace with nothing)

  /power myRule add spam text -> 

  # List all power rules

  /power myRule list

  # Clear all power rules

  /power myRule clear

Tip: Test your regex at regex101.com — make sure to select the Python flavor.

Whitelist

Only forward messages that contain at least one of your whitelisted keywords or regex patterns. Messages that don't match are silently dropped.

  # Set whitelist keywords

  /whitelist myRule signal, alert, buy

  # Use regex (wrap in /slashes/)

  /whitelist myRule /BTC|ETH/, signal

  # Clear whitelist

  /whitelist myRule clear

Warning: An incorrect whitelist will block ALL messages. If forwarding stops after setting a whitelist, clear it with /whitelist myRule clear.

Blacklist

Block messages that contain any of your blacklisted keywords or patterns. Messages that match are dropped; all others pass through.

  # Set blacklist keywords

  /blacklist myRule ad, promo, sponsored

  # Use regex

  /blacklist myRule /@\S+/, /https?:\/\/\S+/

  # Clear blacklist

  /blacklist myRule clear

Sender Tag & Replace

Append the original sender's name to forwarded messages. Choose between @username or display name mode.

Enable it: /redirection → ⚙️ → 🏷 Sender Tag → Enable.

Output example:

  Great signal alert!

  —from @original_user

Custom sender name replacement

Use /senderreplace to map original sender names to custom display names.

  # Add a replacement

  /senderreplace myRule add @old_name -> Premium Signals

  # List replacements

  /senderreplace myRule list

  # Clear all replacements

  /senderreplace myRule clear

After adding the replacement above, messages from @old_name will show:

  Great signal alert!

  —from Premium Signals

Delay & Scheduler

Configure a delay (in seconds) before messages are forwarded. This is configured per-redirection through the settings.

Scheduler: Set time windows when forwarding is active. Outside these hours, messages are silently dropped.

  # Example scheduler config

  Start: 09:00 UTC

  Stop: 21:00 UTC

  # Messages received outside 9am–9pm are not forwarded

Action (Bot Bypass)

Some channels use protection bots that hide content behind buttons (e.g., "Click to reveal", "Read More"). The Action feature simulates clicking these buttons and then forwards the revealed content.

Configure actions per-redirection through the settings. Specify the button text to match (case-sensitive, partial match supported).

Settings (Engine Control)

Start and stop the forwarding engine for each connected account.

/settings

Shows inline buttons for each account — tap to start or stop the engine. The engine auto-starts when you create a redirection, and auto-resumes on server restart if you have enabled redirections.

Tip: If forwarding stops unexpectedly, first check /config to see if the engine is running, then use /settings to restart it.

Config

View your complete configuration — accounts, their running status, and all active redirections.

/config

Frequently Asked Questions

Why does Neon Forward need access to my Telegram account?

Neon Forward uses your account to read messages from source chats and send them to destinations — as you. This allows forwarding from private groups and channels that bots can't access, and messages appear as if you sent them naturally. A regular bot cannot read or write to chats without admin permissions.

Is Neon Forward free?

Yes. Neon Forward is completely free with no message limits, no ads, and all features available. No paid plans, no restrictions.

Can I forward from a private channel?

Yes! As long as you're a member of the private channel, Neon Forward can read messages from it and forward them to any destination.

Can I forward from a channel I don't have access to?

No. Neon Forward can only see chats you have access to as a user. If you can't view a channel, neither can the forwarder.

Does it need admin permissions in the source?

No. Since it uses your own account, it can see any chat you have access to as a regular member. For the destination, you need to be able to send messages there.

Can I add custom text (headers, footers, word changes)?

Yes. Use /power for find-and-replace. The format template system supports keywords like [[Message.Text]], [[Sender.Username]] to build custom message formats.

Can I choose which users to allow messages from?

Yes. The select_users feature allows you to whitelist or blacklist specific user IDs within a source chat.

Can I filter out duplicate messages?

Yes. In your redirection settings, toggle Allow Duplicates OFF. Neon Forward will hash each message and block duplicates automatically.

Can I mirror edits and deletes?

Yes. Enable Mirror Edits and/or Mirror Deletes in your redirection settings. When a source message is edited or deleted, the forwarded copy is updated or removed.

Is my account safe?

Your login code is entered only on our website over HTTPS and is never stored. We use Telegram's official MTProto protocol. Your password is never shared with us. The session can be disconnected at any time via /disconnect.

Does Neon Forward delay messages?

No. Messages are processed in real-time. The only delay is what you configure yourself via the delay feature.

Known Issues & Troubleshooting

Forwarding stopped working

There are several reasons forwarding can stop:

Engine not running. Check with /config — if it says 🔴 Stopped, use /settings to start it.
Bad whitelist/blacklist. An incorrect regex in /whitelist or /blacklist can silently block all messages. Clear them: /whitelist myRule clear
All filters are ON. If you accidentally enabled filters that block every media type plus text, nothing will pass. Check via ⚙️ → Filters.
Server restart. After a server restart, engines auto-start for all accounts with enabled redirections. If not, use /settings to start manually.

Config shows Running: No

Use /settings, tap your account to start the engine. If it fails, try /disconnect and reconnect your account via the website.

Chat Access Error

This happens when:

You were removed or left the source/destination chat
A group converted to a supergroup (chat ID changes) — use /chats to get the new ID and update your redirection
In rare cases, Telegram doesn't return the chat — usually temporary

Edits/deletes not mirroring

Make sure Mirror Edits / Mirror Deletes are enabled in your redirection settings. Note: Telegram doesn't always send delete events — this is a Telegram limitation, not a Neon Forward bug.

Messages have broken formatting

If you're using Power rules or Cleaner and text formatting (bold, links, etc.) breaks, try enabling Style Fix in your redirection settings. Note: Style Fix can over-link text in some edge cases — only use it when needed.

Bad whitelist/blacklist regex

If you set up regex incorrectly, it can silently block all messages. Fix it by clearing the list:

  /whitelist myRule clear

  /blacklist myRule clear

Tip: Always test your regex at regex101.com (Python flavor) before applying.

FloodWait / rate limiting

If your account sends too many messages too fast, Telegram may impose a temporary rate limit. Neon Forward handles this automatically by waiting the required time before retrying. This is a Telegram server-side limit and cannot be avoided.