TelegramBotBase 7.0.0

Prefix Reserved

There is a newer prerelease version of this package available.
See the version list below for details.

dotnet add package TelegramBotBase --version 7.0.0

NuGet\Install-Package TelegramBotBase -Version 7.0.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="TelegramBotBase" Version="7.0.0" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="TelegramBotBase" Version="7.0.0" />
                    

                            Directory.Packages.props

<PackageReference Include="TelegramBotBase" />
                    

                            Project file

For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.

paket add TelegramBotBase --version 7.0.0

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: TelegramBotBase, 7.0.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.

#:package TelegramBotBase@7.0.0

#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.

#addin nuget:?package=TelegramBotBase&version=7.0.0
                    

                            Install as a Cake Addin

#tool nuget:?package=TelegramBotBase&version=7.0.0
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Major Highlights

1. New Examples and Dependency Injection

Dependency Injection Example Added:
- New project Examples/DependencyInjection demonstrating full dependency injection with Entity Framework Core (BotDbContext, User model, DI setup).
- Shows forms using injected database context for user management and state.
New Middleware Example:
- Examples/MiddlewareBaseBot and associated forms demonstrate advanced message loop handling and middleware capabilities.

2. Action Manager Extension

New Project: TelegramBotBase.Extensions.ActionManager
- Provides an "Action Manager" for handling unhandled bot actions/callbacks, including navigation and value parsing.
- Supports custom actions for strings, integers, GUIDs, and navigation patterns (start with, end with, etc.).
- Includes detailed documentation on usage and extensibility.

3. PostgreSQL & Legacy JSON Session Serializers

New Extension: TelegramBotBase.Extensions.Serializer.Database.PostgreSql
- Enables session serialization and state management using PostgreSQL.
- Includes code, SQL schema, and documentation.
New Extension: TelegramBotBase.Extensions.Serializer.Legacy.NewtonsoftJson
- Allows state serialization using Newtonsoft.Json for legacy compatibility.

4. Image Extensions for IronSoftware

New Project: TelegramBotBase.Extensions.Images.IronSoftware
- Enables platform-independent image sending using IronSoftware’s drawing library.
- Adds helper methods for both AnyBitmap and ImageSharp images.

5. Other New Example Projects

FileWatcher Example:
- Monitors directory changes and sends Telegram messages on file events.
MiddlewareBaseBot, InlineAndReplyCombination, SystemCommandsBot, etc.:
- Several example bots updated or added to demonstrate features and integration patterns.

Upgrades and Improvements

Nuget Packages Updated:
- Many .csproj files upgraded to use the latest versions of TelegramBotBase, EntityFrameworkCore, and other dependencies.
Project Structure Enhanced:
- Consistent use of package references over project references for TelegramBotBase in most example projects.
- Added new README content, badges, and links for various packages and extension modules.

Documentation

README.md Expanded:
- New sections on Action Manager, Localizations, PostgreSQL/MSSQL/Legacy serializers, and all new example projects.
- Added links to Discord and Telegram support groups.
- Detailed usage instructions for new extensions and features.
New README files:
- Each extension and major new subproject now has its own README with installation, usage, and feature documentation.

Miscellaneous

License Updated:
- Copyright year updated to 2025.
Localization Updates:
- Added documentation and support for multiple language localizations.
Bugfixes and Internal Improvements:
- Various improvements to serialization, error messages, and internal extension methods.

Notable New Files and Projects

TelegramBotBase.Extensions.ActionManager/ (new extension)
TelegramBotBase.Extensions.Serializer.Database.PostgreSql/
TelegramBotBase.Extensions.Images.IronSoftware/
TelegramBotBase.Extensions.Serializer.Legacy.NewtonsoftJson/
Examples/DependencyInjection/
Examples/FileWatcher/
Examples/MiddlewareBaseBot/

Product	Compatible and additional computed target framework versions.
.NET	net5.0 was computed. net5.0-windows was computed. 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 is compatible. 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. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed.
.NET Core	netcoreapp3.1 is compatible.

Product

.NET

.NET Core

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

.NETCoreApp 3.1
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 9.0.0)
- Telegram.Bot (>= 22.2.0)
net6.0
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 9.0.0)
- Telegram.Bot (>= 22.2.0)
net7.0
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 9.0.0)
- Telegram.Bot (>= 22.2.0)
net8.0
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 9.0.0)
- Telegram.Bot (>= 22.2.0)
net9.0
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 9.0.0)
- Telegram.Bot (>= 22.2.0)

NuGet packages (6)

Showing the top 5 NuGet packages that depend on TelegramBotBase:

Package	Downloads
TelegramBotBase.Extensions.Images This is an extension for sending Bitmap/Images via TelegramBotBase.	5.6K
TelegramBotBase.Extensions.Serializer.Database.PostgreSql A session serializer for PostgreSQL Server.	2.0K
TelegramBotBase.Extensions.Serializer.Database.MSSQL A session serializer for Microsoft SQL Server.	1.3K
TelegramBotBase.Extensions.ActionManager This is a action manager extension to use with the C# TelegramBotBase library.	921
TelegramBotBase.Extensions.Images.IronSoftware This is an extension for sending Bitmap/Images platform independent by using IronSoftware's drawing library via TelegramBotBase.	466

