Soenneker.ServiceBus.Receptors.MsTeams 11.0.1101

Prefix Reserved
dotnet add package Soenneker.ServiceBus.Receptors.MsTeams --version 11.0.1101
                    
NuGet\Install-Package Soenneker.ServiceBus.Receptors.MsTeams -Version 11.0.1101
                    
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="Soenneker.ServiceBus.Receptors.MsTeams" Version="11.0.1101" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Soenneker.ServiceBus.Receptors.MsTeams" Version="11.0.1101" />
                    
Directory.Packages.props
<PackageReference Include="Soenneker.ServiceBus.Receptors.MsTeams" />
                    
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 Soenneker.ServiceBus.Receptors.MsTeams --version 11.0.1101
                    
#r "nuget: Soenneker.ServiceBus.Receptors.MsTeams, 11.0.1101"
                    
#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 Soenneker.ServiceBus.Receptors.MsTeams@11.0.1101
                    
#: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=Soenneker.ServiceBus.Receptors.MsTeams&version=11.0.1101
                    
Install as a Cake Addin
#tool nuget:?package=Soenneker.ServiceBus.Receptors.MsTeams&version=11.0.1101
                    
Install as a Cake Tool

alternate text is missing from this package README image alternate text is missing from this package README image alternate text is missing from this package README image alternate text is missing from this package README image

Soenneker.ServiceBus.Receptors.MsTeams

Consumes messages from the msteams Azure Service Bus queue, deserializes MsTeamsMessage bodies, and hands them to IMsTeamsSender through Flywheel.

Installation

dotnet add package Soenneker.ServiceBus.Receptors.MsTeams

Prerequisites

Configure Azure:ServiceBus:ConnectionString. The credential needs queue-management and receive permissions because initialization creates the msteams queue when absent and starts a processor.

Configure Flywheel storage and workers. Include [JsonSerializable(typeof(MsTeamsMessage))] in the JSON context supplied to Flywheel, or use MsTeamsJsonContext.Default when Teams is the only payload. The registrar adds the job invoker and IMsTeamsSender as a scoped service for each execution.

Register and start

using Soenneker.ServiceBus.Receptors.MsTeams.Abstract;
using Soenneker.ServiceBus.Receptors.MsTeams.Registrars;

services.AddMsTeamsReceptorAsSingleton();

Registration alone does not start processing. Resolve and initialize the singleton receptor during application startup:

IMsTeamsReceptor receptor =
    services.GetRequiredService<IMsTeamsReceptor>();

await receptor.Init(cancellationToken);

Dispose the receptor during shutdown so its Service Bus processor stops cleanly.

Message contract

The Service Bus body must be a JSON representation of Soenneker.Messages.MsTeams.MsTeamsMessage. Deserialization uses the source-generated MsTeamsJsonContext with System.Text.Json.

After deserialization, the receptor enqueues this Flywheel call:

IMsTeamsSender.SendMessage(
    message,
    cancellationToken)

The Service Bus ApplicationProperties["type"] value is accepted by the base receptor but is not used to choose a Teams DTO or sender path in this implementation.

The Service Bus delivery token is used while persisting the job. The sender receives the Flywheel execution token when a worker invokes the job.

Delivery behavior

The Service Bus message is completed only after its body is deserialized and Flywheel persists the job. Deserialization or enqueue failures flow back to the processor, leaving the broker message unsettled for retry and eventual dead-lettering according to queue policy.

Delivery is at least once across the handoff. If Flywheel persists a job but Service Bus completion fails, another delivery can enqueue the same Teams message again. Use a stable message identifier or another idempotency mechanism when duplicate webhook posts are unacceptable.

Message bodies can contain webhook URLs and user-supplied card content. This receptor does not write failed bodies to its own error log; apply the same care to upstream Service Bus logging and Flywheel argument storage.

Product Compatible and additional computed target framework versions.
.NET net11.0 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
11.0.1101 0 11/21/2026
11.0.1100 0 11/21/2026
11.0.1099 48 11/21/2026
11.0.1098 48 11/20/2026
11.0.1097 50 11/20/2026
11.0.1096 41 11/20/2026
11.0.1095 46 11/20/2026
11.0.1094 45 11/20/2026
11.0.1093 43 11/20/2026
11.0.1092 96 11/19/2026
11.0.1091 72 11/19/2026
11.0.1090 67 11/19/2026
11.0.1089 88 11/19/2026
11.0.1088 84 11/19/2026
11.0.1087 84 11/19/2026
11.0.1085 77 11/19/2026
11.0.1084 77 11/19/2026
11.0.1083 77 11/19/2026
11.0.1082 78 11/18/2026
11.0.1081 73 11/18/2026
Loading failed

Update dependency Soenneker.Flywheel.Core to 11.0.559 (#1606)