Руководство по настройке Telegram-бота

Это руководство поможет вам настроить Telegram-бота, используя API Telegram и BotFather. Следуйте инструкциям ниже, чтобы получить необходимые данные и настроить бота.

---

1. Получение API ID и API Hash

1. Перейдите на my.telegram.org и войдите в систему, используя свой номер телефона и код подтверждения из Telegram.
2. Нажмите на "API development tools".
3. Введите имя вашего приложения и краткое описание.
4. Укажите платформу, например, "Desktop" или "Web".
5. Нажмите "Create application".
6. Скопируйте api_id и api_hash. Эти данные понадобятся для настройки бота.

---

2. Получение Bot Token

1. Откройте Telegram и найдите @BotFather.
2. Отправьте команду /newbot и следуйте инструкциям для создания нового бота.
3. После создания бота вы получите bot_token. Скопируйте его.

---

3. Инициализация переменных .env

Создайте файл .env в корне вашего проекта и добавьте в него следующие переменные, заменив значения на свои:

API_ID=your_api_id
API_HASH=your_api_hash
BOT_TOKEN=your_bot_token

---

4. Доступные команды

Команды, требующие прав администратора в супергруппе:

• /activate — включить бота в текущем чате. Бот должен быть администратором в супергруппе.

• /deactivate — выключить бота в текущем чате. Бот должен быть администратором в супергруппе.

• /whitelist_add [username] — добавить пользователя в вайт-лист. Укажите юзернейм с @ или без него.

• /whitelist_remove [username] — удалить пользователя из вайт-листа. Укажите юзернейм с @ или без него.

Команды, доступные всегда:

• /info — список команд.

• /start — работает только в личном чате с ботом. Выводит текст с пояснением того, что умеет бот.

• /whitelist_show — показать список пользователей в вайт-листе.

• /approve_kick — подтверждение кика пользователей из предложенного ботом списка.

---

5. Активация и деактивация бота

• /activate — бот проверяет, является ли чат супергруппой и есть ли у него права администратора. Если условия выполнены, бот активируется и начинает выполнять свои функции (например, сравнивание списков чатов).

• /deactivate — бот проверяет те же условия, что и при активации, и деактивируется, переставая выполнять свои функции. При деактивации взаимодействие с вайт-листом недоступно.