Руководство по плагину Telegram Gifts

Продавайте Telegram-подарки на FunPay без ручной работы. Лот привязывается к подарку по слову в названии. После оплаты бот берёт @username получателя из заказа или спрашивает у покупателя, проверяет, что такой пользователь есть в Telegram, и после подтверждения «+» отправляет подарок за звёзды. Аккаунтов с подарками может быть несколько: подарок уходит с того, где больше звёзд, а при FloodWait или нехватке звёзд — со следующего. Перед отправкой бот проверяет, что заказ всё ещё оплачен и звёзд хватает на весь заказ. Всё управление — кнопками в панели /gifts.

🎯 Для чего это нужно

1. Подарки без ручной работы: от оплаты до подарка в Telegram — без вас.
2. Не отправите не тому: бот проверяет @username и ждёт подтверждения «+».
3. Продажи не встают: пул аккаунтов обходит FloodWait и нехватку звёзд, а при сбое Telegram лоты снимаются сами.

✨ Что умеет плагин

• Панель кнопками: продажи вкл/выкл, мои лоты, настройки, баланс, статистика, каталог ID подарков
• Три режима лота: один подарок, набор (несколько разных подарков за 1 лот) или выбор покупателя из ваших вариантов
• Подпись и анонимность: ваши, без них или на выбор покупателя — бот спросит его в чате
• Аккаунты Telegram — по номеру телефона, по QR-коду (без кода — если аккаунт тот же, с которого вы пишете боту) или строкой сессии Telethon
• Пул аккаунтов: подарок уходит с аккаунта, где больше звёзд; Telegram просит подождать (FloodWait) или кончились звёзды — со следующего
• Звёзд на весь заказ проверяем до отправки — никакой частичной выдачи из-за баланса
• Перед отправкой — проверка, что заказ ещё оплачен (не возврат и не спор)
• @username из заказа: покупатель указал ник при оплате — бот берёт его сам
• Подтверждение «+» перед отправкой или «Отправка без +»
• Возврат по !вз: пока подарок не отправлен, покупатель оформляет возврат сам
• Автовозврат, если не ушло ни одного подарка
• Нет связи с Telegram 10 минут или звёзд меньше порога — лоты подарков снимаются с продажи и возвращаются сами
• Каталог подарков с ID и ценой, привязка лота к подарку кнопками, уведомление о новых подарках Telegram
• Свой текст покупателю после отправки, подпись к подарку, анонимная отправка
• Статистика: выдано, ошибки, возвраты, последние заказы; заказы, которые уже вернули, сами уходят из очереди

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

1. Включите плагин и перезапустите бота (шаг 1 ниже).
2. Укажите свой прокси для Telegram.
3. Подключите аккаунт Telegram: ключи с my.telegram.org, затем номер, QR-код или строка сессии.
4. Привяжите лоты к подаркам.
5. Проверьте тестовым заказом.

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

ШАГ 1. Включите плагин (обязательно перед настройкой)

1. Отправьте своему боту команду /menu.
2. Откройте 🔧 Система и Конфиги → 🧩 Плагины и найдите Telegram Gifts.
3. Нажмите «Включить».
4. ‼️ Перезапустите бота командой /restart — без перезапуска плагин не заработает.

ШАГ 2. Шаг 0. Прокси

1. Из России Telegram недоступен, поэтому аккаунты с подарками работают через ваш прокси. Купите индивидуальный IPv4 за границей (HTTP или SOCKS5) — общий на несколько человек не подойдёт.
2. /gifts → ⚙️ Настройки → 🌐 Прокси для Telegram → пришлите http://логин:пароль@IP:порт — сообщение сразу удалится.

ШАГ 3. Шаг 1. Аккаунты

1. ⚙️ Настройки → 👥 Аккаунты Telegram → «➕ Добавить TG аккаунт (по номеру)» → номер телефона аккаунта, с которого пойдут подарки. Есть строка сессии Telethon — «🔑 Добавить по Session String».
2. Ключи Telegram — свои: зайдите на my.telegram.org с аккаунта для подарков → API development tools → создайте приложение (название любое) и пришлите api_id api_hash. Мастер входа сам попросит их перед первым входом; поменять — ⚙️ Настройки → 🔑 Ключи API.
3. Код из Telegram пришлите через дефис (1-2-3-4-5), затем облачный пароль, если он включён. Код и пароль бот сразу удаляет из переписки.
4. Аккаунтов можно добавить несколько — они работают пулом.

ШАГ 4. Шаг 2. Лоты

1. 📦 Мои лоты → ➕ Привязать лоты → слово из названия лотов, например «мишка» → режим: 🎁 один подарок, 🎁🎁 набор или 🔀 выбор покупателя → подарки кнопками.
2. 🎁 Каталог ID подарков — все подарки Telegram с ценой в звёздах и ID.

ШАГ 5. Шаг 3. Настройки и проверка

