Struct TelegramBot 

pub struct TelegramBot { /* private fields */ }

Telegram bot builder

Create a bot with command and button handlers, then call build() to get a webhook handler that implements skyzen’s Endpoint trait.

Example

use botkit_core::User;
use botkit_telegram::{TelegramBot, TelegramWebhook};

// Simple handler - no Context needed!
async fn ping() -> &'static str {
    "Pong!"
}

// With extractors
async fn greet(user: User) -> String {
    format!("Hello, {}!", user.name)
}

// Return TelegramWebhook directly - it implements Endpoint
#[skyzen::main]
fn main() -> TelegramWebhook {
    TelegramBot::new(token)
        .command("ping", ping)
        .command("greet", greet)
        .build()
}

Implementations

impl TelegramBot

pub fn new(token: impl Into<String>) -> Self

Create a new Telegram bot

pub fn command<H, Args>(self, name: impl Into<String>, handler: H) -> Self

where H: IntoHandler<Args>,

Register a command handler (e.g., /start, /help)

pub fn command_with_description<H, Args>( self, name: impl Into<String>, description: impl Into<String>, handler: H, ) -> Self

where H: IntoHandler<Args>,

Register a command handler with description

The description appears in Telegram’s command menu (slash command suggestions).

pub fn button<H, Args>(self, pattern: impl Into<String>, handler: H) -> Self

where H: IntoHandler<Args>,

Register a button handler (callback query data pattern)

Pattern can end with * for prefix matching (e.g., “confirm_*”)

pub fn message<H, Args>(self, handler: H) -> Self

where H: IntoHandler<Args>,

Register a message handler

pub fn build(self) -> TelegramWebhook

Build the webhook handler (for use with skyzen’s Endpoint)

pub async fn run_polling(self) -> Result<(), BotError>

Run the bot using long-polling (no server needed)

This method polls Telegram’s API for updates and processes them using the registered handlers. It runs forever until interrupted.

Example

use botkit_telegram::TelegramBot;

async fn ping() -> &'static str { "Pong!" }

TelegramBot::new(token)
    .command("ping", ping)
    .run_polling()
    .await;