Интерфейс

👁‍🗨 Главное меню

Когда все настроено, сессии созданы и бот работает — переходим в 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