Skip to content

3ircle/simple-telegram

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Simple Telegram

Python Version License Status

یک کتابخانه ساده و کاربردی پایتون برای ساخت ربات‌های تلگرام

ویژگی‌هانصبراهنمای سریعمستندات


📋 فهرست مطالب

---

🎯 درباره پروژه

Simple Telegram یک کتابخانه پایتون سبک و کاربرپسند برای توسعه ربات‌های تلگرام است. هدف این پروژه، ساده‌سازی فرآیند ساخت ربات‌های تلگرام و ارائه رابط برنامه‌نویسی آسان و قابل فهم است.

چرا Simple Telegram؟

  • ساده و شهودی: API کاملاً واضح و قابل فهم
  • 🚀 سریع: راه‌اندازی ربات در کمتر از 5 دقیقه
  • 🔧 انعطاف‌پذیر: قابلیت سفارشی‌سازی بالا
  • 📚 مستندسازی کامل: راهنماهای جامع و مثال‌های متنوع
  • 🐍 Pythonic: طراحی مطابق با استانداردهای پایتون
---

✨ ویژگی‌ها

  • 📨 ارسال و دریافت پیام‌های متنی
  • 🖼️ پشتیبانی از رسانه‌های چندگانه (عکس، ویدیو، فایل)
  • 👥 مدیریت گروه‌ها و کانال‌هاا
  • 🔐 احراز هویت و مدیریت کاربران
  • 📊 دریافت اطلاعات کاربران و چت‌ها
  • 🌐 Webhook و Polling
---

📦 نصب

نصب از طریق GitHub

git clone https://github.com/3ircle/simple-telegram.git
cd simple-telegram
pip install -e .

پیش‌نیازها

  • Python 3.7 یا بالاتر
  • requests
- توکن ربات تلگرام (از [@BotFather](https://t.me/BotFather) دریافت کنید)

🚀 راهنمای سریع

گام 1: دریافت توکن ربات

  1. در تلگرام به @BotFather پیام دهید
  2. دستور /newbot را ارسال کنید
  3. نام و username ربات را تعیین کنید
  4. توکن دریافتی را کپی کنید

گام 2: ساخت اولین ربات

import simple_telegram

bot = simple_telegram.bot.Bot('YOUR_API_KEY')

def message_handler(update):
    if update.message and update.message.text == 'hi':
        update.message.reply('hello')

bot.message_handler = message_handler

bot.run(0)

گام 3: اجرای ربات

python your_bot.py

## 🤝 مشارکت در پروژه

مشارکت شما در بهبود این پروژه بسیار ارزشمند است!

مراحل مشارکت:

  1. این repository را Fork کنید
  2. یک Branch جدید بسازید (git checkout -b feature/AmazingFeature)
  3. تغییرات خود را Commit کنید (git commit -m 'Add some AmazingFeature')
  4. Branch را Push کنید (git push origin feature/AmazingFeature)
---

📄 لایسنس

این پروژه تحت لایسنس MIT منتشر شده است. برای اطلاعات بیشتر فایل LICENSE را مطالعه کنید.


## 📞 پشتیبانی و ارتباط

📚 منابع مفید


ساخته شده با ❤️ توسط 3ircle

⭐ اگر این پروژه برایتان مفید بود، یک ستاره بدهید!

About

Build Telegram bots in Python with just a few lines of code

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages