Class Filter
java.lang.Object
io.github.natanimn.telebof.filters.Filter
A class for filtering updates
- Since:
- 3 March 2025
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionFilter messages that containAnimationobjects.audio()Filter messages that containAudioobjects.Filter service messages for boost added.bot()Filter messages coming from bots.booleancallbackData(String... data) Filter callback data of inline buttonchannel()Filter messages sent in channels.Filter service messages for channel deleted.Filter service messages for chat background set.booleanFilter updates that match a chat id.Filter service messages for chat shared.booleanchatUsernames(String... usernames) Filter updates that match a given chat username.Filter messages for containingChecklistFilter service messages for checklist tasks addedFilter service messages for checklist tasks donebooleanFilter commandscontact()Filter messages that containContactobjects.booleancustomFilter(CustomFilter customFilter) Creates a custom filter.
Custom filters give you extra control over which updates are allowed or not to be processed by your handlers.dice()Filter messages that containDiceobjects.Filter service messages for direct message price changeddocument()Filter messages that containDocumentobjects.Filter inline query for empty query.entities()Filter messages for containingMessageEntity.Filter service messages for forum topic closed.Filter service messages for forum topic created.Filter service messages for forum topic edited.Filter service messages for forum topic reopened.Filter service messages for forwarded messages.booleanFilter updates that match a user id.game()Filter messages that containGameobjects.Filter service messages for gift upgrade sentgiveaway()Filter messages that containGiveawayobjects.Filter service messages for giveaway completed.Filter service messages for giveaway created.group()Filter messages sent in group chats.Filter service messages for group chat created.booleaninlineQuery(String... queries) Filter query of inline queryinvoice()Filter messages that containInvoiceobjects.Filter service messages for left chat member.location()Filter messages that containLocationobjects.media()Filter media messages.Filter service messages for message auto timer changed.migrated()Filter service messages for migration from group to supergroup and vice versaFilter service messages for new chat members.Filter service messages for new chat phot.Filter service messages for new chat title.Filter messages containPassportData.photo()Filter messages that containPhotoSizeobjects.Filter service messages for new pinned message.Private()Filter messages sent in private chats.Filter service messages for proximity alert triggered.quote()Filter messages that containTextQuoteobjects.booleanFilter reactions that match a given reaction.Filter service messages for refunded payment.booleanFilter updates that match a given regular expression pattern.replied()Filter service messages for replied messages.Filter service messages for replied to story messages.booleanFilters statesticker()Filter messages that containStickerobjects.Filter service messages for successful payment.Filter service messages for approval failed suggested postFilter service messages for approved suggested postFilter service messages for declined suggested postFilter service messages for paid suggested postFilter service messages for refunded suggested postFilter messages sent in supergroup chats.Filter service messages for supergroup chat created.text()Filter text messages.booleanFilter messages containing a given textsbooleanFilter updates that match a given user's username.Filter service messages for users shared.venue()Filter messages that containVenueobjects.video()Filter messages that containVideoobjects.Filter service messages for video chat ended.Filter service messages for video chat participant invited.Filter service messages for video chat scheduled.Filter service messages for video chat started.Filter messages that containVideoNoteobjects.voice()Filter messages that containVoiceobjects.Filter messages containWebAppData.Filter service messages for writing access allowed.
-
Constructor Details
-
Filter
Required- Parameters:
update- an updatedstorage- state storage.
-
-
Method Details
-
text
Filter text messages.- Returns:
Boolean
-
Private
Filter messages sent in private chats.- Returns:
Boolean
-
channel
Filter messages sent in channels.- Returns:
Boolean
-
supergroup
Filter messages sent in supergroup chats.- Returns:
Boolean
-
group
Filter messages sent in group chats.- Returns:
Boolean
-
photo
Filter messages that containPhotoSizeobjects.- Returns:
Boolean
-
video
Filter messages that containVideoobjects.- Returns:
Boolean
-
voice
Filter messages that containVoiceobjects.- Returns:
Boolean
-
document
Filter messages that containDocumentobjects.- Returns:
Boolean
-
videoNote
Filter messages that containVideoNoteobjects.- Returns:
Boolean
-
animation
Filter messages that containAnimationobjects.- Returns:
Boolean
-
contact
Filter messages that containContactobjects.- Returns:
Boolean
-
location
Filter messages that containLocationobjects.- Returns:
Boolean
-
venue
Filter messages that containVenueobjects.- Returns:
Boolean
-
game
Filter messages that containGameobjects.- Returns:
Boolean
-
dice
Filter messages that containDiceobjects.- Returns:
Boolean
-
sticker
Filter messages that containStickerobjects.- Returns:
Boolean
-
audio
Filter messages that containAudioobjects.- Returns:
Boolean
-
invoice
Filter messages that containInvoiceobjects.- Returns:
Boolean
-
quote
Filter messages that containTextQuoteobjects.- Returns:
Boolean
-
giveaway
Filter messages that containGiveawayobjects.- Returns:
Boolean
-
media
Filter media messages.
A media message contains any of the following fields set:Audio,Document,PhotoSize,Sticker,Video,Animation,Voice,VideoNote.- Returns:
Boolean
-
newChatMember
Filter service messages for new chat members.- Returns:
Boolean
-
leftChatMember
Filter service messages for left chat member.- Returns:
Boolean
-
pinnedMessage
Filter service messages for new pinned message.- Returns:
Boolean
-
newChatPhoto
Filter service messages for new chat phot.- Returns:
Boolean
-
newChatTitle
Filter service messages for new chat title.- Returns:
Boolean
-
groupCreated
Filter service messages for group chat created.- Returns:
Boolean
-
supergroupCreated
Filter service messages for supergroup chat created.- Returns:
Boolean
-
channelCreated
Filter service messages for channel deleted.- Returns:
Boolean
-
messageAutoDeleteTimerChanged
Filter service messages for message auto timer changed.- Returns:
Boolean
-
migrated
Filter service messages for migration from group to supergroup and vice versa- Returns:
Boolean
-
successfulPayment
Filter service messages for successful payment.- Returns:
Boolean
-
proximityAlertTriggered
Filter service messages for proximity alert triggered.- Returns:
Boolean
-
forumTopicCreated
Filter service messages for forum topic created.- Returns:
Boolean
-
forumTopicEdited
Filter service messages for forum topic edited.- Returns:
Boolean
-
forumTopicClosed
Filter service messages for forum topic closed.- Returns:
Boolean
-
forumTopicReopened
Filter service messages for forum topic reopened.- Returns:
Boolean
-
videoChatStarted
Filter service messages for video chat started.- Returns:
Boolean
-
videoChatScheduled
Filter service messages for video chat scheduled.- Returns:
Boolean
-
videoChatParticipantInvited
Filter service messages for video chat participant invited.- Returns:
Boolean
-
videoChatEnded
Filter service messages for video chat ended.- Returns:
Boolean
-
forwarded
Filter service messages for forwarded messages.- Returns:
Boolean
-
replied
Filter service messages for replied messages.- Returns:
Boolean
-
repliedToStory
Filter service messages for replied to story messages.- Returns:
Boolean
-
bot
Filter messages coming from bots.- Returns:
Boolean
-
giveawayCreated
Filter service messages for giveaway created.- Returns:
Boolean
-
giveawayCompleted
Filter service messages for giveaway completed.- Returns:
Boolean
-
boostAdded
Filter service messages for boost added.- Returns:
Boolean
-
writeAccessAllowed
Filter service messages for writing access allowed.- Returns:
Boolean
-
checklist
Filter messages for containingChecklist- Returns:
Boolean
-
checklistTasksDone
Filter service messages for checklist tasks done- Returns:
Boolean
-
checklistTasksAdded
Filter service messages for checklist tasks added- Returns:
Boolean
-
directMessagePriceChanged
Filter service messages for direct message price changed- Returns:
Boolean
-
entities
Filter messages for containingMessageEntity.- Returns:
Boolean
-
chatBackgroundSet
Filter service messages for chat background set.- Returns:
Boolean
-
emptyQuery
Filter inline query for empty query.- Returns:
Boolean
-
webAppData
Filter messages containWebAppData.- Returns:
Boolean
-
passportData
Filter messages containPassportData.- Returns:
Boolean
-
refundedPayment
Filter service messages for refunded payment.- Returns:
Boolean
-
suggestedPostApproved
Filter service messages for approved suggested post- Returns:
Boolean
-
suggestedPostApprovalFailed
Filter service messages for approval failed suggested post- Returns:
Boolean
-
suggestedPostDeclined
Filter service messages for declined suggested post- Returns:
Boolean
-
suggestedPostPaid
Filter service messages for paid suggested post- Returns:
Boolean
-
suggestedPostRefunded
Filter service messages for refunded suggested post- Returns:
Boolean
-
giftUpgradeSent
Filter service messages for gift upgrade sent- Returns:
Boolean
-
commands
Filter commands- Parameters:
commands- The command or array of commands as string- Returns:
Boolean
-
callbackData
Filter callback data of inline button- Parameters:
data- The callback data- Returns:
Boolean
-
inlineQuery
Filter query of inline query- Parameters:
queries- The query- Returns:
Boolean
-
customFilter
Creates a custom filter.
Custom filters give you extra control over which updates are allowed or not to be processed by your handlers.- Parameters:
customFilter- The custom filter- Returns:
Boolean
-
state
Filters state- Parameters:
name- state name- Returns:
Boolean
-
texts
Filter messages containing a given texts- Parameters:
texts- The text- Returns:
Boolean
-
regex
Filter updates that match a given regular expression pattern.- Parameters:
pattern- regex pattern- Returns:
Boolean
-
chatIds
Filter updates that match a chat id.- Parameters:
ids- chat ids- Returns:
Boolean
-
fromIds
Filter updates that match a user id.- Parameters:
ids- user ids- Returns:
Boolean
-
chatUsernames
Filter updates that match a given chat username.- Parameters:
usernames- The username- Returns:
Boolean
-
usernames
Filter updates that match a given user's username.- Parameters:
usernames- The username- Returns:
Boolean
-
reaction
Filter reactions that match a given reaction.- Parameters:
react- reactions- Returns:
Boolean
-