Документація Neon Forward

Повний посібник із налаштування та використання Neon Forward — інструмента пересилання повідомлень у Telegram через ваш власний акаунт.

Про сервіс

Neon Forward — це пересильник для Telegram на базі userbot. Він підключається до вашого акаунта Telegram і автоматично пересилає повідомлення з одного або кількох вихідних чатів у один або кілька чатів призначення. Оскільки використовується ваш акаунт (а не бот), доступні приватні групи, канали та особисті чати, куди звичайні боти не потрапляють.

Можна фільтрувати повідомлення, змінювати текст, додавати або прибирати фрагменти, відкладати пересилання тощо — усе через інтерфейс бота в Telegram або веб-панель.

Можливості

Команди

Нижче перелічено всі команди Neon Forward з прикладами. Команди надсилаються боту @NeonForwardBot у Telegram. Приклади значень — умовні, не копіюйте їх дослівно.

Аргументи команд

АргументЗначення
phoneПідключений номер телефону (з кодом країни)
name / redir_idКоротка назва вашого переспрямування
sourcesID вихідних чатів через кому. Див. /chats
destinationsID чатів призначення через кому
patternКлючове слово або шаблон regex (для regex обгорніть у /слеші/)

Підключення

Підключіть свій акаунт Telegram до Neon Forward. Це потрібно робити на сайті (не в чаті з ботом), бо Telegram блокує введення кодів входу в чатах.

/connect

Показує інструкції та посилання на сайт, де ви:

  1. Входите через офіційний віджет входу Telegram
  2. Вводите номер телефону, який хочете підключити
  3. Вводите код входу на сайті (не в жодному чаті)
  4. За увімкненої 2FA — пароль двофакторної автентифікації
Важливо: Відкрийте сайт у Chrome, Safari або Firefox — не у вбудованому браузері Telegram. Коди, введені всередині Telegram, буде виявлено й заблоковано.

Чати

Список усіх ваших чатів та їх ID. Ці ID потрібні для налаштування переспрямувань.

# Список усіх чатів
/chats

# Чати для конкретного акаунта
/chats +14155551234

У виводі вказано тип чату (📢 канал, 👥 група, 👤 користувач) та ID чату для використання в /redirection.

Переспрямування

Налаштування правил пересилання. У кожного переспрямування є назва, одне або кілька джерел і одне або кілька чатів призначення. Виконуйте після підключення акаунта.

Створити переспрямування

/redirection add myRule

# Або вкажіть телефон, якщо акаунтів кілька
/redirection add myRule on +14155551234

Після команди бот запитає ID вихідних чатів, потім ID чатів призначення. Кілька ID розділяйте комами.

# ID джерел (через кому)
-1001234567890

# ID призначень (через кому)
-1009876543210, -1001111111111

Показати всі переспрямування

/redirection

Показує всі переспрямування з кнопками увімкнення/вимкнення кожного та кнопкою ⚙️ для фільтрів, Cleaner, мітки відправника тощо.

Видалити переспрямування

/redirection remove myRule
Порада: Рушій запускається автоматично під час створення переспрямування. Вручну запускати його після цього не потрібно.

Налаштування переспрямування

У кожного переспрямування свої параметри обробки повідомлень. Доступ: /redirection → ⚙️ → Settings.

ПараметрОпис
Process ReplyКоректно пересилати відповіді на повідомлення
Mirror EditsПри правці вихідного повідомлення оновлювати переслану копію
Mirror DeletesПри видаленні вихідного повідомлення видаляти переслану копію
Process Own MsgsПересилати ваші власні повідомлення з джерела
Native ForwardВикористовувати пересилання Telegram замість переписування
Allow DuplicatesВимкніть, щоб блокувати дублікати
Style FixВиправляти форматування, якщо текст/посилання зміщуються після перетворень
No Read ReceiptНе позначати вихідні повідомлення прочитаними

Фільтри

Фільтрація за типом повідомлення. Якщо фільтр увімкнено, повідомлення цього типу блокуються (не пересилаються).

Доступ: /redirection → ⚙️ → Filters.

ФільтрЩо блокує
AudioАудіо/музика
VideosВідео
Voice NotesГолосові повідомлення
GIFsАнімовані GIF
PhotosФото
StickersСтикери
DocumentsДокументи та файли
TextЛише текст (без медіа)
CaptionsПовідомлення з підписами до медіа
ForwardsПовідомлення «Переслано від…»
RepliesВідповіді на повідомлення
URLsПовідомлення з посиланнями
MentionsПовідомлення з @згадками
Порада: Фільтри можна комбінувати. Наприклад, блокувати стикери та GIF, решту пропускати.

