Andrew K. Choi
57d7c9ace3
- Создан модуль userbot_auth.py для управления авторизацией через Telethon - Добавлены обработчики для всех этапов авторизации (номер, SMS, 2FA) - Интегрирована авторизация в меню UserBot - Добавлена кнопка 🔐 Авторизация в главное меню UserBot - Полная обработка ошибок и подробные сообщения пользователю - Сессии сохраняются безопасно в PostgreSQL - Документация с примерами использования Этапы авторизации: 1. Пользователь нажимает 🔐 Авторизация в меню UserBot 2. Вводит номер телефона в формате +XX-XXX-XXX-XXXX 3. Получает SMS с кодом подтверждения (5 цифр) 4. При необходимости вводит пароль 2FA 5. Сессия автоматически сохраняется и UserBot готов к работе
226 lines
10 KiB
Markdown
226 lines
10 KiB
Markdown
# 🔐 Интерактивная авторизация UserBot в боте
|
||
|
||
Теперь авторизация UserBot происходит прямо в интерфейсе Telegram бота, без необходимости использования терминала или скриптов!
|
||
|
||
## 🚀 Как авторизоваться
|
||
|
||
### Шаг 1: Откройте бота
|
||
Отправьте команду `/start` вашему боту @gongeeauto_bot
|
||
|
||
### Шаг 2: Перейдите в UserBot
|
||
Нажмите кнопку **🤖 UserBot** в главном меню
|
||
|
||
### Шаг 3: Откройте авторизацию
|
||
Нажмите кнопку **🔐 Авторизация**
|
||
|
||
Вы увидите текущий статус авторизации:
|
||
- ✅ **Авторизован** - UserBot уже готов к работе
|
||
- ❌ **Не авторизован** - Требуется авторизация
|
||
|
||
### Шаг 4: Начните авторизацию
|
||
Нажмите кнопку **🚀 Начать авторизацию**
|
||
|
||
### Шаг 5: Введите номер телефона
|
||
Напишите номер телефона вашего аккаунта Telegram в формате:
|
||
|
||
```
|
||
+7 (999) 123-45-67
|
||
```
|
||
|
||
Примеры:
|
||
- 🇷🇺 **Россия**: +79991234567
|
||
- 🇰🇷 **Южная Корея**: +82101234567
|
||
- 🇺🇸 **США**: +11234567890
|
||
|
||
После ввода номера бот отправит SMS с кодом подтверждения.
|
||
|
||
### Шаг 6: Введите SMS-код
|
||
Как только вы получите SMS с кодом (обычно это 5 цифр), отправьте его боту.
|
||
|
||
Пример: `12345`
|
||
|
||
### Шаг 7: Двухфакторная аутентификация (если требуется)
|
||
Если в вашем аккаунте включена двухфакторная аутентификация, вас попросят ввести пароль.
|
||
|
||
Введите пароль, который вы установили в настройках Telegram.
|
||
|
||
### Шаг 8: Готово! ✅
|
||
После успешной авторизации вы увидите сообщение:
|
||
```
|
||
✅ Авторизация успешна!
|
||
|
||
Ваш UserBot авторизован и готов к работе.
|
||
```
|
||
|
||
Теперь вы можете использовать все функции UserBot:
|
||
- 📥 **Собрать группы** - получить список всех ваших групп
|
||
- 👥 **Собрать участников** - парсить участников выбранной группы
|
||
- ⚙️ **Настройки** - проверить статус и переавторизоваться
|
||
|
||
---
|
||
|
||
## ℹ️ Часто задаваемые вопросы
|
||
|
||
### 1️⃣ Безопасна ли авторизация?
|
||
Да! Авторизация полностью безопасна:
|
||
- ✓ Процесс авторизации происходит локально на сервере
|
||
- ✓ Ваш пароль не передается нигде
|
||
- ✓ Сессия сохраняется в зашифрованном виде
|
||
- ✓ Доступ имеет только этот бот
|
||
|
||
### 2️⃣ Что может делать UserBot после авторизации?
|
||
✓ Собирать информацию о ваших группах
|
||
✓ Получать список участников группы
|
||
✓ Сохранять данные в базу данных
|
||
✓ Работать 24/7 без вашего участия
|
||
|
||
### 3️⃣ Что НЕ может делать UserBot?
|
||
✗ Отправлять сообщения от вашего имени
|
||
✗ Удалять или изменять ваши сообщения
|
||
✗ Изменять настройки групп
|
||
✗ Получать доступ к приватным чатам других пользователей
|
||
|
||
### 4️⃣ Как долго длится авторизация?
|
||
Обычно 3-5 минут:
|
||
- 30 секунд - отправка номера
|
||
- 1-3 минуты - ожидание SMS-кода
|
||
- 30 секунд - ввод кода и завершение
|
||
|
||
### 5️⃣ Что делать, если не приходит SMS-код?
|
||
1. Убедитесь, что номер введен верно (с кодом страны)
|
||
2. Проверьте, не заблокирован ли приём SMS
|
||
3. Подождите 1-2 минуты
|
||
4. Нажмите "Начать авторизацию" заново
|
||
5. Попробуйте другой номер, если у вас их несколько
|
||
|
||
### 6️⃣ Как переавторизоваться?
|
||
1. Откройте меню **🔐 Авторизация**
|
||
2. Нажмите **🔄 Переавторизоваться**
|
||
3. Следуйте шагам авторизации заново
|
||
|
||
### 7️⃣ Что если я выключу бота или перезагружу сервер?
|
||
✓ Ваша сессия сохранится
|
||
✓ UserBot автоматически подключится при следующем запуске
|
||
✓ Переавторизация не потребуется
|
||
|
||
### 8️⃣ Могу ли я авторизовать несколько аккаунтов?
|
||
В текущей версии - один аккаунт на сервер. Но вы можете:
|
||
- Авторизовать разные аккаунты в разное время
|
||
- Использовать несколько экземпляров бота для разных аккаунтов
|
||
|
||
### 9️⃣ Как отмена авторизации во время процесса?
|
||
Просто отправьте команду `/cancel` или нажмите на кнопку отмены (если она появится).
|
||
|
||
### 🔟 Есть ошибка при авторизации?
|
||
Ошибки и решения:
|
||
- **"Неверный номер телефона"** - проверьте формат номера
|
||
- **"Код подтверждения истекся"** - начните авторизацию заново
|
||
- **"Требуется двухфакторная аутентификация"** - введите свой пароль Telegram
|
||
- **"Сессия потеряна"** - начните авторизацию заново
|
||
|
||
---
|
||
|
||
## 📱 Номера для быстрого добавления
|
||
|
||
Если хотите авторизовать другой номер:
|
||
1. Сохраните номер в свои контакты
|
||
2. Напишите команду `/start` боту
|
||
3. Перейдите в авторизацию
|
||
4. Выберите номер из контактов
|
||
|
||
---
|
||
|
||
## 🎯 Следующие шаги после авторизации
|
||
|
||
После успешной авторизации вы можете:
|
||
|
||
### 1. Собрать все свои группы
|
||
```
|
||
🤖 UserBot → 📥 Собрать группы
|
||
```
|
||
Бот найдет все группы, в которых вы состоите, и сохранит информацию о них.
|
||
|
||
### 2. Парсить участников группы
|
||
```
|
||
🤖 UserBot → 👥 Собрать участников
|
||
```
|
||
Выберите группу и бот соберет список всех участников.
|
||
|
||
### 3. Проверить статус
|
||
```
|
||
🤖 UserBot → ⚙️ Настройки
|
||
```
|
||
Проверьте информацию о статусе и настройках UserBot.
|
||
|
||
---
|
||
|
||
## ⚠️ Важные замечания
|
||
|
||
1. **Используйте личный номер** - аккаунт должен быть вашим личным
|
||
2. **Не теряйте доступ к номеру** - без SMS вы не сможете переавторизоваться
|
||
3. **Сохраняйте пароль** - если у вас включена 2FA, он потребуется при авторизации
|
||
4. **Регулярно проверяйте статус** - используйте меню ⚙️ Настройки
|
||
|
||
---
|
||
|
||
## 🔗 Полезные команды
|
||
|
||
| Команда | Описание |
|
||
|---------|---------|
|
||
| `/start` | Запустить бота и открыть главное меню |
|
||
| `/help` | Помощь и информация о доступных команд |
|
||
| `/cancel` | Отмена текущей операции |
|
||
|
||
---
|
||
|
||
## 💡 Советы для успешной авторизации
|
||
|
||
✅ **Do's** (Делайте):
|
||
- Используйте корректный номер с кодом страны
|
||
- Убедитесь, что у вас есть доступ к SMS
|
||
- Используйте свой личный аккаунт Telegram
|
||
- Проверяйте статус авторизации в ⚙️ Настройки
|
||
|
||
❌ **Don'ts** (Не делайте):
|
||
- Не используйте чужие номера
|
||
- Не закрывайте диалог с ботом во время авторизации
|
||
- Не пытайтесь авторизовать несколько аккаунтов одновременно
|
||
- Не передавайте SMS-код никому
|
||
|
||
---
|
||
|
||
## 📞 Если что-то не работает
|
||
|
||
Проверьте в таком порядке:
|
||
1. ✓ Бот запущен и отвечает на `/start`
|
||
2. ✓ Вы ввели номер в правильном формате
|
||
3. ✓ SMS был доставлен на ваш номер
|
||
4. ✓ Вы ввели полный корректный код
|
||
|
||
Если проблема сохраняется:
|
||
- Перезагрузите бота: `/start`
|
||
- Начните авторизацию заново
|
||
- Проверьте логи бота на ошибки
|
||
|
||
---
|
||
|
||
## 🎓 Как это работает под капотом
|
||
|
||
Авторизация использует:
|
||
- **Telethon** - это библиотека для работы с Telegram API
|
||
- **PostgreSQL** - для сохранения данных о сессии
|
||
- **Telegram Bot API** - для общения с вами через бота
|
||
|
||
Процесс:
|
||
1. Вы отправляете номер боту
|
||
2. Бот подключается к Telegram через Telethon
|
||
3. Telegram отправляет SMS-код на ваш номер
|
||
4. Вы отправляете код боту
|
||
5. Telethon завершает авторизацию
|
||
6. Сессия сохраняется в PostgreSQL
|
||
7. UserBot готов к работе
|
||
|
||
---
|
||
|
||
**Удачной авторизации! 🚀**
|