Documentation: | Latest crates.io version | master |
A library for writing your own Telegram bots. More information here. Official API here.
Here is a simple example (see example/simple.rs
):
extern crate futures;
extern crate telegram_bot;
extern crate tokio;
use std::env;
use futures::{Stream, future::lazy};
use telegram_bot::*;
fn main() {
let mut runtime = tokio::runtime::current_thread::Runtime::new().unwrap();
runtime.block_on(lazy(|| {
let token = env::var("TELEGRAM_BOT_TOKEN").unwrap();
let api = Api::configure(token).build().unwrap();
// Convert stream to the stream with errors in result
let stream = api.stream().then(|mb_update| {
let res: Result<Result<Update, Error>, ()> = Ok(mb_update);
res
});
// Print update or error for each update.
tokio::executor::current_thread::spawn(
stream.for_each(move |update| {
match update {
Ok(update) => {
// If the received update contains a new message...
if let UpdateKind::Message(message) = update.kind {
if let MessageKind::Text { ref data, .. } = message.kind {
// Print received text message to stdout.
println!("<{}>: {}", &message.from.first_name, data);
// Answer message with "Hi".
api.spawn(message.text_reply(
format!("Hi, {}! You just wrote '{}'", &message.from.first_name, data)
));
}
}
}
Err(_) => {}
}
Ok(())
})
);
Ok::<_, ()>(())
})).unwrap();
runtime.run().unwrap();
}
You can find a bigger examples in the examples
.
This library is available via crates.io
. In order to use it, just add this to your Cargo.toml
:
telegram-bot = "0.7"
Yes please! Every type of contribution is welcome: Create issues, hack some code or make suggestions. Don't know where to start? Good first issues are tagged with up for grab.