Cleaner

Cleaner схожий на фільтри, але замість блокування всього повідомлення прибирає лише те, що збігається, решту пересилає.

Доступ: /redirection → ⚙️ → Cleaner.

CleanerЩо прибирає
AudioПрибирає аудіовкладення, текст зберігає
VideosПрибирає відео, текст зберігає
PhotosПрибирає фото, підпис зберігає
TextПрибирає весь текст повідомлення
CaptionПрибирає підпис у медіа
URLsВидаляє всі посилання з тексту
MentionsВидаляє всі @згадки з тексту

Приклад: Пересилати фото з каналу без підпису — увімкніть Caption у Cleaner.

Перетворення

Зміна тексту перед пересиланням. Підтримуються три режими: Power (пошук і заміна), Remove Lines та шаблони Format.

Power (пошук і заміна)

Команда /power додає правила пошуку та заміни до переспрямування. Підтримується звичайний текст і regex.

# Заміна звичайного тексту
/power myRule add red -> blue

# Заміна за regex
/power myRule addregex (telegram\.me|t\.me)\/\S+ -> [link removed]

# Прибрати слово (заміна на порожнє)
/power myRule add spam text ->

# Список правил Power
/power myRule list

# Очистити всі правила Power
/power myRule clear
Порада: Перевіряйте regex на regex101.com — оберіть варіант Python.

Білий список

Пересилаються лише повідомлення, що містять хоча б одне з дозволених слів або шаблонів regex. Решта відкидається без повідомлення.

# Ключові слова білого списку
/whitelist myRule signal, alert, buy

# Regex (у /слешах/)
/whitelist myRule /BTC|ETH/, signal

# Очистити білий список
/whitelist myRule clear
Увага: Невірний білий список заблокує усі повідомлення. Якщо пересилання зупинилося після налаштування — очистіть: /whitelist myRule clear.

Чорний список

Блокує повідомлення, що містять будь-яке з заборонених слів або шаблонів. Збіги відкидаються, решта проходить.

# Ключові слова чорного списку
/blacklist myRule ad, promo, sponsored

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

# Очистити чорний список
/blacklist myRule clear

Мітка відправника та заміна

Додає до пересланих повідомлень ім’я початкового відправника. Режими: @username або відображуване ім’я.

Увімкнення: /redirection → ⚙️ → 🏷 Sender Tag → увімкнути.

Приклад виводу:

Great signal alert!

—from @original_user

Заміна імені відправника

/senderreplace задає відповідність вихідних імен і відображуваних.

# Додати заміну
/senderreplace myRule add @old_name -> Premium Signals

# Список замін
/senderreplace myRule list

# Очистити всі заміни
/senderreplace myRule clear

Після додавання заміни повідомлення від @old_name покажуть:

Great signal alert!

—from Premium Signals

Затримка та планувальник

Затримка в секундах перед пересиланням налаштовується окремо для кожного переспрямування у параметрах.

Планувальник: Вікна часу, коли пересилання активне. Поза цими годинами повідомлення відкидаються без повідомлення.

# Приклад налаштування планувальника
Start: 09:00 UTC
Stop: 21:00 UTC

# Повідомлення поза інтервалом 9:00–21:00 не пересилаються

Action (обхід ботів)

У деяких каналах контент приховано за кнопками («Натисніть, щоб показати», «Читати далі»). Функція Action імітує натискання таких кнопок і пересилає вже розкритий текст.

Налаштовується для кожного переспрямування в параметрах. Вкажіть текст кнопки (з урахуванням регістру, допускається частковий збіг).

Settings (керування рушієм)

Запуск і зупинка рушія пересилання для кожного підключеного акаунта.

/settings

Показує кнопки за акаунтами — натисніть, щоб запустити або зупинити рушій. Рушій стартує автоматично під час створення переспрямування та після перезапуску сервера, якщо є увімкнені переспрямування.

Порада: Якщо пересилання несподівано зупинилося, спочатку перевірте /config — чи працює рушій, потім перезапустіть через /settings.

Config

Повна зведка: акаунти, статус рушія та всі активні переспрямування.

/config

Часті запитання

