BotPages/docs/GETTING_STARTED.md

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

Это руководство поможет быстро запустить demo?приложение с Telegram?адаптером.

Требования

• .NET 8 SDK
• Токен Telegram?бота (для demo)

Сборка

dotnet build

Запуск demo

1. Установите переменную окружения TELEGRAM_TOKEN:

setx TELEGRAM_TOKEN "<token>"   # Windows
export TELEGRAM_TOKEN="<token>" # Linux/macOS

2. Запустите demo:

dotnet run --project Demo

Пример конфигурации приложения

var app = new BotPagesApp(stateStorage, logger)
    .AddTelegramAdapter(token)
    .AddDefaultPage<WelcomePage>()
    .MapCommand<WelcomePage>("/start")
    .AddMiddleware(new LoggingMiddleware(logger));

await app.Build(CancellationToken.None);

Основные понятия

• SendRequest — единый формат запроса на отправку (текст, файлы, кнопки, адаптер?опции). Используйте PageContext.SendAsync для отправки.
• Page / StatefulPage / SingletonPage — модели страниц и их жизненный цикл.
• IPageMiddleware — middleware выполняется для каждого входящего обновления.

Далее: см. docs/API_REFERENCE.md для описания публичных API.