TG_autoposter/INTERACTIVE_AUTH_GUIDE.md

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

---

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