🎁 Telegram Stars AutoGift для Starvell — продажа подарков Telegram без ручной работы

Telegram Stars AutoGift — модуль StarvellBot, который выдаёт покупателям на Starvell подарки Telegram (Gifts), оплачивая их звёздами ваших Telegram-аккаунтов. Бот определяет купленный лот, узнаёт @username получателя, выбирает аккаунт с достаточным балансом Stars, отправляет подарок (или целый набор) и сообщает покупателю результат. Если выдать не получилось, покупатель может сам оформить возврат командой.

✨ Возможности

📱 Добавление аккаунтов по номеру телефона прямо в Telegram-боте, с поддержкой облачного пароля (2FA).
🔑 Добавление по Session String — если у вас уже есть строка сессии.
👥 Пул аккаунтов: бот выбирает аккаунт с нужным балансом и при лимите Telegram (FloodWait) или ошибке досылает оставшиеся подарки с другого аккаунта.
🛍 Каталог подарков из Telegram — эмодзи, цена, превью и ID (новые подарки отмечены 🆕).
📦 Наборы — несколько подарков за одну единицу лота.
🔗 Привязка по ID лота Starvell и карточка лота с редактированием стоимости, подарков и названия.
💬 Текст к подарку и настраиваемое сообщение покупателю после выдачи.
✅ Автоподтверждение выполнения на Starvell сразу после отправки подарков.
🛡 Проверка баланса перед выдачей и автоотключение лотов, когда звёзд мало.
🔄 Возврат командой !вз, !бэк или !refund.
💰 Баланс звёзд по каждому аккаунту и суммарно.

🚦 Шаг 0. Как открыть панель

Панель модуля доступна командой /autogift (или ⚙️ Настройки → 🎁 Панель подарков в карточке модуля в /menu → 🧩 Функции). Настраивать прокси, ключи и аккаунты можно ещё до включения модуля.

Кнопка «Переключить (🟢 ON / 🔴 OFF)» в панели — это то же самое, что включение модуля в списке функций. Включить модуль можно, только когда указан прокси и добавлен хотя бы один аккаунт — иначе бот подскажет, чего не хватает.

ℹ️ Требование к серверу. Для отправки подарков нужна библиотека Kurigram (форк Pyrogram с методом отправки подарков). Если её нет, при включении бот пришлёт предупреждение, а включить модуль не даст. На хостинге starvellbot.com всё необходимое уже установлено.

/autogift
├─ Переключить (🟢 ON / 🔴 OFF)
├─ 📦 Мои лоты  |  ⚙️ Настройки
│    Мои лоты: карточка лота → 💰 стоимость · 🎁 подарки · 📝 название · 🗑 удалить
│    Настройки: 🌐 Proxy · 👥 Аккаунты TG · API Keys · 💬 Текст подарка ·
│               📝 Шаблон success-сообщения · 📉 Автовыкл. лотов · 🔢 Лимит деактивации ·
│               ✅ Автоподтверждение
├─ 💰 Проверить баланс
├─ 🛍 Каталог ID подарков
└─ ◀️ К функциям

Во всех окнах ввода есть 🚫 Отмена.

⚡ Быстрый старт

Получите API ID и API Hash на my.telegram.org (Часть 1).
Купите IPv4 HTTP-прокси.
/autogift → ⚙️ Настройки → 🌐 Proxy → отправьте прокси.
⚙️ Настройки → 1️⃣ Настроить API Keys → API ID, затем API Hash.
⚙️ Настройки → 👥 Аккаунты TG → ➕ Добавить TG аккаунт (по номеру).
Пополните звёзды на аккаунте (Telegram → Настройки → Мои звёзды).
🛍 Каталог ID подарков → скопируйте ID нужного подарка.
📦 Мои лоты → ➕ Добавить → ID лота Starvell → ID подарков → стоимость в звёздах.
💰 Проверить баланс — аккаунт подключён, звёзды видны.
Переключить → 🟢 ON.

🛠 Часть 1. Подготовка

1.1. API ID и API Hash

Зайдите на my.telegram.org → API development tools.
Заполните форму латиницей: App title (любое, например AutoGiftBot), Short name (например autogift123), URL http://localhost/, Platform Desktop.
Create application → скопируйте App api_id (цифры) и App api_hash.

Если сайт показывает «ERROR», попробуйте другой интернет (мобильный), режим инкогнито или VPN — это частый сбой самого Telegram.

1.2. Прокси (обязателен)

Все подключения модуля к Telegram идут только через ваш прокси.

