Bot API 7.11

• Bots can now participate in revenue sharing from Telegram Ads ⭐️ – unlocking a new way to help support their development.
• Introduced Paid Broadcasts ⭐️ – allowing bots to broadcast up to 1000 messages per second.

• Bots can now send and receive chat-specific hashtags that only show posts and stories from a specific chat when tapped.
• Added a new inline button to let users copy text in one tap.
• Bots can now add media to existing text messages.

• And more, see the full changelog for details:

https://core.telegram.org/bots/api-changelog#october-31-2024

⚠️ Warning: Starting December 1, 2024 messages with video posted in big communities can be delayed by the server until the respective video is reencoded. Read more here.

🚫• کاستوم‌فیلتر ها ( CUSTOM FILTERS ) در #تلبات

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


📄 - لیست کامل فیلتر ها؛

AdvancedCustomFilter : کلاس‌پایه فیلتر
IsAdminFilter : محدود کردن به ادمین/اونر
ForwardFilter : محدود کردن به فوروارد
ChatFilter : تطابق چت‌ایدی
IsDigitFilter : محدود کردن به عدد
IsReplyFilter : محدود کردن به ریپلای
LanguageFilter : محدود کردن به LC
SimpleCustomFilter : کلاس پایه فیلتر سفارشی
StateFilter : محدود کردن استیت
TextContainsFilter : محدود کردن به وجود متن در آپدیت
TextFilter : محدود کردن متن تایپ ها
TextMatchFilter : محدود کردن متن مسیج
TextStartsFilter : محدود کردن متن مسیج با شروعی خاص

👍- حالا که با انواع فیلتر های موجود در تلبات آشنا شدیم، بیایید نحوه به کار بردن و استفاده عمومی از این فیلتر ها رو ببینیم و عملی انجام بدیم؛

1️⃣ توی قدم اول باید CUSTOM_FILTERS رو از تلبات ایمپورت و سپس با متد ADD_CUSTOM_FILTER فیلتر مورد نظر رو بر شی TELEBOT اعمال کنیم :

from telebot import TeleBot, custom_filters

app = TeleBot()

app.add_custom_filter(Custom_filters.TextStartsFilter()) #EX

2️⃣ بعد از اد کردن فیلتر مورد نظر به شئ تلبات و استفاده از فیلتر ها داخل هندلر، بایستی بسته به نوع فیلتر از KEY ها داخل هندلر استفاده کنیم. توی حالت کلی بنا بر نحوه پیاده سازی فیلتر ها، KEY ها میتونن هر مقداری باشند، با فرض وجود کد بالایی و اعمال کردن فیلتر START TEXT FILTER این سمپل رو با KEY مختص به این فیلتر ببینید :

@app.message_handler(text_startswith='XD')
def _(message):
   ...

😎 حالا این هندلر در صورتی فعال و شروع به کار میکنه که آپدیت دریافتی‌ تکست و با "XD" شروع شده باشه، پس در نهایت :

from telebot import TeleBot, custom_filters
from telebot.types import Message 

app = TeleBot()

@app.message_handler(text_startswith='XD')
def _(message: Message):
    app.reply_to(message=message, text='XD')

app.add_custom_filter(custom_filters.TextStartsFilter())
app.infinity_polling()

👀- حالا که با نحوه کلی و جامع پیاده سازی کاستوم‌فیلتر ها آشنا شدید، ليست KEY و تایپ های هر فیلتر رو با هم ببینیم :

💡FilterName : Key | Type

ChatFilter : key = chat_id | type = List

TextContainsFilter : key = text_contains | type = List

TextMatchFilter : key = text | type = List

LanguageFilter : key = language_code | type = List

ForwardFilter : key = is_forwarded | type = Bool

IsAdminFilter : key = is_chat_admin | type = Bool

IsDigitFilter : key = is_digit | type = Bool

IsReplyFilter : key = is_reply | type = Bool
StateFilter : key = state | type = Int

TextStartsFilter = key = text_startswith | type = String

🧑‍🎓- پس ی جمع بندی کلی و کامل داشته باشیم، برای استفاده از هر فیلتر کافیه با متد ADD_CUSTOM_FILTER اون رو به شئ TELEBOT اد کنیم و با KEY هاشون، هندلر ها رو به آپدیت های خاصی محدود کنیم، از طرفی مانع کد زدن اضافی و از طرف دیگه موجب تمیزی و خوانایی و از همه مهم‌تر مدیریت کد‌هامون رو راحت تر میکنه، فعلا در همین اندازه شناخت داشته باشید، طی پست های آینده، از بیسیک‌ و ریشه‌ای ترین فیلتر ها اقدام به کالبد شکافی میکنیم بصورت مفصل.


