Skip to content

Latest commit

 

History

History
151 lines (105 loc) · 10.2 KB

README-RU.md

File metadata and controls

151 lines (105 loc) · 10.2 KB
Raw

Telegram Gifts Auto-Buyer

Этот user-bot автоматизирует процесс отправки подарков пользователям в Telegram. Бот отправляет подарки конкретным пользователям и может быть настроен для работы как с лимитированными, так и с обычными подарками. Также он управляется набором конфигураций, которые контролируют поведение бота, таких как лимит цены подарка, анонимность отправителя и многое другое.

Содержание

Общая конфигурация

SESSION

  • Описание: Путь к файлу сессии, используемому ботом для хранения данных сессии.
  • По умолчанию: "data/account"

API_ID & API_HASH

  • Описание: Ваши API ID и HASH для Telegram. Чтобы получить эти данные, необходимо создать приложение на сайте Telegram.

Настройки

INTERVAL

  • Описание: Интервал времени (в секундах) между каждым проверкой новых подарков.
  • По умолчанию: 10 Установите значение не менее 10, чтобы избежать ошибок подключения.

TIMEZONE

  • Описание: Часовой пояс, в котором работает бот. Используется для времени, логирования и других операций.
  • По умолчанию: "Europe/Moscow"

CHANNEL_ID

  • Описание: ID канала Telegram, в который бот будет отправлять уведомления о подарках или ошибках.

Файлы и пути данных

DATA_FILEPATH

  • Описание: Путь к файлу, в котором бот хранит историю отправленных подарков.
  • По умолчанию: "data/history.json"

Подарки и информация о пользователях

USER_ID

  • Описание: Список ID пользователей, которым бот будет отправлять подарки. Пользователи должны быть в контактах с ботом (т.е. бот и пользователь должны быть в одной группе или канале).

MAX_GIFT_PRICE

  • Описание: Максимально допустимая цена подарка. Бот будет отправлять только подарки, стоимость которых ниже этого лимита.
  • По умолчанию: 100

PURCHASE_NON_LIMITED_GIFTS

  • Описание: Если True, бот будет покупать неограниченные подарки, как только они появятся, при этом соблюдая лимит цены подарка.
  • По умолчанию: False

HIDE_SENDER_NAME

  • Описание: Если True, бот будет скрывать своё имя при отправке подарка пользователю.
  • По умолчанию: True

GIFT_IDS

  • Описание: Список конкретных ID подарков, которые бот будет отправлять. Этот параметр необязателен.

NUM_GIFTS

  • Описание: Количество подарков, которые вы хотите, чтобы бот купил. Одно количество для всех подарков!
  • По умолчанию: 1

Пользовательские настройки

Настройка

  • Вы можете изменять значения параметров USER_ID, MAX_GIFT_PRICE и PURCHASE_NON_LIMITED_GIFTS прямо в файле конфигурации, чтобы настроить, кому и какие подарки будет отправлять бот.
  • Установите PURCHASE_NON_LIMITED_GIFTS в False, если не хотите, чтобы бот автоматически покупал неограниченные подарки.

Как использовать

  1. Клонируйте или скачайте репозиторий.

  2. Убедитесь, что у вас установлен Python 3.10 или более поздняя версия.

  3. Установите зависимости, выполнив команду:

    pip install -r requirements.txt

  4. Отредактируйте файл .env, чтобы добавить ваши API данные, ID пользователей, ID подарков и другие настройки.

  5. Запустите бота:

    python main.py

Бот начнёт отправлять подарки в соответствии с настройками. Он будет проверять новые подарки через заданный интервал (INTERVAL) и отправлять их указанным пользователям. Уведомления будут отправляться в Telegram канал, указанный в CHANNEL_ID.

Проблемы

№1

AttributeError: 'Client' object has no attribute 'get_star_gifts'

  • Описание: Бот сталкивается с ошибкой AttributeError, которая указывает на отсутствие метода get_star_gifts в объекте Client.

  • Инфо: Эта ошибка возникает, когда установленная версия библиотеки pyrogram не включает метод get_star_gifts, что может быть связано с устаревшей или некорректной версией библиотеки.

    Решение 1: Переустановите последнюю версию pyrogram:

    Выполните следующую команду для обновления pyrogram:

    pip install --upgrade pyrogram

    Решение 2: Если проблема сохраняется после обновления, вы можете вручную заменить папку pyrogram folder:

    1. Скачайте pyrogram.zip.
    2. Перетащите папки из архива в следующий путь:

    Путь для замены::

    <your_project_directory>/venv/lib/pythonX.X/site-packages/pyrogram

    or

    C:\Users\User\AppData\Local\Programs\Python\{Python Version}\Lib\site-packages

    После замены папки перезапустите бота, и проблема, скорее всего, должна быть решена.

Лицензия

Этот проект лицензирован под лицензией MIT - см. файл LICENSE для подробностей.