اولین ربات تلگرام خود را بسازید: url کوتاه کننده

یک راهنمای فوق العاده ساده برای مبتدیان کامل
سلام! 🚀 بیایید با هم چیزی خنک بسازیم – ربات تلگرام که URL های طولانی را کوتاه می کندبشر اگر تازه وارد برنامه نویسی هستید نگران نباشید. ما قدم به قدم خواهیم رفت!
🎯 ربات ما چه خواهد کرد؟
url های طولانی را به موارد کوتاه تبدیل کنید
✅ ایجاد عرف URL های کوتاه (نام مستعار خود را برای پیوند انتخاب کنید!)
✅ مستقیماً در تلگرام کار کنید ، درست مثل گپ زدن با یک دوست
🛠 آنچه شما نیاز دارید
📝 راهنمای گام به گام
مرحله 1: تنظیم ابزارهای خود
بسته های Python مورد نیاز را با اجرا نصب کنید:
pip install python-telegram-bot shotcutap
مرحله 2: دریافت توکن ربات تلگرام خود
- تلگرام را باز کنید و جستجو کنید “Botfather”بشر
- ارسال کردن
/newbot
و پیگیری ها را دنبال کنید:- یک نام را انتخاب کنید (به عنوان مثال ، کوتاه کننده URL من)
- نام کاربری را انتخاب کنید (باید به پایان برسد
bot
، به عنوان مثال ، myurlshortener_bot)
- Botfather به شما می دهد نشان–آن را در جایی امن ذخیره کنید!
مرحله 3: دریافت کلید API Shotcut خود
- به پورتال توسعه دهنده ShotCut بروید
- برای یک حساب رایگان ثبت نام کنید
- کلید API خود را از داشبورد دریافت کنید
🧑💻 مرحله 4: نوشتن کد
یک فایل جدید ایجاد کنید bot.py
و این کد را جایگذاری کنید:
from telegram import Update
from telegram.ext import Application, CommandHandler, MessageHandler, filters, ContextTypes
from shotcut import ShotcutAPI
BOT_TOKEN = "paste_your_telegram_bot_token_here" # Get this from BotFather
SHOTCUT_API_KEY = "paste_your_shotcut_api_key_here" # Get this from Shotcut website
shortener = ShotcutAPI(api_key=SHOTCUT_API_KEY)
async def welcome_user(update: Update, context: ContextTypes.DEFAULT_TYPE):
welcome_message = """
👋 Hi there! I'm your URL Shortener Bot!
Just send me any link, and I'll make it shorter for you!
Type /help for more info.
"""
await update.message.reply_text(welcome_message)
async def show_help(update: Update, context: ContextTypes.DEFAULT_TYPE):
help_message = """
📚 How to use me:
1️⃣ Send a link to shorten it.
2️⃣ Use /custom [URL] [name] for a custom short link.
"""
await update.message.reply_text(help_message)
async def make_custom_link(update: Update, context: ContextTypes.DEFAULT_TYPE):
if len(context.args) < 2:
await update.message.reply_text("❌ Please provide a URL and custom name.")
return
original_link, custom_name = context.args[0], context.args[1]
try:
result = shortener.shorten_link(url=original_link, custom=custom_name)
await update.message.reply_text(f"✨ Custom short link: {result['shorturl']}")
except Exception as e:
await update.message.reply_text(f"😔 Error: {str(e)}")
async def make_short_link(update: Update, context: ContextTypes.DEFAULT_TYPE):
original_link = update.message.text.strip()
if not original_link.startswith(('http://', 'https://')):
await update.message.reply_text("🤔 That doesn't look like a valid link.")
return
try:
result = shortener.shorten_link(url=original_link)
await update.message.reply_text(f"✨ Short link: {result['shorturl']}")
except Exception as e:
await update.message.reply_text(f"😔 Error: {str(e)}")
def start_bot():
print("🚀 Starting Telegram Bot...")
app = Application.builder().token(BOT_TOKEN).build()
app.add_handler(CommandHandler("start", welcome_user))
app.add_handler(CommandHandler("help", show_help))
app.add_handler(CommandHandler("custom", make_custom_link))
app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, make_short_link))
app.run_polling()
if __name__ == '__main__':
start_bot()
🚀 اجرای ربات خود
-
نشانه های مخفی خود را ذخیره کنید
- تعویض کردن
paste_your_telegram_bot_token_here
با توکن ربات تلگرام خود - تعویض کردن
paste_your_shotcut_api_key_here
با کلید API Shotcut خود
- تعویض کردن
-
ربات خود را شروع کنید
python bot.py
شما باید ببینید “ربات شما آماده است!” 🎉
-
ربات خود را آزمایش کنید
- تلگرام را باز کنید و ربات خود را پیدا کنید
- تلاش
/start
با/help
، ارسال پیوند ، و/custom
دستورات
🔍 عیب یابی
صادر کردن | راه حل |
---|---|
نشانه نامعتبر | اطمینان حاصل کنید که توکن ربات شما صحیح است و هیچ فضایی ندارد |
پیوندها کار نمی کنند | مطمئن شوید که آنها شروع می کنند http:// یا https://
|
ربات پاسخ نمی دهد | ربات را مجدداً راه اندازی کنید (Ctrl+C پس python bot.py ) |
🔒 ربات خود را ایمن نگه دارید
- هرگز نشانه Bot یا API خود را به اشتراک بگذارید
- اعتبار خود را در یک مکان امن ذخیره کنید
- مراقب پیوندهایی باشید که کوتاه می کنید
🎉 شما این کار را کردید!
تبریک می گویم! شما ربات تلگرام خود را ساخته اید! این فقط آغاز است – برای افزودن ویژگی های بیشتر رایگان است.
به کمک نیاز دارید؟ جوامع ربات پایتون و تلگرام هستند بسیار دوستانه و همیشه از کمک به رمزگذارهای جدید خوشحال می شوید! 😊
Shotcut.in را امتحان کنید 🔗✨
برنامه نویسی مبارک! 🚀