// This example provide a quick overview of the new features in the // `dispatching` module. use rand::Rng; use teloxide::{ prelude::*, types::{Dice, ReplyParameters}, utils::command::BotCommands, }; #[tokio::main] async fn main() { pretty_env_logger::init(); log::info!("Starting dispatching features bot..."); let bot = Bot::from_env(); let parameters = ConfigParameters { bot_maintainer: UserId(0), // Paste your ID to run this bot. maintainer_username: None, }; let handler = Update::filter_message() // You can use branching to define multiple ways in which an update will be handled. If the // first branch fails, an update will be passed to the second branch, and so on. .branch( dptree::entry() // Filter commands: the next handlers will receive a parsed `SimpleCommand`. .filter_command::() // If a command parsing fails, this handler will not be executed. .endpoint(simple_commands_handler), ) .branch( // Filter a maintainer by a user ID. dptree::filter(|cfg: ConfigParameters, msg: Message| { msg.from.map(|user| user.id == cfg.bot_maintainer).unwrap_or_default() }) .filter_command::() .endpoint(|msg: Message, bot: Bot, cmd: MaintainerCommands| async move { match cmd { MaintainerCommands::Rand { from, to } => { let mut rng = rand::rngs::OsRng; let value: u64 = rng.gen_range(from..=to); bot.send_message(msg.chat.id, value.to_string()).await?; Ok(()) } } }), ) .branch( // Filtering allow you to filter updates by some condition. dptree::filter(|msg: Message| msg.chat.is_group() || msg.chat.is_supergroup()) // An endpoint is the last update handler. .endpoint(|msg: Message, bot: Bot| async move { log::info!("Received a message from a group chat."); bot.send_message(msg.chat.id, "This is a group chat.").await?; respond(()) }), ) .branch( // There are some extension filtering functions on `Message`. The following filter will // filter only messages with dices. Message::filter_dice().endpoint(|bot: Bot, msg: Message, dice: Dice| async move { bot.send_message(msg.chat.id, format!("Dice value: {}", dice.value)) .reply_parameters(ReplyParameters::new(msg.id)) .await?; Ok(()) }), ); Dispatcher::builder(bot, handler) // Here you specify initial dependencies that all handlers will receive; they can be // database connections, configurations, and other auxiliary arguments. It is similar to // `actix_web::Extensions`. .dependencies(dptree::deps![parameters]) // If no handler succeeded to handle an update, this closure will be called. .default_handler(|upd| async move { log::warn!("Unhandled update: {:?}", upd); }) // If the dispatcher fails for some reason, execute this handler. .error_handler(LoggingErrorHandler::with_custom_text( "An error has occurred in the dispatcher", )) .enable_ctrlc_handler() .build() .dispatch() .await; } #[derive(Clone)] struct ConfigParameters { bot_maintainer: UserId, maintainer_username: Option, } /// Simple commands #[derive(BotCommands, Clone)] #[command(rename_rule = "lowercase")] enum SimpleCommand { /// Shows this message. Help, /// Shows maintainer info. Maintainer, /// Shows your ID. MyId, } /// Maintainer commands #[derive(BotCommands, Clone)] #[command(rename_rule = "lowercase")] enum MaintainerCommands { /// Generate a number within range #[command(parse_with = "split")] Rand { from: u64, to: u64 }, } async fn simple_commands_handler( cfg: ConfigParameters, bot: Bot, me: teloxide::types::Me, msg: Message, cmd: SimpleCommand, ) -> Result<(), teloxide::RequestError> { let text = match cmd { SimpleCommand::Help => { if msg.from.unwrap().id == cfg.bot_maintainer { format!( "{}\n\n{}", SimpleCommand::descriptions(), MaintainerCommands::descriptions() ) } else if msg.chat.is_group() || msg.chat.is_supergroup() { SimpleCommand::descriptions().username_from_me(&me).to_string() } else { SimpleCommand::descriptions().to_string() } } SimpleCommand::Maintainer => { if msg.from.as_ref().unwrap().id == cfg.bot_maintainer { "Maintainer is you!".into() } else if let Some(username) = cfg.maintainer_username { format!("Maintainer is @{username}") } else { format!("Maintainer ID is {}", cfg.bot_maintainer) } } SimpleCommand::MyId => { format!("{}", msg.from.unwrap().id) } }; bot.send_message(msg.chat.id, text).await?; Ok(()) }