Need help with kotlin-telegram-bot?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

453 Stars 87 Forks Apache License 2.0 236 Commits 38 Opened issues


🤖 A wrapper for the Telegram Bot API written in Kotlin

Services available


Need anything else?

Contributors list

Kotlin Telegram Bot

Build Status Release ktlint

A wrapper for the Telegram Bot API written in Kotlin.


Creating a bot instance is really simple:

fun main() {
    val bot = bot {
        token = "YOUR_API_KEY"

Now lets poll telegram API and route all text updates:

fun main() {
    val bot = bot {
        token = "YOUR_API_KEY"
        dispatch {
            text {
                bot.sendMessage(ChatId.fromId(, text = text)

Want to route commands?:

fun main() {
    val bot = bot {
        token = "YOUR_API_KEY"
        dispatch {
            command("start") {
                val result = bot.sendMessage(chatId = ChatId.fromId(, text = "Hi there!")
                    // do something here with the response
                    // do something with the error 


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 "" }
  • Add the code to your module's build.gradle file:
dependencies {
    implementation 'io.github.kotlin-telegram-bot.kotlin-telegram-bot:telegram:x.y.z'

Detailed documentation

  1. Getting updates
  2. Polls
  3. Dice
  4. Logging
  5. Games


  1. Fork and clone the repo
  2. Run
    ./gradlew ktlintFormat
  3. Run
    ./gradlew build
    to see if tests, ktlint and abi checks pass.
  4. Commit and push your changes
  5. 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.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.