MAX.Bot.NetFramework 1.0.1

MAX Bot Client для .NET Framework

.NET Framework клиент для работы с API мессенджера MAX. Библиотека предоставляет полный набор методов для взаимодействия с ботами, включая отправку сообщений, управление чатами и обработку событий в реальном времени.

Особенности

• ✅ Долгосрочный polling — обработка событий в реальном времени
• ✅ Dependency Injection — готовая интеграция с ASP.NET Core
• ✅ Гибкая конфигурация — несколько способов создания клиента

Установка

Через NuGet Package Manager

Install-Package MAX.Bot.NetFramework

Через .NET CLI

dotnet add package MAX.Bot.NetFramework

Через PackageReference

<PackageReference Include="MAX.Bot.NetFramework" Version="1.0.0.0" />

Быстрый старт

1. Получение токена бота

Перед началом работы получите токен бота в Личном кабинете разработчика MAX.

2. Базовое использование

using MAX.Bot;
using MAX.Bot.Interfaces;
using MAX.Bot.Interfaces.Models;

// Создание клиента с токеном
var botClient = new MaxBotClient("YOUR_BOT_TOKEN");

// Получение информации о боте
var botInfo = await botClient.GetMeAsync();
Console.WriteLine($"Бот: {botInfo.FirstName} (ID: {botInfo.Id})");

// Отправка сообщения
await botClient.SendMessageAsync(new SendMessageRequest
{
    ChatId = 123456789,
    Text = "Привет от бота! 👋",
    Format = MessageFormat.Markdown,
});

// Получение обновлений
var _ = maxApiClient.PollUpdatesWithCallback(
    async (update, client) =>
    {
        Console.WriteLine($"Сообщение: {update?.Message?.Body?.Text}");

        if (update?.UpdateType == UpdateTypes.MessageCreated)
        {
            await client.SendMessageAsync(new SendMessageRequest
            {
                Text = update.Message?.Body?.Text,
                ChatId = -70581633278133,
            });
        }
    },
    limit: 100,
    timeout: 90,
    types: new List<string> { UpdateTypes.MessageCreated }
);

Способы создания клиента

1. Простой конструктор (рекомендуется для консольных приложений)

// С токеном и таймаутом по умолчанию (30 секунд)
var client = new MaxBotClient("your_token_here");

// С кастомным таймаутом
var client = new MaxBotClient("your_token_here", timeoutSeconds: 60);

2. Dependency Injection (рекомендуется для ASP.NET Core)

// В Program.cs
builder.Services.AddMaxBotClient(builder.Configuration["MaxBot:Token"]);

// В классе сервиса
public class BotService
{
    private readonly IMaxBotClient _botClient;
    
    public BotService(IMaxBotClient botClient)
    {
        _botClient = botClient;
    }
    
    public async Task SendWelcomeMessage(long chatId)
    {
        await _botClient.SendMessageAsync(new SendMessageRequest
        {
            ChatId = chatId,
            Text = "Добро пожаловать!"
        });
    }
}

API методов

Документация API методов для реализации в библиотеке.

Легенда статусов

• ✅ — Реализовано полностью
• 🚧 — Реализовано частично
• ❌ — Не реализовано

Методы API

🤖 Bots

✉️ Messages

💬 Chats

📡 Subscriptions

📁 Upload