Annotation Interface BusinessConnectionHandler

@Retention(RUNTIME)
@Target(METHOD)
@Repeatable(BusinessConnectionHandlers.class)
public @interface BusinessConnectionHandler

Annotation for handling business connection events in a declarative manner. Designed specifically for handling events related to Telegram Business account connections, providing monitoring capabilities for connection status changes, authorization events, and business account management operations. This annotation enables structured handling of business connection lifecycle events with custom filtering capabilities for processing connection establishment, updates, and termination events in business communication contexts. Equivalent with using BotClient.onBusinessConnection(FilterExecutor, UpdateHandler)

Since:

1.2.0

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element	Description
Class<? extends CustomFilter>	filter	Custom filter class for advanced filtering of business connection events.
int	priority	Priority order for handler registration and execution.

Element Details

filter

Class<? extends CustomFilter> filter

Custom filter class for advanced filtering of business connection events. Use this to implement custom logic for determining which connection events should trigger this handler, such as filtering by business account type, connection status, authorization scope, service categories, or other business-specific connection criteria.

Returns:

class implementing CustomFilter interface

Default:

io.github.natanimn.telebof.filters.DefaultCustomFilter.class

priority

int priority

Priority order for handler registration and execution. Handlers with lower priority numbers are registered and executed before those with higher numbers.

Returns:

priority integer value (lower = earlier execution)

Default:

0