فیلترها

فیلترها با & (AND)، | (OR) و ~ (NOT) ترکیب می‌شوند.

Python

# AND - پیام شامل "سلام" و در گروه
@bot.on_new_message(Text("سلام") & ChatType("group"))

# OR - گروه یا کانال
@bot.on_new_message(ChatType("group") | ChatType("channel"))

# NOT - هر چیزی غیر از دستور
@bot.on_new_message(~Command())

فیلترهای نوع رویداد

فیلتر	توضیح
`IsMessage()`	پیام جدید
`IsEditedMessage()`	پیام ویرایش شده
`IsDeleted()`	پیام پاک شده
`IsCallback()`	کلیک دکمه اینلاین
`IsStartedBot()`	شروع بات توسط کاربر
`IsStoppedBot()`	توقف بات توسط کاربر

مثال:

Python

@bot.on_new_message(IsMessage())
async def new_msg(bot, event):
    await event.reply("این یک پیام جدید است!")

@bot.on_callback(IsCallback())
async def callback_handler(bot, event):
    await event.reply("روی دکمه کلیک شد!")

فیلترهای متن

فیلتر	توضیح	مثال
`IsText()`	فقط پیام متنی (بدون فایل)	-
`Text("pattern")`	متن شامل الگو باشد	`Text("سلام")`
`TextMatch("pattern")`	مانند Text + ذخیره match	`TextMatch(r"اسم (\w+)")`
`Command("name")`	متن با / شروع شود	`Command("start")`

مثال:

Python

# فقط متن
@bot.on_new_message(IsText())
async def text_only(bot, event):
    await event.reply(f"متن: {event.text}")

# تشخیص نام با TextMatch
@bot.on_new_message(TextMatch(r"اسم من (\w+) هست"))
async def name_catcher(bot, event):
    name = event.pattern_match.group(1)
    await event.reply(f"سلام {name}!")

فیلترهای چت و کاربر

فیلتر	توضیح	مثال
`ChatType("user")`	فقط پیوی	`ChatType("group")`
`ChatType(["group", "channel"])`	گروه یا کانال	-
`FromChat("id")`	چت خاص	`FromChat("g0abc...")`
`FromUser("id")`	کاربر خاص	`FromUser("u0abc...")`

مثال:

Python

@bot.on_new_message(ChatType("user"))
async def private_only(bot, event):
    await event.reply("این پیام در پیوی ارسال شده!")

@bot.on_new_message(FromChat("g0abc123def456ghi789jklmno123456"))
async def specific_group(bot, event):
    await event.reply("سلام به گروه خاص!")

فیلترهای فایل و مدیا

فیلتر	توضیح
`IsFile()`	هر نوع فایل
`IsImage()`	عکس (.jpg, .png, .gif, .webp)
`IsVideo()`	ویدیو (.mp4, .avi, .mkv, .mov)
`IsVoice()`	ویس (.ogg, voice_)
`IsMusic()`	موزیک (.mp3, .wav, .flac, .m4a)
`IsSticker()`	استیکر (.webm)

مثال:

Python

@bot.on_new_message(IsImage())
async def image_handler(bot, event):
    await event.reply(f"عکس {event.file_name} دریافت شد!")

@bot.on_new_message(IsVideo())
async def video_handler(bot, event):
    await event.reply(f"ویدیو {event.file_name} دریافت شد!")

@bot.on_new_message(IsSticker())
async def sticker_handler(bot, event):
    await event.reply("یک استیکر دریافت شد!")

فیلترهای ریپلای و فوروارد

فیلتر	توضیح
`IsReply()`	پیام ریپلای شده
`IsForwarded()`	هر نوع فوروارد
`ForwardedFromUser()`	فوروارد از کاربر
`ForwardedFromChannel()`	فوروارد از کانال
`ForwardedFromBot()`	فوروارد از بات
`ForwardedNoLink()`	فوروارد با هدایت بسته

مثال:

Python

@bot.on_new_message(IsReply())
async def reply_handler(bot, event):
    await event.reply("این پیام به پیام دیگری ریپلای زده!")

@bot.on_new_message(IsForwarded())
async def forward_handler(bot, event):
    await event.reply("این یک پیام فوروارد شده است!")

@bot.on_new_message(ForwardedFromBot())
async def forward_from_bot(bot, event):
    await event.reply("این پیام از یک بات فوروارد شده!")

فیلترهای متادیتا

فیلتر	توضیح	مثال
`HasMetadata()`	پیام فرمت‌دار (Bold, Italic)	-
`MetadataType("Bold")`	نوع خاص	`MetadataType(["Bold", "Italic"])`

مثال:

Python

@bot.on_new_message(HasMetadata())
async def metadata_handler(bot, event):
    await event.reply("این پیام فرمت‌دار است!")

@bot.on_new_message(MetadataType("Bold"))
async def bold_handler(bot, event):
    await event.reply("این پیام دارای متن پررنگ است!")

→ صفحه قبل صفحه اصلی صفحه بعد ←