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.

⚠️ 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)

📝 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)

1. 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

2. To rename SendTextMessageAsync with SendMessage
   Replace: \.SendTextMessageAsync\b
       With: .SendMessage
   🖱️Click on Replace All

3. To remove the Async suffixes:
   Replace: (bot\.\w+)Async\b
       With: $1
   🖱️Click on Replace All

4. 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