اضافه شدن نسخه مناسب دات‌نت 10 در کنار ادامه پشتیبانی از دانت‌های 9 و 8

اضافه شدن کلاس BaleBotNetJsonTools برای سریالیز و دی‌سریالیز تایپ‌ها

‌

حذف دپندنسی بلااستفاده

حذف ClearKeyBoardMarkup.

روش جایگزین

غیر فعال کردن تنظیمات json مربوط به بله از کل پروژه

توضیحات

‌

استفاده از نسخه LTS دات‌نت 10

اضافه شدن پراپرتی جدید SenderChat به Message طبق آخرین بروزرسانی API بله

اضافه شدن متد جدید EditMessageReplyMarkup به بات و اکستنشن متد EditReplyMarkup به Message طبق آخرین بروزرسانی API بله

‌

اضافه شدن متد AskReview

اضافه شدن متد و تایپ‌های GetChatMember با جزئیات دسترسی‌ها و نقش کاربر در چت

‌

روش استفاده

با تشکر از ...

dotnet new webapi -n MyBaleBot

code ./MyBaleBot

dotnet new gitignore

var builder = WebApplication.CreateBuilder(args);

var app = builder.Build();

app.Run();

dotnet add package BaleBotNet --source https://mirror-nuget.runflare.com/v3/index.json

using BaleBotNet;
using BaleBotNet.Types;

namespace MyBaleBot.Services.Bot;

public class BotUpdateHandler : IUpdateHandler
{
    public async Task HandleUpdate(Update update, CancellationToken cancellationToken = default)
    {
        Console.WriteLine($"Update #{update.UpdateId} recived!");
    }
}

using BaleBotNet;
using BaleBotNet.Methods;

namespace MyBaleBot.Services.Bot;

public class BotLongPollingService(IServiceScopeFactory scopeFactory, BaleBotClient bot)
{
    public async Task Run(
        CancellationToken cancellationToken,
        int limit = 10,
        int? offset = null,
        int millisecondsDelay = 1000
    )
    {
        Console.WriteLine("Runnig LongPollingService.");

        while (!cancellationToken.IsCancellationRequested)
        {
            var updates = await bot.GetUpdates(offset, limit);

            var tasks = updates
                .Select(x =>
                {
                    using var scope = scopeFactory.CreateScope();
                    var updateHandler = scope.ServiceProvider.GetRequiredService<IUpdateHandler>();

                    return updateHandler.HandleUpdate(x);
                })
                .ToList();
            try
            {
                if (tasks?.Count > 0)
                    await Task.WhenAll(tasks);
            }
            catch (Exception) { }

            if (updates?.Length > 0)
                offset = updates?.Last().UpdateId + 1;

            await Task.Delay(millisecondsDelay, cancellationToken);
        }

        Console.WriteLine("LongPollingService CancellationRequested");
    }
}

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "BotToken": "1234:abcd"
}

using BaleBotNet;
using MyBaleBot.Services.Bot;

namespace MyBaleBot.Configs;

public static class BotConfigs
{
    public static void AddBaleBot(this WebApplicationBuilder builder, bool addLongPollingService)
    {
        builder.Services.AddBaleBotClient(builder.Configuration["BotToken"]!);

        builder.Services.AddScoped<IUpdateHandler, BotUpdateHandler>();

        if (addLongPollingService)
            builder.Services.AddScoped<BotLongPollingService>();
    }

    public static async Task StartBotLongPolling(this WebApplication app)
    {
        using var scope = app.Services.CreateScope();
        var longPollingService = scope.ServiceProvider.GetRequiredService<BotLongPollingService>();

        await Task.Run(
            () => longPollingService.Run(app.Lifetime.ApplicationStopping),
            app.Lifetime.ApplicationStopping
        );
    }
}

using MyBaleBot.Configs;

var builder = WebApplication.CreateBuilder(args);

builder.AddBaleBot(addLongPollingService: true);

var app = builder.Build();

await app.StartBotLongPolling();