1. ⚙️ Настройки: подпись и анонимность (ваши, без них или на выбор покупателя), ник из заказа, отправка без «+», текст после отправки, снятие лотов при нехватке звёзд, возврат по !вз.
2. Купите свой лот с другого аккаунта FunPay и пройдите путь покупателя.

🕹️ Меню и кнопки

Панель /gifts

• Продажи: 🟢 включены / 🔴 выключены — принимать ли заказы на подарки
• 📦 Мои лоты — привязки лотов к подаркам: «➕ Привязать лоты», «✅ Включить все лоты», «⛔ Выключить все»
• ⚙️ Настройки — прокси, аккаунты, ключи API, подпись, анонимность, возвраты, мониторинг
• 💰 Проверить баланс — звёзды на каждом аккаунте
• 🎁 Каталог ID подарков — все подарки Telegram с ценой в звёздах и ID
• 📊 Статистика — выдано, ошибки, возвраты, последние заказы

⚙️ Настройки

• 🌐 Прокси для Telegram — ваш прокси за границей — без него аккаунты не подключатся
• 👥 Аккаунты Telegram (N шт.) — «➕ Добавить TG аккаунт (по номеру)», «📷 Добавить по QR-коду», «🔑 Добавить по Session String», «🗑 Удалить»
• 🔑 Ключи API: 🟢 заданы / 🔴 не заданы — api_id и api_hash с my.telegram.org
• 💬 Подпись · ✏️ Моя подпись · 🙈 Анонимно — подпись к подарку и анонимность: ваши, без них или на выбор покупателя
• 👤 Ник из заказа — брать @username из параметров заказа
• ➕ Отправка без «+» — отправлять без подтверждения покупателя
• 📉 Снимать лоты, когда мало звёзд · 🔢 Порог звёзд — выключать лоты подарков, когда звёзд меньше порога
• ↩️ Возврат при ошибке отправки — вернуть деньги, если не ушло ни одного подарка
• ↩️ Возврат по !вз — покупатель может оформить возврат сам, пока подарок не отправлен
• 🩺 Мониторинг связи с Telegram — снимать лоты, если нет связи с Telegram 10 минут

🔄 Как это работает

1. Оплачен лот с привязанным словом в названии — бот берёт @username из заказа или спрашивает у покупателя.
2. Проверяет, что такой пользователь есть в Telegram, и просит подтвердить «+» (если не включена «Отправка без +»).
3. Проверяет, что заказ ещё оплачен и звёзд хватает на весь заказ.
4. Отправляет подарок с аккаунта, где больше звёзд; FloodWait или нехватка — со следующего.
5. Пишет покупателю ваш текст после отправки, вам — итог в статистику.

⌨️ Команды

• /gifts — панель: продажи, лоты, настройки, баланс, каталог, статистика
• /gifts_list — каталог подарков Telegram с ID и ценой
• /gifts_lot — привязать лоты к подарку: /gifts_lot мишка 5170145012310081615
• !вз — покупатель в чате FunPay: возврат, пока подарок не отправлен

💡 Важно знать

• ⚠️ Ключи API, прокси и аккаунт — только ваши: общих ключей сервиса нет, чтобы ограничение Telegram у одного продавца не остановило подарки у всех.
• Код из Telegram присылайте через дефис (1-2-3-4-5): код, отправленный сообщением как есть, Telegram сбрасывает.
• Отправленный подарок не вернуть — включайте «Отправку без +», только если уверены в покупателях.

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

Можно войти со своего основного аккаунта?

Можно, но безопаснее завести для подарков отдельный аккаунт, на котором только звёзды для продажи: бот хранит сессию входа, а подарки уходят с баланса этого аккаунта.

Что такое FloodWait?

Защита Telegram от спама: если аккаунт отправляет подарки слишком часто, Telegram просит подождать и на это время ничего с него не принимает. Обойти это нельзя, поэтому с несколькими аккаунтами бот отправляет подарок с другого, пока первый ждёт.

Зачем несколько аккаунтов?

Telegram ограничивает частые отправки (FloodWait), а звёзды на одном аккаунте кончаются. С пулом заказ уходит с другого аккаунта, а аккаунт с FloodWait отдыхает столько, сколько сказал Telegram.

Зачем свой прокси?

С серверов в России Telegram недоступен. А если много аккаунтов входят с одного адреса, Telegram относится к ним с подозрением, поэтому у каждого продавца прокси свой.

Покупатель оформил несколько заказов подряд?

Бот выдаёт их по очереди: спрашивает @username по первому заказу, отправляет подарок и переходит к следующему.

Что если покупатель ошибся в нике?

До подтверждения «+» он может написать другой @username. Отправленный подарок не вернуть, поэтому бот и просит подтверждение — «Отправку без +» включайте, только если уверены в покупателях.

Что будет, если Telegram недоступен или кончились звёзды?

Через 10 минут без связи (или когда звёзд меньше порога, если это включено) бот снимет лоты подарков с продажи и сообщит вам. Когда всё наладится, включит их сам.