TelegramBot.NET
0.8.0
See the version list below for details.
dotnet add package TelegramBot.NET --version 0.8.0
NuGet\Install-Package TelegramBot.NET -Version 0.8.0
<PackageReference Include="TelegramBot.NET" Version="0.8.0" />
paket add TelegramBot.NET --version 0.8.0
#r "nuget: TelegramBot.NET, 0.8.0"
// Install TelegramBot.NET as a Cake Addin #addin nuget:?package=TelegramBot.NET&version=0.8.0 // Install TelegramBot.NET as a Cake Tool #tool nuget:?package=TelegramBot.NET&version=0.8.0
<a id="readme-top"></a>
TelegramBot.NET
Ready-to-use library for convenient development of Telegram bots.
Purposes
Many people know the ASP.NET Core platform and its convenience for developing web API applications.
I came up with the idea to implement a similar message processing pattern for telegram bots.
Getting Started
Start by importing the library into your project
dotnet add package TelegramBot.NET --version 1.0.1
- Implement simple handler in your
Program.cs
static void Main(string[] args)
{
BotBuilder builder = new BotBuilder(args)
.UseApiKey(x => x.FromConfiguration());
var app = builder.Build();
app.MapControllers();
app.Run();
}
- Add your API key from BotFather to
appsettings.json
file, key isTelegramBotToken
:
{
"TelegramBotToken": "YOUR_API_TOKEN"
}
or use command line arguments:
./TelegramBot.Console TelegramBotToken=YOUR_API_TOKEN
- Implement controller, in this sample - for handling
/start
command:
public class CommandController(ILogger<CommandController> _logger) : BotControllerBase
{
[BotCommand("/start")]
public async Task<IActionResult> HandleStartAsync()
{
_logger.LogInformation("Start command received.");
await Task.Delay(1000);
return Text("Hello!");
}
}
- Run application - and see result:
info: TelegramBot.BotApp[0]
Bot started - receiving updates.
info: TelegramBot.ConsoleTest.Controllers.HomeController[0]
Start command received.
<p align="right"><a href="#readme-top">back to top</a></p>
Roadmap
- Add command handlers
- Add command query params
- Add response types:
- Text
- Inline
See the open issues for a full list of proposed features (and known issues).
<p align="right"><a href="#readme-top">back to top</a></p>
Contributing
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature
) - Commit your Changes (
git commit -m 'Add some AmazingFeature'
) - Push to the Branch (
git push origin feature/AmazingFeature
) - Open a Pull Request
<p align="right"><a href="#readme-top">back to top</a></p>
License
Distributed under the MIT License. See LICENSE.md for more information.
Contact
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. 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. net8.0 was computed. 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. |
.NET Core | netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.1 is compatible. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.1
- Microsoft.Extensions.Configuration (>= 8.0.0)
- Microsoft.Extensions.Configuration.Abstractions (>= 8.0.0)
- Microsoft.Extensions.Configuration.CommandLine (>= 8.0.0)
- Microsoft.Extensions.Configuration.EnvironmentVariables (>= 8.0.0)
- Microsoft.Extensions.Configuration.Json (>= 8.0.0)
- Microsoft.Extensions.DependencyInjection (>= 8.0.0)
- Microsoft.Extensions.Logging (>= 8.0.0)
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.1)
- Microsoft.Extensions.Logging.Configuration (>= 8.0.0)
- Microsoft.Extensions.Logging.Console (>= 8.0.0)
- Telegram.Bot (>= 19.0.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
1.0.28 | 82 | 11/16/2024 |
1.0.27 | 94 | 10/4/2024 |
1.0.26 | 118 | 9/24/2024 |
1.0.25 | 86 | 9/24/2024 |
1.0.24 | 114 | 9/16/2024 |
1.0.23 | 138 | 8/14/2024 |
1.0.22 | 111 | 8/14/2024 |
1.0.21 | 110 | 8/14/2024 |
1.0.20 | 112 | 8/14/2024 |
1.0.19 | 109 | 8/14/2024 |
1.0.18 | 109 | 8/10/2024 |
1.0.17 | 113 | 8/10/2024 |
1.0.16 | 108 | 8/10/2024 |
1.0.15 | 60 | 8/5/2024 |
1.0.14 | 58 | 8/3/2024 |
1.0.13 | 64 | 8/3/2024 |
1.0.12 | 72 | 8/2/2024 |
1.0.11 | 72 | 8/2/2024 |
1.0.10 | 57 | 7/31/2024 |
1.0.9 | 75 | 7/28/2024 |
1.0.8 | 106 | 7/16/2024 |
1.0.7 | 93 | 7/16/2024 |
1.0.6 | 86 | 7/16/2024 |
1.0.5 | 90 | 7/15/2024 |
1.0.4 | 108 | 7/10/2024 |
1.0.3 | 96 | 7/10/2024 |
1.0.2 | 96 | 7/9/2024 |
1.0.1 | 102 | 7/5/2024 |
0.10.1 | 97 | 7/5/2024 |
0.10.0 | 93 | 7/5/2024 |
0.9.1 | 99 | 7/5/2024 |
0.9.0 | 85 | 7/5/2024 |
0.8.0 | 98 | 7/5/2024 |
0.7.0 | 107 | 7/5/2024 |
0.6.0 | 88 | 7/5/2024 |
0.5.0 | 102 | 7/5/2024 |
0.4.0 | 91 | 7/5/2024 |
0.3.0 | 88 | 7/5/2024 |
0.2.1 | 95 | 7/5/2024 |
0.2.0 | 104 | 7/5/2024 |