Интерфейс
👁🗨 Главное меню
Когда все настроено, сессии созданы и бот работает — переходим в TG и запускаем бота. Появится данное меню:

▶️ Запустить трекинг — кнопка, которая отвечает за запуск трекинга новых подарков
⚙️ Смена режима — свап между User и Bot API в любой момент
🌠 Баланс — переводит в меню для менеджмента звездами (для Bot API)
👥 Профили — переводит в меню менеджмента профилями
🧸 Мои подарки — действия с гифтами: трансферы, улучшения, скрытие и так далее
🧰 Инструменты — полезные действия, типа создания каналов и так далее
🔫 Купить текущие — покупка актуальных подарков на профили
🔍 Трекинг
Когда вы нажимаете на эту кнопку, то бот первым делом проверяет текущие подарки и добавляет их в базу данных. Он добавит как лимитированные, так и не лимитированные подарки, чтобы случайно их не купить
Понять статус трекинга можно по обозначениям OFF и ON, также этот статус переносится в текст над кнопками, поэтому не запутаетесь. На сервере раз в минуту будет приходить лог о том, что трекинг жив


⚙️Смена режима
Бот может работать сразу в двух вариантах — через User и Bot API. Поменять режим можно в любой момент во время работы кода
User API — использует MTProto и задействует баланс звезд на аккаунте
Bot API — обычное API, используется баланс бота
Оба режма работают отлично и берут подарки (исключением можно назвать отключение API для ботов, но тогда сервера просто легли из-за высокой нагрузки)


🌠 Баланс
Данная кнопка актуальна только для режима Bot API, так как при User API звезды тратятся с баланса аккаунта. Следовательно пополнять и снимать звезды можно только со счета обычного бота
Чтобы бот мог покупать подарки — ему надо пополнить звезды на счет. Когда нажмете на кнопку, то появится меню с двумя кнопками. Для пополнения указывайте целое число

Имейте в виду, что вывести можно только ту сумму, которую пополнили. Допустим если вы пополнили баланс на 10.000 звезд по 5.000 звезд и потратили на подарки 4.000 звезд, то вывести можете потом только 5.000 по одной из прошлых транзакций (либо к оставшимся 6.000 звездам депаете 4.000 звезд и выводите по 5.000 звезд через две прошлые транзакции)
Также, если случайно удалили БД, можно использовать команду /ref {хеш_транзакции}. Хеш можете взять в истории пополнений у бота. Для этого открываем профиль бота, кликаем на баланс его звездочек и ищем нужную транзакцию


👥 Профили
Благодаря профилям можно гибко настроить снайпинг подарков. Работает это так — создаешь новый профиль, указываешь фильтры (цена, саплай), указываешь кто получатель и далее указываешь сколько покупок надо совершить

При первом запуске у вас не будет профилей. Чтобы создать новый — жмем "➕ Создать профиль" и у нас появляется меню с информацией по фильтрам:
▶️ Запустить / ⏸️ Остановить — профиль активен или нет
⭐️ Цена ОТ /⭐️ Цена ДО — цены за подарки в звездах
📦 Саплай ОТ / 📦 Саплай ОТ — общее кол-во подарков
🛒 Покупок — сколько совершать покупок на профиль
🎯 Получатель — можно выбрать получателя (канал или юзер)
👥 Сменить название — можно указать нейм профилю
🧪 Тестовая покупка — нужно для проверки, купит один подарок за 15 звезд
🗑️ Удалить — удалит профиль из базы данных
Профили можно быстро настроить через вкладку "Инструменты" и функцию создания каналов
Важно: при указании получателя убедитесь, что:
для канала: бот находится на канале и является администратором
для пользователя: что юзер запустил данного бота, где вы делаете профиль

🧸 Мои подарки
Данный раздел находится в процессе разработки, но часть полезных функций уже создана. При нажатии на кнопку ваши текущие подарки сначала закешируются, чтобы в будущем быстро работать с ними. После кеширования появится меню с полной информацией:

Описание текста
Типы — разделение по категориям подарков
Уникальные — уже улучшенные подарки
Редкие — подарки, на которые еще не вышел апгрейд
Обычные — это медведи, цветы и так далее
Улучшение — показывает сколько подарков можно улучшить
Видимость — показывает сколько скрытых и видимых подарков
Описание кнопок
♻️ Обновить кэш — если появились новые подарки, то данная кнопка обновит кэш
👨👦 Трансфер — массовый трансфер подарков выбранному пользователю или каналу
🎦Скрытие — позволяет скрыть или раскрыть подарки в профиле
👨👦 Про трансфер
Отдельно хочу обратить внимание на меню трансфера. В будущем для этой функции будет создан веб-интерфейс, однако уже сейчас пользоваться этим очень удобно.
Вот, как происходит трансфер
Первым делом нужно будет выбрать получателя. Это может быть или юзер (релееры подарков) или же канал. В списке представлены актуальные профили релееров:

После выбора получателя нужно будет выбрать подарки. Можно выбирать как единичные, так и все подарки сразу. Дополнительно можно выбирать отдельные коллекции:

После выбора подарков и получателя нажимаете продолжить и бот выдаст информацию о том, за какие подарки нужно заплатить комиссию 25 звезд за трансфер:

Если цена за комиссию устраивает и баланс достаточный, то бот начнет отправлять эти подарки выбранному получателю. Если встретится подарок, на котором стоит ограничение в 21 день, то бот уведомит.
Так выглядят логи:

🧰 Инструменты
В этот раздел будут добавляться полезные функции. Сейчас готовы две - для создания каналов под профили и функция получения пиров

Вот описание кнопок и для чего они нужны
*️⃣ Каналы — чтобы руками не создавать каналы и не добавлять туда бота можно просто запустить данную функцию, выбрать нужное имя и количество каналов и создать их. Настроенные каналы автоматически добавляются в профили, где можно настроить фильтры и кол-во покупок
🔢 Прогрев — благодаря данной функции можно получить все диалоги и получить их пиры. Очень часто возникают ошибки, связанные с PEER_ID_INVALID. Данный "прогрев" как раз таки и исключает шанс появления ошибки
🎯 Текущие
Эта функция нужна для покупки уже релизнутых лимитированных подарков. Обычные подарки также можно покупать, но для того, чтобы протестировать бота под фейковой нагрузкой. Учтите, что звезды будут тратиться и вернуть их не получится
Для использования — выбираем подходящий подарок. Бот отправит превью того, как он выглядит, а также напишет все данные по нему (цена, саплай, айди)

Далее выбираем нужные нам профили. Крестиком помечаются невыбранные профили, галочкой выбранные. Выбирать можно как активные, так и неактивные. Покупка будет в обход указанных в профиле фильтров, но купится ровно столько, сколько было указано в профиле

После того как все выбрали — внимательно проверяем данные и запускаем покупку. Не забывайте добавлять бота на каналы для покупки

Last updated