A wrapper for the Telegram Bot API written in Kotlin.
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.fromId(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") {
val result = bot.sendMessage(chatId = ChatId.fromId(message.chat.id), text = "Hi there!")
result.fold({
// do something here with the response
},{
// do something with the error
})
}
}
}
bot.startPolling()
}
Take a look at the examples folder.
There are several samples:
- A simple echo bot
- A more complex sample with commands, filter, reply markup keyboard and more
- A sample getting updates through Telegram's webhook using a Netty server
- An example bot sending polls and listening to poll answers
- 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 {
implementation 'io.github.kotlin-telegram-bot.kotlin-telegram-bot:telegram:x.y.z'
}
- Fork and clone the repo
- Run
./gradlew ktlintFormat
- Run
./gradlew check
to see if tests and ktlint pass. - Commit and push your changes
- Submit a pull request to get your changes reviewed
- 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.
Kotlin Telegram Bot is under the Apache 2.0 license. See the LICENSE for more information.