IPv4 HTTP-прокси, лучше платный; стабильнее всего работают локации Германия и Нидерланды.
SOCKS не поддерживается.
Форматы: ip:port или login:pass@ip:port (http:// можно оставить — бот уберёт).

1.3. Аккаунты и звёзды

Подарки отправляются с ваших Telegram-аккаунтов за их звёзды.
Подарки одного заказа отправляются с одного аккаунта — балансы разных аккаунтов не складываются.
Используйте отдельные аккаунты под продажи. Session String даёт полный доступ к аккаунту — никому её не передавайте.

⚙️ Часть 2. Настройки

🌐 Proxy (Для Telegram)

Отправьте прокси сообщением → «✅ Прокси успешно сохранен!». Неверный формат — изменения отменяются. Отправьте -, чтобы удалить прокси: модуль при этом выключится.

💡 После смены прокси нажмите в панели Переключить дважды (выкл → вкл), чтобы все аккаунты переподключились через новый прокси.

1️⃣ API Keys

Бот попросит API ID (только цифры), затем API Hash. После сохранения кнопка называется 🔄 Изменить API Keys. Без ключей аккаунт добавить нельзя. Если после смены ключей аккаунты стали 🔴 — удалите и добавьте их заново.

👥 Аккаунты TG

Список аккаунтов со статусом: 🟢 подключён, 🔴 не подключён. Кнопки: 🗑 Удалить (срабатывает сразу, без подтверждения; если удалить последний аккаунт — модуль выключится), ➕ Добавить TG аккаунт (по номеру), 🔑 Добавить по Session String.

Способ А — по номеру (рекомендуется). Сначала настройте прокси и API Keys.

Пришлите номер в международном формате: +79991234567.
Telegram пришлёт код в приложение (чат «Telegram» на уже авторизованном устройстве).
Введите код через пробелы или дефисы: 1 2 3 4 5.

⚠️ Не отправляйте код слитно — Telegram считает код, отправленный в чат, скомпрометированным и аннулирует его. Бот сам удалит ваше сообщение с кодом.
Если включён облачный пароль — отправьте его. Сообщение удаляется, пароль нигде не хранится.
«✅ Аккаунт успешно добавлен!». На процедуру после отправки кода отводится 5 минут.

В списке устройств Telegram сессия отображается как «Starvell AutoGift».

Способ Б — Session String. Отправьте строку сессии Pyrogram одним сообщением — бот проверит вход через прокси. После этого удалите сообщение со строкой вручную.

Удаление аккаунта в боте не завершает сессию в Telegram. Чтобы отозвать доступ полностью, завершите сессию «Starvell AutoGift» в Настройки → Устройства на этом аккаунте. Не удаляйте аккаунты во время выдачи.

💬 Текст подарка

Комментарий, прикрепляемый к каждому подарку. - — отключить. Держите текст коротким: Telegram ограничивает длину подписи.

📝 Шаблон success-сообщения

Сообщение покупателю в чат Starvell после успешной выдачи. Бот покажет превью с тестовыми значениями и не сохранит шаблон с неизвестной переменной. ♻️ Сбросить к стандартному или - — вернуть исходный.

Переменная	Значение
`{tg_user}` / `{tg_user_at}`	имя получателя в Telegram / с `@`
`{order_id}`	номер заказа Starvell
`{buyer_id}`	ID покупателя на Starvell
`{total_sent}`	всего отправлено подарков
`{amount}`	количество единиц лота в заказе
`{gift_types}`	сколько разных подарков в лоте
`{star_cost}` / `{total_stars}`	стоимость 1 единицы / всего потрачено звёзд
`{price}`	цена заказа на Starvell

Стандартный шаблон: «✅ Успешно отправлено {total_sent} подарков пользователю {tg_user}! Заказ Starvell: #{order_id}. Пожалуйста, подтвердите выполнение.» HTML-теги перед отправкой удаляются. Фигурную скобку как символ пишите удвоенной: {{, }}.

📉 Автовыкл. лотов и 🔢 Лимит деактивации

Если функция включена (по умолчанию 🔴), после каждой выдачи бот проверяет максимальный баланс среди аккаунтов. Ниже лимита (по умолчанию 50⭐️) — бот выключает на Starvell все привязанные лоты, выключает модуль и присылает уведомление. После пополнения включите лоты на Starvell и модуль вручную. Лимит ставьте не ниже стоимости самого дорогого лота с запасом.

✅ Автоподтверждение

«Сразу после отправки подарков» (по умолчанию) или «Выключено». На Starvell покупатель подтверждает получение только после того, как продавец нажал «Подтвердить выполнение» — бот сделает это сам.

🏠 Часть 3. Главное меню

Сводка: Статус (🟢/🔴), Сессии (сколько аккаунтов подключено), Лотов.

💰 Проверить баланс:

⭐️ Балансы аккаунтов:
• Иван (@ivan): 350 ⭐️
• Пётр (@petr): Ошибка 🔴
📊 Общая сумма: 350 ⭐️
🏆 Максимальный (для 1 заказа): 350 ⭐️

Максимальный баланс определяет, какой заказ вы сможете выполнить.

🛍 Часть 4. Каталог ID подарков

Бот загружает актуальный список подарков с серверов Telegram (нужен хотя бы один подключённый аккаунт). Кнопки вида «🧸 15⭐️» — от дешёвых к дорогим, по 8 на странице. Нажмите на подарок — бот пришлёт превью, цену и ID для копирования. 🔄 Обновить — перезагрузить список (например, когда Telegram выпустил новый подарок).

В каталоге только обычные (нелимитированные) подарки — лимитированные и коллекционные модуль не отправляет.

📦 Часть 5. Мои лоты

Список: ⚙️ Название (N шт | M⭐️). Значок ⚠️ — стоимость не указана или требует проверки. Нажмите на лот, чтобы открыть карточку: 💰 Изменить стоимость · 🎁 Изменить подарки · 📝 Изменить название · 🗑 Удалить из привязок.

➕ Добавить:

ID лота Starvell или ссылка starvell.com/offers/ID. Бот найдёт лот и покажет его название.
ID подарков — один ID или несколько, каждый с новой строки (для набора). Один и тот же подарок можно указать несколько раз.
Стоимость в звёздах за 1 единицу лота (сумма всех подарков набора). Бот подскажет стоимость по каталогу Telegram, но введите её сами: цена лота на Starvell — это то, что платит покупатель, а не стоимость подарка.

⚠️ Не указывайте 0 — без стоимости бот не сможет проверить баланс перед выдачей.

Заказ сопоставляется по ID лота. Если ID есть, но не привязан — модуль заказ не трогает. По названию бот ищет, только если в заказе нет ID вовсе.

🚀 Часть 6. Как проходит заказ

Покупатель оплачивает привязанный лот. Покупатели из чёрного списка бота не обслуживаются.
@username. Если покупатель указал Telegram-юзернейм при оплате, бот берёт его сразу. Иначе просит прислать в чат: подойдут @username, t.me/username или просто username.
Заказ встаёт в очередь — выдача идёт строго по одному заказу.
Проверка баланса: нужно количество × стоимость. Подходят только аккаунты, где звёзд не меньше этой суммы.
Отправка со случайного подходящего аккаунта, с паузой около 1,5 секунды между подарками и вашим текстом подарка. При FloodWait или ошибке бот переходит на следующий аккаунт и досылает остаток, не дублируя уже отправленное.
Итог: success-сообщение покупателю и автоподтверждение выполнения (если включено).
После выдачи — проверка баланса для автоотключения лотов.

Сообщения при проблемах:

Ситуация	Что пишет бот
пользователь не найден	просит прислать корректный @username
ни на одном аккаунте не хватает звёзд	«Технические неполадки… напишите !вз для возврата» (вам — «⚠️ AutoGift: Нехватка звезд!»)
ошибка отправки	«Ошибка отправки: … Напишите !вз для возврата»
частичная отправка	«Отправлено частично (X/Y)»

Если заказ вернули на Starvell вручную, бот отменит его выдачу (если она ещё не началась). После перезапуска бота заказы, стоявшие в очереди, снова ожидают @username, а прерванные во время отправки помечаются для ручной проверки. Получатель мог запретить получение подарков в настройках приватности — тогда отправка завершится ошибкой.

🔄 Часть 7. Возвраты

Покупатель пишет в чат !вз, !бэк или !refund → бот оформляет возврат на Starvell, пишет «💸 Средства возвращены» и уведомляет вас.

Команда работает, пока подарки ещё не отправлены. Во время выдачи, после отправки хотя бы части подарков и после успешной выдачи бот ответит, что за возвратом нужно обратиться к продавцу, — такие заказы решайте вручную.

🛡 Часть 8. Когда бот выключает лоты

Включено 📉 Автовыкл. лотов и после выдачи максимальный баланс упал ниже лимита.
Все аккаунты поймали FloodWait во время выдачи — независимо от переключателя.

В обоих случаях бот выключает привязанные лоты на Starvell, выключает модуль и присылает уведомление («🛑 AutoGift: Отключение лотов!»). Заново лоты бот не включает — сделайте это вручную после пополнения или снятия ограничений и нажмите Переключить.

❓ Частые вопросы

«Неверный код» / код аннулируется при добавлении аккаунта. Код был отправлен слитно. Начните заново и введите новый код через пробелы: 1 2 3 4 5.

Код не приходит. Он приходит в приложение Telegram, а не по SMS. Проверьте прокси и API ID/Hash. При сообщении о большом числе попыток подождите указанное время.

Аккаунт отмечен 🔴. Подождите 5–10 секунд и откройте список заново. Проверьте, что модуль включён и прокси работает. Если сессия завершена в Telegram или сменились API Keys — удалите аккаунт и добавьте заново.

Каталог не загружается / «Нет подключенных клиентов». Нужен хотя бы один подключённый аккаунт (🟢) и включённый модуль.

Заказ оплачен, но бот ничего не делает. Проверьте: модуль 🟢 ON; лот привязан по ID; покупатель не в чёрном списке; покупатель прислал корректный @username.

«Не хватает звезд» при достаточном общем балансе. Подарки одного заказа отправляются с одного аккаунта. Пополните баланс одного из аккаунтов до нужной суммы.

Как пополнить звёзды? В Telegram на нужном аккаунте: Настройки → Мои звёзды. Модуль сам звёзды не покупает.