Struct Context 

pub struct Context {
    pub update: Arc<Update>,
    pub bot: BotClient,
}

The context object passed to every handler.

Contains the incoming Update, the BotClient (ready to make API calls), and a reference to any shared bot-level state. The context object passed to every handler.

Context bundles the incoming Update with the BotClient so handlers have everything they need in a single value.

Accessing the update

async fn handler(ctx: Context) -> BotResult<()> {
    // Convenience accessors
    let text    = ctx.text();       // message text or caption
    let cmd     = ctx.command();    // "/start" → Some("start")
    let chat_id = ctx.chat_id();
    let user_id = ctx.from_id();

    // Raw update for anything not covered by the helpers
    let update = &ctx.update;
    Ok(())
}

Sending replies

ctx.reply(text) is a shortcut that sends a message to the current chat and automatically sets reply_to_message_id. It returns None when the update has no associated chat (e.g. inline queries).

if let Some(reply) = ctx.reply("Got it!") {
    reply.parse_mode(ParseMode::HTML).await?;
}

Fields

update: Arc<Update>

The incoming update that triggered this handler.

bot: BotClient

The API client — call any Bot API method directly.

Implementations

impl Context

pub fn new(update: Update, bot: BotClient) -> Self

Creates a new Context.

pub fn update_id(&self) -> i64

Returns the update ID.

pub fn message(&self) -> Option<&Message>

Returns the Message from a message, edited message, channel post, or callback query update. Returns None for all other update types.

pub fn chat_id(&self) -> Option<ChatId>

Returns the chat ID from the current update as a ChatId, if available.

pub fn from_id(&self) -> Option<i64>

Returns the sender’s user ID, if available.

pub fn callback_query(&self) -> Option<&CallbackQuery>

Returns the CallbackQuery if this is a callback query update.

pub fn inline_query(&self) -> Option<&InlineQuery>

Returns the InlineQuery if this is an inline query update.

pub fn text(&self) -> Option<&str>

Returns the effective text of the message — Message::text if present, falling back to Message::caption.

pub fn command(&self) -> Option<&str>

Returns the command name if the message starts with a bot command entity.

The leading / and optional @BotName suffix are stripped automatically. /start@mybot returns Some("start").

pub fn is_ephemeral(&self) -> bool

Returns true if the current update’s message is an ephemeral message.

pub fn ephemeral_message_id(&self) -> Option<i64>

Returns the ephemeral message identifier, if the current update’s message is an ephemeral message.

Note that this is unrelated to Context::reply — replying to an ephemeral message still requires calling BotClient::send_message directly with .receiver_user_id(...) (and, within 15 seconds of the triggering action, .callback_query_id(...) or ReplyParameters::reply_to_ephemeral), since reply()’s signature has no room for the extra targeting parameters without a breaking change.

pub fn reply(&self, text: impl Into<String>) -> Option<SendMessage>

Sends a text reply to the current chat, automatically setting reply_to_message_id to the incoming message.

Returns None when the update has no associated chat.

Trait Implementations

impl Clone for Context

fn clone(&self) -> Context

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.