app.Run();

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "BotToken": "1234:abcd",
  "AppBaseUrl": "https://my-bot-real-url.ir"
}

using BaleBotNet;
using MyBaleBot.Services.Bot;

namespace MyBaleBot.Configs;

public static class BotConfigs
{
    public static void AddBaleBot(this WebApplicationBuilder builder, bool addLongPollingService)
    {
        builder.Services.AddBaleBotClient(builder.Configuration["BotToken"]!);

        builder.Services.AddScoped<IUpdateHandler, BotUpdateHandler>();

        if (addLongPollingService)
            builder.Services.AddScoped<BotLongPollingService>();
    }

    public static async Task StartBotLongPolling(this WebApplication app)
    {
        using var scope = app.Services.CreateScope();
        var longPollingService = scope.ServiceProvider.GetRequiredService<BotLongPollingService>();

        await Task.Run(
            () => longPollingService.Run(app.Lifetime.ApplicationStopping),
            app.Lifetime.ApplicationStopping
        );
    }

    public static void MapBotWebhook(this WebApplication app)
    {
        app.MapBaleBotWebhook(app.Configuration["AppBaseUrl"]!);
    }
}

using MyBaleBot.Configs;

var builder = WebApplication.CreateBuilder(args);

builder.AddBaleBot(addLongPollingService: true);

var app = builder.Build();

if (app.Environment.IsDevelopment())
{
    await app.StartBotLongPolling();
}
else
{
    app.MapBotWebhook();
}

app.Run();

using BaleBotNet;
using BaleBotNet.Types;

namespace MyBaleBot.Services.Bot;

public class BotUpdateHandler(IServiceScopeFactory scopeFactory) : IUpdateHandler
{
    public async Task HandleUpdate(Update update, CancellationToken cancellationToken = default)
    {
        // Console.WriteLine($"Update #{update.UpdateId} recived!");

        using var scope = scopeFactory.CreateScope();

        var updateId = update.UpdateId;

        var handler = update switch
        {
            { Message: { } } => OnMessage(scope, updateId, update.Message),
            { EditedMessage: { } } => OnEditedMessage(scope, updateId, update.EditedMessage),
            { CallbackQuery: { } } => OnCallback(scope, updateId, update.CallbackQuery),
            { PreCheckoutQuery: { } } => OnPreCheckout(scope, updateId, update.PreCheckoutQuery),
            _ => Task.CompletedTask
        };

        await handler;
    }

    private static async Task OnMessage(IServiceScope scope, int updateId, Message message)
    {
        Task? task = null;

        task ??= Task.CompletedTask;
        await task;
    }

    private static async Task OnCallback(IServiceScope scope, int updateId, CallbackQuery query)
    {
        Task? task = null;

        task ??= Task.CompletedTask;
        await task;
    }

    private static async Task OnEditedMessage(IServiceScope scope, int updateId, Message message)
    {
        Task? task = null;

        task ??= Task.CompletedTask;
        await task;
    }

    private static async Task OnPreCheckout(
        IServiceScope scope,
        int updateId,
        PreCheckoutQuery query
    )
    {
        Task? task = null;

        task ??= Task.CompletedTask;
        await task;
    }
}

namespace MyBaleBot.Helpers;

public static class ScopeHelpers
{
    public static T Get<T>(this IServiceScope scope)
        where T : notnull => scope.ServiceProvider.GetRequiredService<T>();
}

using BaleBotNet.Enums;
using BaleBotNet.Types;

namespace MyBaleBot.Helpers;

public static class UpdateReciverHelpers
{
    public static bool IsPrivate(this Message message) => message.Chat.Type == ChatType.Private;

    public static bool IsGroup(this Message message) => message.Chat.Type == ChatType.Group;

    public static bool IsFromChat(this Message message, long chatId) => message.Chat.Id == chatId;

    public static bool IsFromChat(this CallbackQuery query, long chatId) =>
        query.Message?.Chat?.Id == chatId;

