Unicorb.Max.Configuration 0.9.18-alpha

.NET 9.0 This package targets .NET 9.0. The package is compatible with this framework or higher.
This is a prerelease version of Unicorb.Max.Configuration. 
dotnet add package Unicorb.Max.Configuration --version 0.9.18-alpha
                    


                    

                
NuGet\Install-Package Unicorb.Max.Configuration -Version 0.9.18-alpha
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Unicorb.Max.Configuration" Version="0.9.18-alpha" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Unicorb.Max.Configuration" Version="0.9.18-alpha" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Unicorb.Max.Configuration" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add Unicorb.Max.Configuration --version 0.9.18-alpha
                    


                    

                
#r "nuget: Unicorb.Max.Configuration, 0.9.18-alpha"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package Unicorb.Max.Configuration@0.9.18-alpha
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=Unicorb.Max.Configuration&version=0.9.18-alpha&prerelease
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Unicorb.Max.Configuration&version=0.9.18-alpha&prerelease
                    


                            Install as a Cake Tool

Unicorb.Max.Configuration

Max Bot API infrastructure for .NET apps: MaxClient, webhook and polling.

The package does not depend on Unicorb. It only configures Max services.

TFM: net9.0, net10.0

The API may change before version 1.0.0. Depends on the pre-release MaxMessenger.Bot package, so installation may require --prerelease.

Install

dotnet add package Unicorb.Max.Configuration --prerelease

Quick Start

using Max.Bot.Types.Enums;
using Unicorb.Max.Configuration.Enums;
using Unicorb.Max.Configuration.Models;

var maxOptions = new MaxBotConfig
{
    Token = builder.Configuration["Max:Token"]!,
    UpdateMode = MaxUpdateMode.Webhook,
    WebhookBaseUrl = "https://example.com",
    WebhookRoute = "max/webhook",
    AllowedUpdates = [UpdateType.MessageCreated, UpdateType.MessageCallback],
};

builder.Services.AddMaxConfiguration(maxOptions);

Update Modes

  • Webhook: registers a webhook subscription on startup; Max sends POST requests to {WebhookBaseUrl}/{WebhookRoute}.
  • Polling: reads updates with long polling and forwards them by POST to {LocalBaseUrl}/{WebhookRoute}.

For polling, set LocalBaseUrl, for example http://localhost:5000.

Clear Subscriptions

maxOptions.ClearSubscriptionsBeforeConfigure = true;

Use this in webhook mode when old subscriptions must be removed before configuration.

Next Steps

  • Unicorb.Max.Bridge connects Max to the Unicorb pipeline.
  • Unicorb.Max.Configuration.AspNetCore adds app.UseMaxWebhook().
  • IMaxBotUserService stores the GetMe result.
  • MaxBotExtensions provides helpers for Update and Message.
Product Compatible and additional computed target framework versions.
.NET net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on Unicorb.Max.Configuration:

Package Downloads
Unicorb.Max.Configuration.AspNetCore

ASP.NET Core webhook endpoint for Unicorb Max bots: default POST route to IUpdateService
Unicorb.Max.Bridge

Max transport bridge for Unicorb: update pipeline, state machine, extractors, and Bot API adapter

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.9.18-alpha 44 8/3/2026
0.9.17-alpha 45 7/30/2026
0.9.16-alpha 48 7/30/2026
0.9.15-alpha 53 7/30/2026
0.9.14-alpha 48 7/29/2026
0.9.13-alpha 59 7/21/2026
0.9.12-alpha 70 7/20/2026
0.9.11-alpha 57 7/15/2026
0.9.10-alpha 64 7/13/2026
0.9.9-alpha 61 7/13/2026
0.9.8-alpha 60 7/12/2026
0.9.7-alpha 65 7/10/2026
0.9.6-alpha 74 7/10/2026
0.9.5-alpha 62 7/9/2026
0.9.4-alpha 64 7/9/2026
0.9.3-alpha 80 6/24/2026
0.9.2-alpha 75 6/23/2026
0.9.1-alpha 74 6/14/2026
0.9.0-alpha 69 6/14/2026