From d9c1b6dc34b6a7c9ab002b8417db3f624d42d74f Mon Sep 17 00:00:00 2001 From: Corina Gum <> Date: Fri, 6 Mar 2026 13:51:27 -0800 Subject: [PATCH 1/3] Add docs for targeted messages & reactions being in preview --- .../sending-messages/csharp.incl.md | 24 +++++++++++++++++ .../sending-messages/python.incl.md | 26 +++++++++++++++++++ .../sending-messages/typescript.incl.md | 8 ++++++ .../essentials/sending-messages/README.mdx | 15 +++++++++++ 4 files changed, 73 insertions(+) diff --git a/teams.md/src/components/include/essentials/sending-messages/csharp.incl.md b/teams.md/src/components/include/essentials/sending-messages/csharp.incl.md index 8c817f0f8..53097550d 100644 --- a/teams.md/src/components/include/essentials/sending-messages/csharp.incl.md +++ b/teams.md/src/components/include/essentials/sending-messages/csharp.incl.md @@ -62,3 +62,27 @@ app.OnMessage(async context => ); }); ``` + + + +:::tip[.NET] +In .NET, targeted message APIs are marked with `[Experimental("TEAMS0002")]` and will produce a compiler error until you opt in. Suppress the diagnostic inline with `#pragma warning disable TEAMS0002` or project-wide in your `.csproj`: + +```xml + + $(NoWarn);TEAMS0002 + +``` +::: + + + +:::tip[.NET] +In .NET, reaction APIs are marked with `[Experimental("TEAMS0001")]` and will produce a compiler error until you opt in. Suppress the diagnostic inline with `#pragma warning disable TEAMS0001` or project-wide in your `.csproj`: + +```xml + + $(NoWarn);TEAMS0001 + +``` +::: diff --git a/teams.md/src/components/include/essentials/sending-messages/python.incl.md b/teams.md/src/components/include/essentials/sending-messages/python.incl.md index 9e6a2ebe0..8a093073e 100644 --- a/teams.md/src/components/include/essentials/sending-messages/python.incl.md +++ b/teams.md/src/components/include/essentials/sending-messages/python.incl.md @@ -65,3 +65,29 @@ async def handle_message(ctx: ActivityContext[MessageActivity]): .with_recipient(ctx.activity.from_, is_targeted=True) ) ``` + + + +:::tip[Python] +Preview APIs emit an `ExperimentalWarning` at runtime. To suppress it: + +```python +import warnings +from microsoft_teams.common.experimental import ExperimentalWarning + +warnings.filterwarnings("ignore", category=ExperimentalWarning) +``` +::: + + + +:::tip[Python] +Preview APIs emit an `ExperimentalWarning` at runtime. To suppress it: + +```python +import warnings +from microsoft_teams.common.experimental import ExperimentalWarning + +warnings.filterwarnings("ignore", category=ExperimentalWarning) +``` +::: diff --git a/teams.md/src/components/include/essentials/sending-messages/typescript.incl.md b/teams.md/src/components/include/essentials/sending-messages/typescript.incl.md index d6abc899b..430e535b6 100644 --- a/teams.md/src/components/include/essentials/sending-messages/typescript.incl.md +++ b/teams.md/src/components/include/essentials/sending-messages/typescript.incl.md @@ -59,3 +59,11 @@ app.on('message', async ({ send, activity }) => { ); }); ``` + + + +In TypeScript, preview features are indicated in documentation and do not need any sort of suppression. No opt-in is required. + + + +In TypeScript, preview features are indicated in documentation and do not need any sort of suppression. No opt-in is required. diff --git a/teams.md/src/pages/templates/essentials/sending-messages/README.mdx b/teams.md/src/pages/templates/essentials/sending-messages/README.mdx index dd2c737d1..5ffbf4058 100644 --- a/teams.md/src/pages/templates/essentials/sending-messages/README.mdx +++ b/teams.md/src/pages/templates/essentials/sending-messages/README.mdx @@ -49,3 +49,18 @@ Targeted messages, also known as ephemeral messages, are delivered to a specific To send a targeted message when responding to an incoming activity, use the method with the recipient account and set the targeting flag to true. + +### Targeted messages in preview + + +## Reactions + +:::info[Preview] +Reactions are currently in preview. +::: + +Reactions allow your agent to add or remove emoji reactions on messages in a conversation. The reactions client is available via the API client. + +### Reactions in preview + + From 60d02f4c74ef6308fd45e4a808416b9d17a365f6 Mon Sep 17 00:00:00 2001 From: Corina Gum <> Date: Tue, 10 Mar 2026 12:05:01 -0700 Subject: [PATCH 2/3] Update diagnostic reference --- .../include/essentials/sending-messages/csharp.incl.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/teams.md/src/components/include/essentials/sending-messages/csharp.incl.md b/teams.md/src/components/include/essentials/sending-messages/csharp.incl.md index 53097550d..9bc4775a6 100644 --- a/teams.md/src/components/include/essentials/sending-messages/csharp.incl.md +++ b/teams.md/src/components/include/essentials/sending-messages/csharp.incl.md @@ -66,11 +66,11 @@ app.OnMessage(async context => :::tip[.NET] -In .NET, targeted message APIs are marked with `[Experimental("TEAMS0002")]` and will produce a compiler error until you opt in. Suppress the diagnostic inline with `#pragma warning disable TEAMS0002` or project-wide in your `.csproj`: +In .NET, targeted message APIs are marked with `[Experimental("ExperimentalTeamsTargeted")]` and will produce a compiler error until you opt in. Suppress the diagnostic inline with `#pragma warning disable ExperimentalTeamsTargeted` or project-wide in your `.csproj`: ```xml - $(NoWarn);TEAMS0002 + $(NoWarn);ExperimentalTeamsTargeted ``` ::: @@ -78,11 +78,11 @@ In .NET, targeted message APIs are marked with `[Experimental("TEAMS0002")]` and :::tip[.NET] -In .NET, reaction APIs are marked with `[Experimental("TEAMS0001")]` and will produce a compiler error until you opt in. Suppress the diagnostic inline with `#pragma warning disable TEAMS0001` or project-wide in your `.csproj`: +In .NET, reaction APIs are marked with `[Experimental("ExperimentalTeamsReactions")]` and will produce a compiler error until you opt in. Suppress the diagnostic inline with `#pragma warning disable ExperimentalTeamsReactions` or project-wide in your `.csproj`: ```xml - $(NoWarn);TEAMS0001 + $(NoWarn);ExperimentalTeamsReactions ``` ::: From a7b0855a874b6879be3df43e44d560424c6895d7 Mon Sep 17 00:00:00 2001 From: Corina Gum <> Date: Fri, 13 Mar 2026 13:24:53 -0700 Subject: [PATCH 3/3] Apply PR feedback --- .../sending-messages/python.incl.md | 22 ------------------- .../sending-messages/typescript.incl.md | 4 ---- 2 files changed, 26 deletions(-) diff --git a/teams.md/src/components/include/essentials/sending-messages/python.incl.md b/teams.md/src/components/include/essentials/sending-messages/python.incl.md index 8a093073e..ddfb14fd8 100644 --- a/teams.md/src/components/include/essentials/sending-messages/python.incl.md +++ b/teams.md/src/components/include/essentials/sending-messages/python.incl.md @@ -68,26 +68,4 @@ async def handle_message(ctx: ActivityContext[MessageActivity]): -:::tip[Python] -Preview APIs emit an `ExperimentalWarning` at runtime. To suppress it: - -```python -import warnings -from microsoft_teams.common.experimental import ExperimentalWarning - -warnings.filterwarnings("ignore", category=ExperimentalWarning) -``` -::: - - -:::tip[Python] -Preview APIs emit an `ExperimentalWarning` at runtime. To suppress it: - -```python -import warnings -from microsoft_teams.common.experimental import ExperimentalWarning - -warnings.filterwarnings("ignore", category=ExperimentalWarning) -``` -::: diff --git a/teams.md/src/components/include/essentials/sending-messages/typescript.incl.md b/teams.md/src/components/include/essentials/sending-messages/typescript.incl.md index 430e535b6..920a47873 100644 --- a/teams.md/src/components/include/essentials/sending-messages/typescript.incl.md +++ b/teams.md/src/components/include/essentials/sending-messages/typescript.incl.md @@ -62,8 +62,4 @@ app.on('message', async ({ send, activity }) => { -In TypeScript, preview features are indicated in documentation and do not need any sort of suppression. No opt-in is required. - - -In TypeScript, preview features are indicated in documentation and do not need any sort of suppression. No opt-in is required.