NetTelegramBotApi 5.3.0

.NET 6.0
dotnet add package NetTelegramBotApi --version 5.3.0
NuGet\Install-Package NetTelegramBotApi -Version 5.3.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="NetTelegramBotApi" Version="5.3.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add NetTelegramBotApi --version 5.3.0
#r "nuget: NetTelegramBotApi, 5.3.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install NetTelegramBotApi as a Cake Addin
#addin nuget:?package=NetTelegramBotApi&version=5.3.0

// Install NetTelegramBotApi as a Cake Tool
#tool nuget:?package=NetTelegramBotApi&version=5.3.0


C# client library for building Telegram bot (

Contains strongly-types request and response classes, and transport class for sending requests and receiving results.



var bot = new TelegramBot(accessToken);
var me = await bot.MakeRequestAsync(new GetMe());
if (me != null)
   Console.WriteLine("Me: {0} (@{1})", me.FirstName, me.Username);

See TelegramBotDemo project for more samples.

Version history

5.0.0 - net5.0

  • Target framworks changed: net5.0 only
  • System.Text.Json replaces Newtosoft.Json

4.0.0 - Big update

Telegram API updated up to v2.3 (November 21, 2016). Message editing, games - everything should work except inline mode (see below).

Breaking changes (compared to 3.8.1):

  1. MakeRequestAsync now throws BotRequestException if non-Ok response is received from server.
  2. Typo fixed on Contact type: PhoneNumber was PhoneNumbet
  3. ReplyKeyboardHide renamed to ReplyKeyboardRemove (when it had been renamed in API???)
  4. Breaking changes in API 2.3:
    • Parameter EditMessage replaced with DisableEditMessage in SetGameScore
    • In ReplyKeyboardRemove: HideKeyboard renamed to RemoveKeyboard

Inline mode

Inline mode needs a lot of new classes to be created. Please make PR if you wish to help.

3.8.1 - .NET Core RTM, netstandard1.3

  • Upgraded to .NET Core 1.0.0 and netstandard1.3

3.7.50926 - API updates, proxy support

  • Changes in Telegram API defined as August 29, 2015 implemented (issue #19):
  • Added support for uploading certificates in SetWebhook
  • Changes in Telegram API defined as September 7, 2015 implemented (issue #20):
  • Added ParseMode field to SendMessage request for simple markdown markup (see FAQ for details)
  • Changes in Telegram API defined as September 18, 2015 implemented (issue #21):
  • Bots can now download files and media sent by users, use GetFile request and File object (run demo project and send him a picture!)
  • Proxy support added:
  • Use WebProxy property when creating bot (see issue #22 for sample)

3.6.50925 - Upgrade to vNext

Project converted to Visual Studio 2015 and new project type (xproj).

NuGet package now targets multiple runtimes: net45, dnx45, dnx50 and dnxcore50.

New demo console app added (TelegramBotDemo-vNext) for testing under dnx451 runtime. Old demo app ('classic' console project) also available, but Attention! Now it grabs package from nuget! (because old-style .csproj can't reference new .xproj assemblies directly).

3.5.50818 - API changes 'August 15, 2015'

Changes in Telegram API defined as August 15, 2015 implemented (issue #13).

All real changes were already implemented in 3.5.50816, only some documenation/comments are updated in this version.

3.5.50816 - API changes

  • Changes in Telegram API defined as July 2015 implemented (issue #7):
  • The Caption field has been removed from the Video object and added to the Message object instead.
  • Caption and Duration optional fields have been added to the SendVideo request.
  • UserId type in the Contact object changed to Long (was String - typo in API docs)
  • Changes, not [yet?] announced in Telegram API changlog:
  • Performer and Title optional fields have been added to Audio object
  • Duration, Performer and Title optional fields have been added to the SendAudio request
  • Object Voice added (to Message class)
  • SendVoice request added

3.4.50815 - Webhooks support, bugfixes

Improvements for working via webhooks:

  • SetWebhook request added (Issue #3)
  • DeserializeUpdate method added to convert webhook POST json value to Update object

Fixed issue #6 with sending files with non-latin characters in name.

3.3.50701 - DateTimeOffset instead of long

Message properties Date and ForwardDate are now DateTimeOffset (converted to local time).

3.2.50628 - With sending files

Methods for sending files (SendPhoto, SendVideo, etc) implemented.

3.1.50627 - Using HttpClient

Switched to HttpClient (instead of HttpRequest):

  • no more System.Web dependency;
  • MakeRequest method is now async only, use .Result or .Wait() for synchronous calls

2.1.50626 - Requests hierarchy

Refactored to new request model - base RequestBase class and one (and one async) MakeRequest method.

Major version increased to "2", patch version set to current date.

1.0.1 - Initial release

Response class hierarchy (Types), first requests. It works!

Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed. 
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on NetTelegramBotApi:

Package Downloads

Simple framework for building Telegram bots.

GitHub repositories (1)

Showing the top 1 popular GitHub repositories that depend on NetTelegramBotApi:

Repository Stars
Project is DEAD, Discord server:
Version Downloads Last updated
5.3.0 315 7/26/2023
5.2.0 1,674 2/14/2023
5.1.0 454 2/3/2023
5.0.0 2,723 5/26/2021
4.2.0 7,481 12/15/2017
4.1.0 4,906 3/14/2017
4.0.0 2,844 11/25/2016
3.8.1 3,482 7/17/2016
3.7.50926 3,118 9/25/2015
3.6.50925 2,019 9/25/2015
3.5.50818 1,538 8/18/2015
3.5.50816 1,141 8/15/2015
3.4.50815 1,111 8/15/2015
3.3.50701 1,247 7/1/2015
3.2.50628 1,158 6/28/2015
2.1.50626 1,151 6/26/2015

MessageThreadId, ChatActionEnum, MarkdownV2