Навіщо Neon Forward доступ до мого акаунта Telegram?
Сервіс читає повідомлення у вихідних чатах і надсилає їх у призначення від вашого імені. Так можна пересилати з приватних груп і каналів, куди ботів не допускають, і повідомлення виглядають як звичайне надсилання з вашого боку. Звичайний бот не читає й не пише в чати без прав адміністратора.
Чи безкоштовний Neon Forward?
Так. Повністю безкоштовно: без лімітів на повідомлення, без реклами, усі функції доступні. Платних тарифів і штучних обмежень немає.
Чи можна пересилати з приватного каналу?
Так. Якщо ви учасник приватного каналу, Neon Forward може читати звідти повідомлення і пересилати куди завгодно.
Чи можна пересилати з каналу, до якого у мене немає доступу?
Ні. Видно лише ті чати, до яких у вас є доступ як у користувача. Якщо ви не бачите канал — не бачить і пересильник.
Чи потрібні права адміністратора у джерелі?
Ні. Використовується ваш акаунт, тому видно всі чати, доступні звичайному учаснику. У чаті призначення потрібна можливість надсилати повідомлення.
Чи можна додати власний текст (заголовки, підписи, заміни слів)?
Так. Для пошуку та заміни — /power. У шаблонах формату використовуються поля на кшталт [[Message.Text]], [[Sender.Username]] для власного вигляду повідомлення.
Чи можна дозволяти повідомлення лише від обраних користувачів?
Так. Функція select_users дозволяє білий або чорний список за ID користувачів у межах вихідного чату.
Чи можна відфільтрувати дублікати повідомлень?
Так. У налаштуваннях переспрямування вимкніть Allow Duplicates. Neon Forward хешує повідомлення й автоматично блокує повтори.
Чи можна дзеркалити правки та видалення?
Так. Увімкніть Mirror Edits та/або Mirror Deletes у налаштуваннях переспрямування. При правці або видаленні вихідного повідомлення копія оновлюється або видаляється.
Чи безпечний мій акаунт?
Код входу вводиться лише на нашому сайті через HTTPS і не зберігається. Використовується офіційний протокол Telegram MTProto. Пароль нам не передається. Сесію можна будь-коли розірвати командою /disconnect.
Чи затримує Neon Forward повідомлення?
Ні. Обробка в реальному часі. Затримка можлива лише якщо ви самі налаштували функцію затримки.

Відомі проблеми та усунення несправностей

Пересилання перестало працювати

Можливі причини:

  1. Рушій не запущено. Перевірте /config — якщо 🔴 Stopped, запустіть через /settings.
  2. Невірний білий/чорний список. Помилка в regex у /whitelist або /blacklist може мовчки блокувати все. Очистіть: /whitelist myRule clear
  3. Усі фільтри увімкнено. Якщо увімкнено фільтри, що блокують усі типи медіа та текст, нічого не пройде. Перевірте ⚙️ → Filters.
  4. Перезапуск сервера. Після перезапуску рушії зазвичай стартують самі для акаунтів з увімкненими переспрямуваннями. Якщо ні — запустіть вручну в /settings.

У Config: Running: No

Відкрийте /settings, натисніть свій акаунт, щоб запустити рушій. Якщо не допомагає — /disconnect і знову підключіться через сайт.

Помилка доступу до чату

Виникає коли:

Правки/видалення не дзеркаляться

Увімкніть Mirror Edits / Mirror Deletes у налаштуваннях переспрямування. Зауважте: Telegram не завжди надсилає події видалення — це обмеження Telegram, не баг Neon Forward.

Зламане форматування повідомлень

Якщо після правил Power або Cleaner «пливе» оформлення (жирний, посилання тощо), спробуйте Style Fix у налаштуваннях переспрямування. Style Fix у рідких випадках може надмірно розмічати посилання — увімкнюйте за потреби.

Невірний regex у білому/чорному списку

Неправильний regex може мовчки блокувати всі повідомлення. Виправлення — очистка списку:

/whitelist myRule clear
/blacklist myRule clear
Порада: Завжди перевіряйте regex на regex101.com (режим Python) перед застосуванням.

FloodWait / обмеження частоти

Якщо акаунт надсилає забагато повідомлень занадто швидко, Telegram може тимчасово обмежити його. Neon Forward сам чекає потрібний час і повторює спробу. Це серверне обмеження Telegram, його не обійти.