Telegram.Bot 22.5.0

.NET Client for Telegram Bot API

Nuget Bot API 9.0 Documentations Telegram Chat
Master build Develop build Downloads Contributors License

Telegram.Bot is the most popular .NET Client for Telegram Bot API.

The Bot API is an HTTP-based interface created for developers keen on building bots for Telegram.

Check 👉 Bots: An introduction for developers 👈 to understand what a Telegram bot is and what it can do.

We, the Telegram Bots team, mainly focus on developing multiple NuGet packages for creating chatbots.

➡️ If Bot API is too limited for your use cases you can try Telegram Client API implementation written 100% in C# https://github.com/wiz0u/WTelegramClient

Packages Documentation News Channel Team Group Chat
Packages documentations News Channel Team Group Chat
nuget.org package feed Telegram bots book Subscribe to 📣 @tgbots_dotnet channel to get our latest news The team contributing to this work Join our chat 💬 to talk about bots and ask questions

🔨 Getting Started

Please check ➡️ the Quickstart guide.

🚧 Supported Platforms

Project targets .NET Standard 2.0 and .NET 6 at minimum, with .NET 8 or more recent recommended.

📦 Extension Packages

This project is referred to as the core package and is always required for developing Telegram bots. There are extension packages that you can include in your bot projects for additional functionality:

✅ Correctness & Testing

This project is fully tested using Unit tests and Systems Integration tests before each release. In fact, our test cases are self-documenting and serve as examples for Bot API methods. Once you learn the basics of Telegram chatbots, you will be able to easily understand the code in examples and use it in your own bot projects.

🗂 References

Showing the top 20 packages that depend on Telegram.Bot.

Packages Downloads
Telegram.Bot.Extensions.Polling
Provides ITelegramBotClient extensions for polling updates.
 16
TelegramBotKitCore
Package Description
 15
Telegram.Bot.Extensions.Polling
Provides ITelegramBotClient extensions for polling updates.
 10

- Support for Bot API 9.0 - Removed the *Async-suffixed versions of the methods that were marked [Obsolete] since v22.0. - Services.ConfigureTelegramBot* is no longer necessary to make your Webhook bot compatible with Telegram updates! - Removed dependency on ASP.NET Core (Microsoft.AspNetCore.App) from the main library - Merged the Telegram.Bot.Extensions.Passport package into the main library - New HtmlText helpers method: ToPlain, PlainLength and Truncate to get the plain text only from HTML text (remove the <tags>), the number of plain text characters, or truncate the HTML to a number of plain text characters (useful to comply with the 4096/1024 message limit) - Added constructor ChatAdministratorRights(bool) to set all fields to true or false (except IsAnonymous) - Added helper property message.IsServiceMessage to detect service messages vs content messages 2 small breaking changes: - Merged AnswerShippingQuery method overloads. You'll need to add errorMessage: in your code to pass that argument and indicate failure. - The Poll.Type is now an enum PollType instead of string More details: https://telegrambots.github.io/book/migrate/Version-22.x.html#whats-new-in-version-225

.NET 6.0

.NET Standard 2.0

