Golang Telegram Bot library

Heavily inspired by the python-telegram-bot library, this package is a code-generated wrapper for the telegram bot api. We also provide an extensions package which defines an updater/dispatcher pattern to avoid having to rewrite update processing.

All the telegram types and methods are generated from a bot api spec. These are generated in the gen_*.go files. You can generate these by running go generate.

To allow for reproducible CI builds, we pin the latest spec commit in the spec_commit file. This is used by default when running go generate. To update the spec_commit, run GOTGBOT_UPGRADE=true go generate - this will fetch the latest commit sha and regenerate the library against that.

If you have any questions, come find us in our telegram support chat!

Features:

• All telegram API types and methods are generated from the bot api docs, which makes this library:
  • Guaranteed to match the docs
  • Easy to update
  • Self-documenting (Re-uses pre-existing telegram docs)
• Type safe; no weird interface{} logic, all types match the bot API docs.
• No third party library bloat; only uses standard library.
• Updates are each processed in their own go routine, encouraging concurrent processing, and keeping your bot responsive.
• Code panics automatically recovered from and logged, avoiding unexpected downtime.

Getting started

Download the library with the standard go get command:

go get github.com/PaulSonOfLars/gotgbot/v2

Example bots

Sample bots can be found in the samples directory.

Docs

Docs can be found here.

Contributing

Contributions are welcome! More information on contributing can be found here.