telegrambot
"Batteries Included" Telegram Bot API wrapper for Scala
Features
- Fully asynchronous
- spray.io powered.
- Declarative DSL for simple bot features
- Strongly-typed
Supported Methods
- getMe
- sendMessage
- getUpdates
- forwardMessage
- sendPhoto
- sendAudio
- sendVoice (coming soon)
- sendDocument
- sendSticker
- sendVideo (coming soon)
- sendLocation
- sendChatAction
- getUserProfilePhotos
- getUpdates
- Custom keyboard markups
- Webhook with a SSL reverse proxy
TODO
- Built-in Webhook support
- Better error handling
- Documentation
Configuration
Check reference.conf for configuration.
Installation
There is no release yet; project still lack too much improvement. Wait for updates.
Usage
Simple commands + simple answers
object GreeterBot extends TelegramBot with Polling with Declarative {
on("/start") { implicit message: Message =>
reply("Welcome")
}
}Using received message
object GreeterBot extends TelegramBot with Polling with Declarative {
on("/start") { implicit message: Message =>
message.from match {
case Some(user) => reply("Welcome, " + user.firstName)
case _ =>
}
}
}Sending photos
object GreeterBot extends TelegramBot with Polling with Declarative {
on("/start") { implicit message: Message =>
sendPhoto("~/image.jpg")
}
}When You Need More Power
object GreeterBot extends TelegramBot with Polling with Declarative {
when { message =>
message.photo match {
case Some(photo) => true
case None => false
}
} perform { implicit message =>
reply("Nice Smile!")
}
}"Cuckoo Clock?" Why Not?
object GreeterBot extends TelegramBot with Polling with Declarative {
every(1 hours) {
sendTo("Ping!", 31415926535)
}
}Sending Messages Not Always Successful
object TestBot extends TelegramBot with Polling with Declarative {
sendTo("test", 1093654812) map {
case Right(message) =>
println(message);
case Left(error) if error.code == 403 =>
println("No, we are not allowed to send messages to this chat");
case Left(error) if error.code == 400 =>
println("No, chat doesn't exists");
}
}Keep user informed!
on("Welcome") { implicit message =>
typing; reply("typed.")
}
}