Version Downloads Last updated
22.7.7-dev.1 0 12/07/2025
22.7.6 0 12/07/2025
22.7.6-dev.9 1 12/06/2025
22.7.6-dev.7 1 12/07/2025
22.7.6-dev.5 1 11/20/2025
22.7.6-dev.4 1 11/19/2025
22.7.6-dev.3 1 11/19/2025
22.7.6-dev.2 1 11/20/2025
22.7.6-dev.1 2 11/19/2025
22.7.5 1 11/17/2025
22.7.4 1 11/18/2025
22.7.4-dev.2 1 11/18/2025
22.7.3 1 11/18/2025
22.7.3-dev.5 2 11/18/2025
22.7.3-dev.4 3 10/17/2025
22.7.3-dev.3 2 10/18/2025
22.7.3-dev.2 3 09/18/2025
22.7.3-dev.1 3 09/16/2025
22.7.2 4 09/17/2025
22.7.2-dev.3 3 09/17/2025
22.7.2-dev.2 3 09/17/2025
22.7.2-dev.1 3 09/17/2025
22.7.1 3 09/17/2025
22.7.1-dev.1 3 09/17/2025
22.7.0 3 09/17/2025
22.7.0-dev.3 3 09/17/2025
22.6.2 5 08/18/2025
22.6.1-dev.4 4 08/18/2025
22.6.1-dev.3 4 08/16/2025
22.6.1-dev.2 4 08/17/2025
22.6.1-dev.1 5 07/16/2025
22.6.0 5 07/17/2025
22.5.2-dev.8 6 07/17/2025
22.5.2-dev.6 6 06/16/2025
22.5.2-dev.5 5 06/17/2025
22.5.2-dev.3 7 05/17/2025
22.5.2-dev.1 6 05/20/2025
22.5.1 6 05/20/2025
22.5.1-dev.2 6 05/20/2025
22.5.1-dev.1 7 04/18/2025
22.5.0 7 04/14/2025
22.5.0-dev.28 7 04/18/2025
22.5.0-dev.24 7 04/18/2025
22.5.0-dev.23 6 04/18/2025
22.5.0-dev.15 1 03/14/2025
22.5.0-dev.14 1 03/14/2025
22.5.0-dev.13 1 03/14/2025
22.5.0-dev.12 1 03/14/2025
22.5.0-dev.9 1 03/14/2025
22.5.0-dev.8 1 03/14/2025
22.5.0-dev.7 1 03/14/2025
22.5.0-dev.6 1 03/14/2025
22.4.5-dev.4 1 03/14/2025
22.4.4 1 03/05/2025
22.4.3 1 03/14/2025
22.4.2 1 03/14/2025
22.4.1 1 03/14/2025
22.4.0 1 03/14/2025
22.3.0 1 03/14/2025
22.2.0 1 03/14/2025
22.1.3 1 03/14/2025
22.1.2 1 03/14/2025
22.1.1 1 03/14/2025
22.1.0 1 03/14/2025
22.0.2 2 11/13/2024
22.0.1 1 03/14/2025
22.0.0 1 03/14/2025
19.0.0 12 07/11/2024
19.0.0-preview.4 9 03/14/2025
19.0.0-preview.2 9 03/14/2025
19.0.0-preview.1 7 03/14/2025
18.0.0 8 03/14/2025
18.0.0-alpha.3 8 03/14/2025
18.0.0-alpha.2 8 03/14/2025
18.0.0-alpha.1 7 03/14/2025
17.0.0 8 03/14/2025
17.0.0-alpha.5 8 03/14/2025
17.0.0-alpha.4 7 03/14/2025
17.0.0-alpha.3 8 03/14/2025
17.0.0-alpha.2 8 03/14/2025
17.0.0-alpha.1 7 03/14/2025
16.0.2 8 10/18/2024
16.0.1 9 03/14/2025
16.0.0 9 03/14/2025
16.0.0-alpha.2 7 03/14/2025
16.0.0-alpha.1 8 03/14/2025
15.7.1 8 03/14/2025
15.7.0 8 03/14/2025
15.6.0 8 03/14/2025
15.5.1 9 03/14/2025
15.5.0 9 03/14/2025
15.4.0 8 03/14/2025
15.3.0 6 03/14/2025
15.2.1 8 03/14/2025
15.2.0 9 03/14/2025
15.1.0 7 03/14/2025
15.0.0 8 03/14/2025
14.12.0 9 03/14/2025
14.11.0 7 03/14/2025
14.10.0 8 03/14/2025
14.9.0 7 03/14/2025
14.8.0 8 03/14/2025
14.7.0 8 03/14/2025
14.6.0 7 03/14/2025
14.5.0 8 03/14/2025
14.4.0 8 03/14/2025
14.3.0 7 03/14/2025
14.2.0-rc-452 8 03/14/2025
14.0.0-rc-367 8 03/14/2025
14.0.0-beta-342 8 03/14/2025
14.0.0-alpha0 7 03/14/2025
13.4.0 9 03/14/2025
13.4.0-rc2 7 03/14/2025
13.4.0-rc1 9 03/14/2025
13.3.0-rc1 7 03/14/2025
13.2.1 7 03/14/2025
13.1.0 9 03/14/2025