✨ Add simplified UserBot authorization script and quick guide
NEW FILES: ✅ authorize_userbot_simple.sh - Simple one-command authorization ✅ QUICK_AUTH_GUIDE.md - Quick authorization reference ✅ AUTH_INSTRUCTIONS.txt - Pre-authorization instructions IMPROVEMENTS: ✅ Simpler, more user-friendly authorization process ✅ Direct Python-based authentication (no bash complexity) ✅ Clear prompts and status messages ✅ Better error handling ✅ Works with interactive terminal (docker-compose exec -it) USAGE: ./authorize_userbot_simple.sh [Wait for SMS] [Enter code when prompted] This provides two options: 1. Simple mode: ./authorize_userbot_simple.sh 2. Original mode: ./init_telethon_session.sh Both do the same thing, simple mode is more straightforward for users.
This commit is contained in:
174
QUICK_AUTH_GUIDE.md
Normal file
174
QUICK_AUTH_GUIDE.md
Normal file
@@ -0,0 +1,174 @@
|
||||
# ⚙️ UserBot Authorization - Final Guide
|
||||
|
||||
## Current Status ✅
|
||||
|
||||
✅ Bot is running
|
||||
✅ UserBot service is running
|
||||
✅ Containers are healthy
|
||||
⏳ UserBot needs **ONE-TIME** authorization
|
||||
|
||||
---
|
||||
|
||||
## 📲 Authorization (2 Methods)
|
||||
|
||||
### Method 1: Simple Authorization (Recommended)
|
||||
|
||||
```bash
|
||||
cd /home/trevor/dev/TG_autoposter
|
||||
./authorize_userbot_simple.sh
|
||||
```
|
||||
|
||||
Then:
|
||||
1. **Wait for SMS** - You'll receive a code to `+821056936103`
|
||||
2. **Enter the code** when prompted
|
||||
3. **Done!** ✅
|
||||
|
||||
### Method 2: Original Script
|
||||
|
||||
```bash
|
||||
./init_telethon_session.sh
|
||||
```
|
||||
|
||||
Same process, slightly more verbose output.
|
||||
|
||||
---
|
||||
|
||||
## 🔍 What's Happening
|
||||
|
||||
When you run the authorization script:
|
||||
|
||||
```
|
||||
📱 Phone: +821056936103
|
||||
🔗 Connecting to Telegram...
|
||||
✅ Connected!
|
||||
|
||||
🔐 Sending SMS code request...
|
||||
📲 SMS sent! Check your messages.
|
||||
|
||||
📝 Enter the SMS code: [YOU TYPE HERE]
|
||||
```
|
||||
|
||||
**Then:**
|
||||
- ✅ Session is saved
|
||||
- ✅ UserBot restarts
|
||||
- ✅ You'll see: "✅ UserBot инициализирован"
|
||||
|
||||
---
|
||||
|
||||
## ⏱️ Timeline
|
||||
|
||||
| Step | Time | Action |
|
||||
|------|------|--------|
|
||||
| 1 | <1 min | Run script |
|
||||
| 2 | 0-2 min | Receive SMS |
|
||||
| 3 | <1 min | Enter code |
|
||||
| 4 | <1 min | Save session |
|
||||
| **Total** | **3-5 min** | Done! ✅ |
|
||||
|
||||
---
|
||||
|
||||
## ❓ FAQ
|
||||
|
||||
### Q: I don't see the SMS code prompt
|
||||
**A:** Make sure you're running WITHOUT `sudo`:
|
||||
```bash
|
||||
./authorize_userbot_simple.sh # ✅ Correct
|
||||
sudo ./authorize_userbot_simple.sh # ❌ Wrong
|
||||
```
|
||||
|
||||
### Q: SMS didn't arrive
|
||||
**A:**
|
||||
1. Wait 30 seconds more
|
||||
2. Check spam folder
|
||||
3. Make sure `TELETHON_PHONE` in `.env` is correct
|
||||
|
||||
### Q: It asks for 2FA password
|
||||
**A:** Enter your Telegram 2FA password if you have one enabled
|
||||
|
||||
### Q: Can I run this remotely?
|
||||
**A:** Yes! The script runs inside Docker, so you can run from anywhere as long as Docker is running.
|
||||
|
||||
---
|
||||
|
||||
## ✅ Success Indicators
|
||||
|
||||
After running the script, you should see:
|
||||
|
||||
```
|
||||
✅ Authorization Complete!
|
||||
Restarting UserBot container...
|
||||
```
|
||||
|
||||
Then in logs:
|
||||
```
|
||||
✅ UserBot инициализирован: Your Name (@username)
|
||||
🔄 UserBot готов к обработке задач
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Next Steps After Authorization
|
||||
|
||||
1. ✅ Send `/start` to bot
|
||||
2. ✅ Click "🤖 UserBot" button
|
||||
3. ✅ Try "📥 Собрать группы" (Collect Groups)
|
||||
4. ✅ Check database for results
|
||||
|
||||
---
|
||||
|
||||
## 📊 Session Files
|
||||
|
||||
After authorization, these files will be created:
|
||||
```
|
||||
app/sessions/
|
||||
├── userbot_session.session (main session - encrypted)
|
||||
└── telethon_string_session.txt (backup)
|
||||
```
|
||||
|
||||
**Important:** Never commit these to git (they're in `.gitignore`)
|
||||
|
||||
---
|
||||
|
||||
## 🔧 Troubleshooting
|
||||
|
||||
### Error: "No suitable method of authorization"
|
||||
- Phone number is incorrect in `.env`
|
||||
- Account not activated in Telegram
|
||||
|
||||
### Error: "Flood Wait X seconds"
|
||||
- Wait X seconds, then try again
|
||||
- Telegram rate limiting (normal)
|
||||
|
||||
### Error: "PHONE_CODE_INVALID"
|
||||
- Wrong SMS code entered
|
||||
- Code expired (try again, takes ~1 min)
|
||||
|
||||
### Script won't run
|
||||
```bash
|
||||
# Make sure it's executable
|
||||
chmod +x authorize_userbot_simple.sh
|
||||
|
||||
# Run it
|
||||
./authorize_userbot_simple.sh
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📞 Support
|
||||
|
||||
Check these files for more info:
|
||||
- `README_COMPLETE.md` - Full documentation
|
||||
- `TELETHON_AUTHORIZATION_GUIDE.md` - Detailed guide
|
||||
- `COMPLETION_CHECKLIST.md` - What to do next
|
||||
|
||||
---
|
||||
|
||||
## ✨ That's It!
|
||||
|
||||
Everything is ready. Just run:
|
||||
|
||||
```bash
|
||||
./authorize_userbot_simple.sh
|
||||
```
|
||||
|
||||
And follow the prompts. You'll be done in 3-5 minutes! 🎉
|
||||
Reference in New Issue
Block a user