اضافه شدن متد 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();

بهبود ابزار لانگ پولینگ مربوط به DI

اضافه شدن مثال‌های جدید در پوشه Samples پروژه در هم‌گیت

اضافه شدن روش استفاده از ناگت به صورت لوکال مشاهده تغییرات مورد نیاز

‌

تغییر متد MapBaleBotWebhook جهت مدیریت خطا در زمان قطعی ای‌پی‌آی بله

اضافه شدن مثال جدید در پوشه Samples\Webhook : روش انعطاف‌پذیری در مقابل در دسترس نبودن ای‌پی‌آی بله

امکان دانلود فایل‌های ناگت از صفحه اول پروژه https://hamgit.ir/moqavem/balebotnet

‌