GitHub repositories

This package is not used by any popular GitHub repositories.

Version	Downloads	Last Updated
7.1.0-preview.1	186	11/16/2025
7.0.0	722	6/28/2025
7.0.0-preview.14	220	6/16/2025
7.0.0-preview.13	122	6/7/2025
7.0.0-preview.12	107	5/17/2025
7.0.0-preview.11	162	4/20/2025
7.0.0-preview.10	502	3/26/2025
7.0.0-preview.9	467	3/25/2025
7.0.0-preview.8	481	3/25/2025
7.0.0-preview.7	289	3/23/2025
7.0.0-preview.6	74	3/22/2025
7.0.0-preview.5	187	2/18/2025
7.0.0-preview.4	111	2/16/2025
7.0.0-preview.3	94	2/6/2025
7.0.0-preview.2	178	12/15/2024
7.0.0-preview.1	103	12/14/2024
6.6.3	280	6/7/2025
6.6.2	685	3/25/2025
6.6.1	790	2/18/2025
6.6.0	348	12/14/2024
6.6.0-preview.5	150	11/9/2024
6.6.0-preview.4	93	10/15/2024
6.6.0-preview.3	112	9/25/2024
6.6.0-preview.2	120	7/15/2024
6.6.0-preview.1	94	7/11/2024
6.6.0-alpha.3	79	9/30/2024
6.5.1	759	7/10/2024
6.5.0	272	6/29/2024
6.5.0-preview.9	95	6/9/2024
6.5.0-preview.8	101	5/29/2024
6.5.0-preview.6	95	5/27/2024
6.5.0-preview.5	96	5/25/2024
6.5.0-preview.4	100	5/19/2024
6.5.0-preview.3	99	5/12/2024
6.5.0-preview.2	93	5/12/2024
6.5.0-preview.1	113	3/10/2024
6.4.1	1,664	3/10/2024
6.4.0-preview.4	113	1/24/2024
6.4.0-preview.3	100	1/24/2024
6.4.0-preview.2	91	1/24/2024
6.4.0-preview.1	127	12/26/2023
6.3.4	547	1/31/2024
6.3.3	679	1/30/2024
6.3.2	416	1/28/2024
6.3.1	450	1/24/2024
6.3.0	673	12/26/2023
6.3.0-preview.2	133	12/9/2023
6.3.0-preview.1	111	12/7/2023
6.2.0	637	12/6/2023
6.1.1-alpha	490	11/26/2023
6.1.0-alpha	642	9/29/2023
6.0.0	2,399	9/13/2023
6.0.0-preview.2	133	9/11/2023
6.0.0-preview.1	129	9/9/2023
5.3.1-alpha	962	6/4/2023
5.3.0	984	8/25/2023
5.3.0-alpha	697	6/4/2023
5.2.3-alpha	897	1/27/2023
5.2.2-alpha	937	1/23/2023
5.2.1-alpha	759	1/21/2023
5.2.0	1,347	11/23/2022
5.1.4-alpha	777	10/9/2022
5.1.3-alpha	763	9/21/2022
5.1.2-alpha	741	9/1/2022
5.1.1-alpha	737	8/29/2022
5.1.0-alpha	812	5/15/2022
5.0.14-alpha	819	1/5/2022
5.0.13-alpha	793	1/4/2022
5.0.12-alpha	812	12/25/2021
5.0.11-alpha	801	12/25/2021
5.0.10-alpha	789	12/25/2021
5.0.9-alpha	811	12/19/2021
5.0.8-alpha	820	12/17/2021
5.0.7-alpha	825	12/16/2021
5.0.6-alpha	819	12/16/2021
5.0.5-alpha	787	12/6/2021
5.0.4-alpha	1,916	11/28/2021
5.0.3-alpha	1,953	11/28/2021
5.0.2-alpha	2,716	11/26/2021
5.0.1-alpha	831	11/10/2021
5.0.0	1,650	1/10/2022
4.0.2	1,060	10/17/2021
4.0.1	1,297	10/1/2021
4.0.0	1,028	8/13/2021
3.3.0	1,494	2/28/2021
3.2.3	1,198	12/4/2020
3.2.2	1,157	10/22/2020
3.2.1	1,374	9/6/2020
3.2.0	1,163	9/6/2020
3.1.1	1,450	5/4/2020
3.1.0	1,192	5/4/2020
3.0.0	1,241	4/9/2020
2.1.0	1,319	11/28/2019
2.0.0	1,292	9/28/2019
1.5.2	1,250	9/17/2019
1.5.1	1,289	8/23/2019
1.5.0	1,298	7/15/2019
1.4.3	1,254	6/26/2019
1.4.2	1,251	6/22/2019
1.4.1	1,350	5/4/2019
1.4.0	1,355	3/27/2019
1.3.1.2	1,321	3/20/2019
1.3.1.1	1,310	3/20/2019
1.3.1	1,345	3/20/2019
1.3.0	1,281	3/18/2019
1.2.1	1,341	2/22/2019
1.2.0	1,329	2/22/2019
1.1.2	1,355	2/21/2019
1.1.1	1,426	2/21/2019
1.1.0	1,707	2/20/2019

- Dependency update. Removing .Net Framework target and replacing with .Net Standard 2.0