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(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 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

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

Getting updates

Contributing

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

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.