Andrew K. Choi
e57ca0b36e
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.
175 lines
3.4 KiB
Markdown
175 lines
3.4 KiB
Markdown
# ⚙️ 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! 🎉
|