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 ❤️