#telegram #bot #api #library #framework


An awesome framework to build Telegram bots up to telegram-bot library

2 unstable releases

Uses old Rust 2015

0.2.0 Jul 18, 2018
0.1.0 Sep 2, 2015

#6 in #bot-api

MIT OR Apache-2.0 OR Beerware

869 lines

Awesome Bot

Travis Crates.io


A framework to build your own Telegram bots easily. More information here. Official API here.

This framework is based on telegram-bot library to communicate with the API.


This framework is available in crates.io. Just add this to your Cargo.toml dependencies:

awesome-bot = "0.1.0"


Here is a simple example (download from examples/simple.rs).

extern crate awesome_bot;

use awesome_bot::*;

fn echohandler(bot: &AwesomeBot, msg: &Message, _: String, args: Vec<String>) {
    // We can access safely because the pattern match have that argument mandatory
    let toecho = &args[1];
    let phrase = format!("Echoed: {}", toecho);
    // Send the text in a beauty way :)
    let sent = bot.answer(msg).text(&phrase).end();
    println!("{:?}", sent);

fn main() {
    // Create the Awesome Bot (You need TELEGRAM_BOT_TOKEN environment with the token)
    let mut bot = AwesomeBot::from_env("TELEGRAM_BOT_TOKEN");
    // Add a command, this will add the routing to that function.
    bot.command("echo (.+)", echohandler);

    // Start the bot with getUpdates
    let res = bot.simple_start();
    if let Err(e) = res {
        println!("An error occurred: {}", e);

In the examples folder there is more code:

  • examples/simple.rs: An echo example, really simple.
  • examples/complete.rs: An example that have all (I think, probably not all, but almost all) features of awesome-bot, it's a big example ;-)

Note: To execute examples/complete.rs with all the features, you will need to add some test files that the bot will send, this files shall be: files/test.{jpg, mp3, mp4, pdf, webp} for image, audio/voice, video, document and sticker


All help are welcome! Open issues, open PR of code or documentation, make suggestions, tell me that my rust sucks (and why), what you want :)

You can contact me in telegram.


Licensed under either of

at your option.


Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be triple licensed as above, without any additional terms or conditions.


~224K SLoC