    public static bool IsCommand(this Message message, string command)
    {
        var firstPart = message.Text?.Split(" ").ElementAtOrDefault(0);

        if (firstPart == null)
            return false;

        return firstPart.Equals(command, StringComparison.OrdinalIgnoreCase);
    }
}

namespace MyBaleBot.Services.Bot;

public static class BotConsts
{
    public static class Commands
    {
        public const string Start = "/start";
        public const string Whois = "/whois";
    }

    public static readonly Dictionary<string, string> CommandsMenu =
        new() { { Commands.Start, "شروع مجدد" }, { Commands.Whois, "من کی‌ام؟" } };
}

using System.Text;
using BaleBotNet;
using BaleBotNet.Methods;
using BaleBotNet.Types;

namespace MyBaleBot.Services.Bot.Handlers;

public class StartCommandHandler(BaleBotClient bot)
{
    public async Task Run(Message message)
    {
        var chatId = message.Chat.Id;
        List<Task> tasks = [bot.SendChatAction(chatId, BaleBotNet.Enums.ChatAction.Typing)];

        StringBuilder messageBuilder = new();
        messageBuilder.AppendLine($"به بازوی @{bot.Me.Username} خوش آمدید.");
        messageBuilder.AppendLine();

        foreach (var menu in BotConsts.CommandsMenu)
        {
            messageBuilder.AppendLine($"{menu.Key} | *{menu.Value}*");
        }

        tasks.Add(bot.SendMessage(chatId: chatId, text: messageBuilder.ToString()));

        await Task.WhenAll(tasks);
    }
}

using System.Text;
using BaleBotNet;
using BaleBotNet.Methods;
using BaleBotNet.Types;

namespace MyBaleBot.Services.Bot.Handlers;

public class WhoisCommandHandler(BaleBotClient bot)
{
    public async Task Run(Message message)
    {
        var chatId = message.Chat.Id;
        List<Task> tasks = [bot.SendChatAction(chatId, BaleBotNet.Enums.ChatAction.Typing)];

        StringBuilder messageBuilder = new();
        messageBuilder.AppendLine($"*{BotConsts.CommandsMenu[BotConsts.Commands.Whois]}*");
        messageBuilder.AppendLine();

        var user = message.Chat;

        messageBuilder.AppendLine($"نام: *{user.FirstName} {user.LastName}*");
        if (user.Username is string username)
            messageBuilder.AppendLine($"نام کاربری: *@{username}*");
        messageBuilder.AppendLine($"شناسه: *{user.Id}*");

        tasks.Add(
            bot.SendMessage(
                chatId: chatId,
                text: messageBuilder.ToString(),
                replyMarkup: ReplyKeyboard.CreateInline(
                    [
                        [
                            new()
                            {
                                Text = "کپی شناسه",
                                CopyText = new() { Text = user.Id.ToString() }
                            }
                        ]
                    ]
                )
            )
        );

        await Task.WhenAll(tasks);
    }
}

    private static async Task OnMessage(IServiceScope scope, int updateId, Message message)
    {
        Task? task = null;

        if (message.IsPrivate() && message.IsCommand(BotConsts.Commands.Start))
            task = scope.Get<StartCommandHandler>().Run(message);
        else if (message.IsCommand(BotConsts.Commands.Whois))
            task = scope.Get<WhoisCommandHandler>().Run(message);

        task ??= Task.CompletedTask;
        await task;
    }

using MyBaleBot.Services.Bot.Handlers;

namespace MyBaleBot.Configs;

public static class ServicesConfigs
{
    public static void AddServices(this WebApplicationBuilder builder)
    {
        builder.Services.AddScoped<StartCommandHandler>();
        builder.Services.AddScoped<WhoisCommandHandler>();
    }
}

using MyBaleBot.Configs;

var builder = WebApplication.CreateBuilder(args);

builder.AddBaleBot(addLongPollingService: builder.Environment.IsDevelopment());
builder.AddServices();

var app = builder.Build();

if (app.Environment.IsDevelopment())
{
    app.StartBotLongPolling();
}
else
{
    app.MapBotWebhook();
}

app.Run();