TELEGRAM GIFTS Soft Guide

1) Установка Node.js 23.0.0

Node.js нужна для запуска фронта и бэкенда нашего софта.

Перейдите по ссылке: Node.js Downloads.
Выберите версию 23.0.0 (или выше) для вашей платформы. (Версия может быть другая, главное, чтобы первое число было 23 или больше. Например версия 23.0.0 вам тоже подойдет)
Скачайте и установите.

Проверка установки:

Откройте терминал и введите команду:

node -v

Если всё хорошо, вы увидите версию установленной Node.js.

Запуск софта

На Windows

Откройте папку с софтом.
Найдите файл start-all.bat и дважды кликните по нему.
Начнётся запуск софта. Откроются два терминала:Первый запускает локальный сервер с бэкендом.
Второй запускает локальный сервер с фронтендом.
Откройте в браузере страничку по адресу URL: http://localhost:4200

На Mac

Откройте терминал и перейдите в корневую папку софта.
Выполните команду:

sh ./start-all.sh

Альтернативный способ на Mac через VSCode:

Откройте VSCode.

Откройте папку с софтом.

Найдите файл start-all.sh, откройте его и нажмите "Запустить".

Важно: Рекомендуется использовать браузер Chrome для работы с локальным приложением на Mac, так как в Safari могут быть ошибки отображения.

Авторизация на бекенде (ВАЖНО)

При запуске бота у вас в консоли бека надо будет ввести ваш тг логин, с которого вы купили софт
Далее вы переходите в бота авторизации в телеграмм @RektblockAuth_bot
Запрашиваете в боте код для входа
Вводите в консоль на бекенде полученный код
бекенд запущен

Обзор софта и первые настройки

Вкладки софта

1. Accounts (Аккаунты)

Управление Telegram аккаунтами.

Содержимое:Таблица со списком аккаунтов (телефон, баланс звезд, статус)
Кнопка добавления нового аккаунта
Кнопки аутентификации для неавторизованных аккаунтов
Кнопки обновления баланса и удаления аккаунтов
Функции:Добавление аккаунта с API ID и API Hash из my.telegram.org
Аутентификация через код из Telegram (поддержка 2FA)
Просмотр текущего баланса звезд
Удаление ненужных аккаунтов

2. Channels (Каналы)

Управление каналами для хранения подарков.

Содержимое:Список каналов, сгруппированных по аккаунтам
Информация по каждому каналу: название, количество подарков, статус
Кнопки создания одиночных и массовых каналов
Кнопки синхронизации и обновления каналов
Функции:Создание одного канала с указанным названием
Массовое создание пустых каналов (до 50 штук)
Синхронизация существующих каналов из Telegram
Просмотр подарков внутри канала
Удаление каналов

3. Configs (Конфигурации)

Настройка правил автоматической покупки.

Содержимое:Список созданных конфигураций
Форма создания/редактирования конфигурации
Настройки диапазонов подарков (Gift Ranges)
Структура конфигурации:Название конфигурации
Выбор целевых каналов из списка доступных
Опции покупки (покупать неограниченные, только с апгрейдом)
Максимальное количество параллельных покупок
Gift Ranges (правила покупки):Диапазон цен (минимум - максимум в звездах)
Диапазон количества (минимум - максимум доступных)
Количество для покупки
Приоритет (1-10, выше число - выше приоритет)
Цель покупки (на аккаунт или распределить по каналам)
Количество подарков на канал (если покупка в каналы)

4. Monitor (Мониторинг)

Центр управления автоматической покупкой.

Содержимое:Форма добавления монитора (выбор аккаунта и конфигурации)
Таблица активных мониторов
Лог событий в реальном времени
Список последних обнаруженных подарков
История покупок
Информация по мониторам:Master аккаунт (отмечен значком короны)
Используемый аккаунт и конфигурация
Статус работы
Количество покупок и потраченных звезд
Количество ошибок
Время последней проверки

Процесс работы:Добавляется монитор (связка аккаунт + конфигурация)
Первый монитор становится master и проверяет новые подарки
При обнаружении нового подарка все мониторы покупают параллельно
Каждый монитор использует свою конфигурацию для покупки

5. Manual Purchase (Ручная покупка)

Покупка подарков без автоматизации.

Содержимое:Выпадающий список доступных подарков с превью
Выбор аккаунта для покупки
Выбор цели (профиль или канал)
Поле ввода количества
Информация о стоимости покупки
Результат последней покупки

