# 🔐 Интерактивная авторизация 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 готов к работе

---

**Удачной авторизации! 🚀**