پ‌ن؛ حالا انتخابتون چیه؟! 🤔 استفاده از کاستوم‌فیلتر ها یا نوشتن شروط پیچیده و استفاده از FUNC LAMBDA؟!

😎 CodingLovers | #Farshad

3k ❤️

🥱• روز دوم رو با کلاس پایه کاستوم فیلتر شروع کنیم.

پایه‌ای ترین کارکرد کاستوم فیلتر رو میتونیم با SIMPLE CUSTOM FILTER پیاده سازی کنیم، چطوری؟! کافیه اقدام‌ به ساخت ی چیلد‌ کلس با فیلتر مورد نظر در متد CHECK کنیم، توی حالت کلی به عنوان پارامتر ورودی مجاز به دریافت یک پارامتر و در نهایت بولین TRUE یا FALSE ریترن میکنه. بریم که توی عمل نحوه پیاده‌سازیش رو داشته باشیم.

1️⃣- طبق معمول‌ و روال گذشته بایستی وابستگی ها رو از CUSTOM_FILTERS ماژول تلبات ایمپورت کنیم؛

from telebot import TeleBot 
from telebot.custom_filters import SimpleCustomFilter 

app = TeleBot() 

2️⃣- توی قدم بعدی باید اقدام به ساخت  کلاس و اد کردن اون به شئ تلبات کنیم، ساختار این کلاس به این صورت باید باشه که به عنوان کلاس والد SIMPLECUSTOMFILTER رو دریافت و با ایجاد KEY اختصاصی خود و تکمیل و کاستوم کردن متد CHECK توی هندلر هامون مورد استفاده قرار بگیره، مثالی از پیاده سازیش ببینید که در ادامه قراره نکات مهمی رو مرور کنیم؛

__Bot_Status__: str = 'ON' 

class CodingLovers(SimpleCustomFilter):
    key: str = 'XD'

    @staticmethod
    def check(update):
        return (__Bot_Status__ == 'ON') 

app.add_custom_filter(CodingLovers())

🚫- نکات و الزامات این بخش:
🔵نام متد CHECK باید دقیقا به همین صورت باشه!
🟡متد CHECK حداکثر ی پارامتر که همون آپدیت هندلر باشه رو میتونه دریافت کنه ( برعکس ADVANCEDCUSTOMFILTER که در آینده باهاش آشنا میشیم )

👀- پس در نهایت این سمپل رو خواهیم داشت؛
پ‌ن، اینجا __BOT_STATUS__ رو شما حالتی فرض کنید که قراره چک کردن واقعی اتفاق بیوفته، حقیقتا مثال دیگه ای به ذهنم نرسید ☺️

from telebot import TeleBot 
from telebot.types import Message 
from telebot.custom_filters import SimpleCustomFilter

app = TeleBot() 

__Bot_Status__: str = 'ON' 

class CodingLovers(SimpleCustomFilter):
    key: str = 'XD'

    @staticmethod
    def check(update):
        return (__Bot_Status__ == 'ON')

@app.message_handler(commands=['start'], XD=True)
def _(message: Message):
    app.reply_to(message=message, text='XD') 
    
@app.message_handler(commands=['start'], XD=False)
def _(message: Message):
    app.reply_to(message=message, text='Bot is Off')

app.add_custom_filter(CodingLovers())
app.infinity_polling()

اگه بخوایم کامل تشریح کنیم که چه فرایندی توی این کد طی میشه، باید گفت : با ايجاد کلاس فیلتر مورد نظرمون و تکمیل کردن متد CHECK، در قدم اول به شی TELEBOT اد میشه و میتونیم داخل همه هندلر هامون با KEY یونیکی که واسه فیلتر در نظر گرفتیم استفاده کنیم، وقتی توی هندلر اولیمون که کامند استارت رو هندل میکنه از این فیلتر استفاده میکنیم و KEY که در این کد XD هست رو برابر بولین TRUE میزاریم، در صورتی هندلر شروع به کار و انجام دادن بلوک زیرینش میکنه که شرط داخل متد CHECK فیلرتمون برابر با TRUE باشه و در صورتی هندلر دومی شروع به کار میکنه که شرط متد CHECK فیلترمون برابر با بولین FALSE باشه!  مثال دیگه ای پیاده سازیشو میتونین اینجا ببینین، همچین اگه سوال یا ابهامی داشتید کامنت کنید.

😎 CodingLovers | #Farshad

پست های بعدی در چه باب، موضوع و یا شاخه ای باشه؟! 🤔 توی تلبات عمیق تر شیم یا..؟!