Процесс покупки:Выбирается подарок из списка доступных
Выбирается аккаунт с достаточным балансом
Указывается цель (свой профиль или один из каналов)
Вводится количество для покупки
Нажимается кнопка покупки

Пошаговая настройка

Шаг 1. Добавление Telegram аккаунта

Перейдите на вкладку Accounts
Нажмите кнопку Add Account
В открывшейся форме введите:

Phone Number - номер телефона в международном формате (+7...)
API ID - получить на my.telegram.org
API Hash - получить на my.telegram.org

Нажмите Add Account

Шаг 2. Аутентификация аккаунта

В списке аккаунтов найдите добавленный аккаунт
Нажмите кнопку Authenticate напротив аккаунта
В открывшемся окне нажмите Send Code
Введите код из Telegram в поле Verification Code
Если у вас включена двухфакторная аутентификация, введите пароль в поле Two-Factor Password
Нажмите Authenticate
После успешной аутентификации аккаунт покажет баланс звезд

Шаг 3. Создание каналов для хранения подарков

Перейдите на вкладку Channels
Нажмите кнопку Create Empty Channels
В форме укажите:

Account - выберите аутентифицированный аккаунт
Number of Channels - количество каналов (рекомендуется 5-10)
Channel Name Template - шаблон названия (например, "Gift Storage")

Нажмите Create Channels
Дождитесь создания каналов (займет несколько секунд)

Шаг 4. Создание конфигурации покупки

Перейдите на вкладку Configs
Нажмите кнопку Create Config
Заполните основные настройки:

Config NameНазвание конфигурации для удобной идентификации
Используется только для отображения в списке
Примеры: "Редкие подарки", "Массовая скупка", "Дешевые подарки"
Target ChannelsСписок каналов, куда будут отправляться купленные подарки
Выбираются из списка ваших пустых каналов
Если не выбрано ни одного канала, подарки будут покупаться только на аккаунт
Purchase Non-LimitedОпределяет, покупать ли неограниченные подарки
Включено: покупает как ограниченные, так и неограниченные подарки
Выключено: покупает только ограниченные подарки (с конечным количеством)
Max Concurrent PurchasesМаксимальное количество одновременных покупок
Ограничивает нагрузку на аккаунт
Рекомендуемое значение: 5

Шаг 5. Настройка правил покупки (Gift Ranges)

В той же форме конфигурации настройте правила покупки. Каждое правило определяет, какие подарки покупать и в каком количестве.

Min Price / Max PriceДиапазон цен подарков в звездах Telegram
Min Price: минимальная цена подарка для покупки
Max Price: максимальная цена подарка для покупки
Система будет покупать только подарки, цена которых находится в этом диапазоне
Min Supply / Max SupplyДиапазон доступного количества подарков
Min Supply: минимальное количество подарков в наличии для срабатывания правила
Max Supply: максимальное количество подарков в наличии для срабатывания правила
Используется для фильтрации подарков по редкости (меньше количество = более редкий)
Purchase QuantityКоличество подарков для покупки при срабатывании правила
Указывает сколько штук купить, если подарок подходит под все условия
Система попытается купить именно это количество
PriorityПриоритет правила (число от 1 и выше)
Чем выше число, тем выше приоритет
При появлении нескольких подходящих подарков одновременно, первыми покупаются подарки по правилам с высшим приоритетом
Правила с одинаковым приоритетом выполняются параллельно
Purchase to AccountОпределяет куда отправлять купленные подарки
Включено: подарки покупаются на основной аккаунт (в профиль)
Выключено: подарки распределяются по выбранным каналам
Gifts per ChannelКоличество подарков для отправки в один канал
Работает только если Purchase to Account выключено
Определяет как распределять подарки между каналами
Если подарков больше чем каналов × gifts_per_channel, остаток идет в последний канал

Для добавления дополнительных правил нажмите Add Gift Range. Можно создать неограниченное количество правил с разными параметрами.

После настройки всех правил нажмите Save Config

Шаг 6. Запуск мониторинга

Перейдите на вкладку Monitor
В разделе Add Monitor выберите:

Account - ваш аутентифицированный аккаунт
Configuration - созданную конфигурацию

Нажмите Add Monitor
Монитор появится в списке Active Monitors и начнет работу
Первый добавленный монитор автоматически станет Master (с иконкой короны)