MessageHandler¶

class telegram.ext.MessageHandler(filters, callback, block=True)[source]¶

Handler class to handle Telegram messages. They might contain text, media or status updates.

Warning

When setting block to False, you cannot rely on adding custom attributes to telegram.ext.CallbackContext. See its docs for more info.

Available In

Parameters:

filters (telegram.ext.filters.BaseFilter) –
A filter inheriting from telegram.ext.filters.BaseFilter. Standard filters can be found in telegram.ext.filters. Filters can be combined using bitwise operators (& for and, | for or, ~ for not). Passing None is a shortcut to passing telegram.ext.filters.ALL.

See also

Advanced Filters
callback (coroutine function) –
The callback function for this handler. Will be called when check_update() has determined that an update should be processed by this handler. Callback signature:
```
async def callback(update: Update, context: CallbackContext)
```
The return value of the callback is usually ignored except for the special case of telegram.ext.ConversationHandler.
block (bool, optional) –
Determines whether the return value of the callback should be awaited before processing the next handler in telegram.ext.Application.process_update(). Defaults to True.

See also

Concurrency

Only allow updates with these Filters. See telegram.ext.filters for a full list of all available filters.

The callback function for this handler.

Determines whether the return value of the callback should be awaited before processing the next handler in telegram.ext.Application.process_update().

check_update(update)[source]¶

Determines whether an update should be passed to this handler’s callback.

collect_additional_context(context, update, application, check_result)[source]¶: Adds possible output of data filters to the CallbackContext.