Migration guide for version 22.x

If you're migrating from version 19.x, you might want to read our migration doc for v21 first. There were lots of interesting changes in versions v21.x.

We are back on Nuget.org!
And our old nuget feed nuget.voids.site is no more, so please remove this line from your nuget.config file, or from your IDE settings (Package sources)

⚠️ Breaking changes

We removed the Async suffix from our API method names, and renamed SendTextMessageAsync to SendMessage.
This was done to match official API documentation and because all our TelegramBotClient methods are asynchronous (no real need to differenciate between async or non-async methods)

We also reordered a few optional parameters to move away the lesser used arguments later down the argument list (typically: message_thread_id/entities) and move the more useful arguments up closer to the beginning (typically: replyParameters/replyMarkup)
This should make your life simpler as you won't need to resort to named arguments for the most commonly used method parameters.

Finally, we renamed property Message.MessageId as just Message.Id. (but MessageId will remain supported)

note

All the previous names are still supported at the moment, so your code should just run fine with version 22.0, except you will get warnings about "Obsolete" code while compiling.

📝 How to adapt your code for these changes

In order to port your code easily and get rid of compiler warnings, I suggest you use these 4 Find and Replace operations in your IDE

So start by opening the Edit > Find and Replace > Replace in Files panel (Ctrl+Shift+H)
Untick the checkboxes: Match case and Match whole word
Tick the checkbox: ✓ Use regular expressions
Select the scope to look in: Current project or Entire solution

(In the following, we suppose your TelegramBotClient variable is named bot, please modify the expressions if necessary)

To remove explicit null arguments for messageThreadId/entities
Replace: (bot\.Send\w+Async\b.*,) null,
With: $1
🖱️Click on Replace All
🖱️Click on Replace All again
To rename SendTextMessageAsync with SendMessage
Replace: \.SendTextMessageAsync\b
With: .SendMessage
🖱️Click on Replace All
To remove the Async suffixes:
Replace: (bot\.\w+)Async\b
With: $1
🖱️Click on Replace All
To rename the MessageId property:
Replace: (message)\.MessageId\b
With: $1.Id
🖱️Click on Replace All
(Depending on your variable naming convention, you might want to repeat that, replacing (message) with (msg) or something else)

The remaining effort to make your code compile should now be much reduced.
(maybe a few more parameter reordering if you didn't use named parameters)

Addendum: we also renamed method MakeRequestAsync to SendRequest (if you use this non-recommended method)

What's new in version 22.0

Support for Bot API 7.11
Implicit conversions for single-field structures
For example classes containing just one string (like BotDescription, WebAppInfo or CopyTextButton) can be handled just as a string
Implicit conversion from FileBase classes to InputFile
This means you can pass an object like a Video or PhotoSize directly as argument to a Send method and it will use its FileId
Helper method GetFileIdType
It can tell you which type of object/media is referenced by a FileId string
Huge rewrite of our serialization code to make it more performant and straightforward.
Updated System.Text.Json due to vulnerability CVE-2024-43485

What's new in version 22.1

Support for Bot API 8.0
new helper message.MessageLink() to get the t.me link to that message (Supergroup and Channel only)
ToHtml/ToMarkdown: support for ExpandableBlockquote (v22.1.1)
fix savePreparedInlineMessage request (v22.1.2)
TransactionPartnerUser.Gift type was corrected in Bot API (v22.1.3)

What's new in version 22.2