Kotlin Telegram Bot
A wrapper for the Telegram Bot API written in Kotlin.
Usage
Creating a bot instance is really simple:
fun main(args: Array<String>) {
val bot = bot {
token = "YOUR_API_KEY"
}
}
Now lets poll telegram API and route all text updates:
fun main(args: Array<String>) {
val bot = bot {
token = "YOUR_API_KEY"
dispatch {
text { bot, update ->
val text = update.message?.text ?: "Hello, World!"
bot.sendMessage(chatId = update.message!!.chat.id, text = text)
}
}
}
bot.startPolling()
}
Want to route commands?:
fun main(args: Array<String>) {
val bot = bot {
token = "YOUR_API_KEY"
dispatch {
command("start") { bot, update->
val result = bot.sendMessage(chatId = update.message!!.chat.id, text = "Hi there!")
result.fold({
// do something here with the response
},{
// do something with the error
})
}
}
}
bot.startPolling()
}
Examples
Take a look at the examples folder.
There is a simple echo bot and a more complex one with commands and reply markup keyboard.
Download
- Add the JitPack repository to your root build.gradle file:
repositories {
maven { url "https://jitpack.io" }
}
- Add the code to your module's build.gradle file:
dependencies {
compile 'io.github.seik.kotlin-telegram-bot:telegram:x.y.z'
}
TODO
- webhook
Contributing
Pull requests are welcomed. ✨
Thanks
- Big part of the architecture of this project is inspired by python-telegram-bot, check it out!
- Some awesome kotlin ninja techniques were grabbed from Fuel.
License
Kotlin Telegram Bot is under the Apache 2.0 license. See the LICENSE for more information.