Struct HttpTelegramBot 

pub struct HttpTelegramBot { /* private fields */ }

TelegramBot over the Telegram Bot API: POST {base}/bot{token}/{method} with a JSON body, through the runtime’s HttpClient port.

No Debug derive: the token is a struct field, and a derived Debug would print it wherever a log line met the adapter. The hand-written one prints a placeholder instead.

Implementations

impl HttpTelegramBot

pub fn new( http: Arc<dyn HttpClient>, clock: Arc<dyn Clock>, bot_token: impl Into<String>, ) -> Self

A bot pointed at Telegram under bot_token.

pub fn with_base(self, base_url: impl Into<String>) -> Self

Overrides the root every request is posted to — a fake in tests — instead of https://api.telegram.org.

pub fn with_limits(self, limits: RateLimits) -> Self

Replaces the rate budgets with limits, discarding the tokens the old budgets had accrued and any 429 deadlines. Chain after new.

pub async fn set_webhook( &self, url: &str, secret_token: &str, allowed_updates: &[&str], ) -> Result<(), TelegramError>

Registers url as the bot’s webhook with secret_token in webhook::SECRET_HEADER and the named update types delivered. An empty url deletes the webhook.

Counted against the global budget only: there is no chat to scope a per-chat bucket to, and a 429 here has nothing to remember one for.

Errors

TelegramError::Invalid for a url that is neither https nor a localhost http (the one exception Telegram allows), a secret outside Telegram’s alphabet, or a bot token that is not shaped like one; otherwise the same mapping as TelegramBot::send_message.

Trait Implementations

impl Debug for HttpTelegramBot

fn fmt(&self, f: &mut Formatter<'_>) -> Result

The bot token is a struct field, so it is written as a placeholder: a log line that meets the adapter must never carry it.

impl TelegramBot for HttpTelegramBot

fn send_message<'life0, 'life1, 'async_trait>( &'life0 self, message: &'life1 OutgoingMessage, ) -> Pin<Box<dyn Future<Output = Result<SentMessage, TelegramError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Sends a text message, with any buttons, and reports where it landed.

fn edit_message<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, chat_id: i64, message_id: i64, text: &'life1 str, buttons: &'life2 [Vec<InlineButton>], ) -> Pin<Box<dyn Future<Output = Result<(), TelegramError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Edits a message this bot previously sent, replacing the text and the inline keyboard (an empty buttons removes the keyboard).

fn delete_message<'life0, 'async_trait>( &'life0 self, chat_id: i64, message_id: i64, ) -> Pin<Box<dyn Future<Output = Result<(), TelegramError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Deletes a message this bot previously sent.

fn answer_callback<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, callback_query_id: &'life1 str, text: Option<&'life2 str>, ) -> Pin<Box<dyn Future<Output = Result<(), TelegramError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Acknowledges a callback query, optionally showing text as a toast to the user who pressed the button.