kotlin-telegram-bot's Introduction

Kotlin Telegram Bot

A wrapper for the Telegram Bot API written in Kotlin.

Usage

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(message.chat.id), text = text)
            }
        }
    }
    bot.startPolling()
}

Want to route commands?:

fun main() {
    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()
}

Examples

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

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 {
    implementation 'io.github.kotlin-telegram-bot.kotlin-telegram-bot:telegram:x.y.z'
}

Detailed documentation

Contributing

Fork and clone the repo
Run ./gradlew ktlintFormat
Run ./gradlew build to see if tests, ktlint and abi checks pass.
Commit and push your changes
Submit a pull request to get your changes reviewed

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.