Files

Andrew K. Choi e57ca0b36e ✨ 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.

2025-12-21 12:18:05 +09:00

3.4 KiB

Raw Permalink Blame History

⚙️ 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)

cd /home/trevor/dev/TG_autoposter
./authorize_userbot_simple.sh

Then:

Wait for SMS - You'll receive a code to +821056936103
Enter the code when prompted
Done! ✅

Method 2: Original Script

./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:

./authorize_userbot_simple.sh  # ✅ Correct
sudo ./authorize_userbot_simple.sh  # ❌ Wrong

Q: SMS didn't arrive

Wait 30 seconds more
Check spam folder
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

✅ Send /start to bot
✅ Click "🤖 UserBot" button
✅ Try "📥 Собрать группы" (Collect Groups)
✅ 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

# 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:

./authorize_userbot_simple.sh

And follow the prompts. You'll be done in 3-5 minutes! 🎉

3.4 KiB Raw Permalink Blame History