Skip to content

Revise agent reactions documentation for Teams#14326

Draft
nickwalkmsft wants to merge 1 commit into
mainfrom
nickwalkmsft-reactions-doc-update
Draft

Revise agent reactions documentation for Teams#14326
nickwalkmsft wants to merge 1 commit into
mainfrom
nickwalkmsft-reactions-doc-update

Conversation

@nickwalkmsft
Copy link
Copy Markdown

@nickwalkmsft nickwalkmsft commented May 16, 2026

Updated the overview of agent reactions in Teams, including changes to the title, description, and content structure.

Preview

@microsoft-production-github-app
Copy link
Copy Markdown

Acrolinx Scorecards

We currently enforce a minimum score of 80.

Click the scorecard links for each article to review the Acrolinx feedback on grammar, spelling, punctuation, writing style, and terminology:

Article Score Issues Scorecard Processed
msteams-platform/agents-in-teams/agent-reactions.md 87 12 link

More info about Acrolinx

Use the Acrolinx extension, or sidebar, in Visual Studio Code to check spelling, grammar, style, tone, clarity, and key terminology when you're creating or updating content. For more information, see Use the Visual Studio Code extension to run Acrolinx locally.


# [CSharp](#tab/cs1)


Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Put prescriptive instruction for each language in prose over the code sample

@learn-build-service-prod
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit c1c3930:

⚠️ Validation status: warnings

File Status Preview URL Details
msteams-platform/agents-in-teams/agent-reactions.md ⚠️Warning View Details

msteams-platform/agents-in-teams/agent-reactions.md

  • Line 33, Column 3: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#enable-an-agent-to-add-reactions' in 'agents-in-teams/agent-reactions.md'.
  • Line 123, Column 172: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#enable-an-agent-to-add-reactions' in 'agents-in-teams/agent-reactions.md'.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

```csharp
app.OnMessage(async context =>
{
await context.Send("Hello! I'll react to this message.");
Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should be "to your message" in all examples?

@@ -2,21 +2,21 @@
title: Agent Reactions in Teams - Overview
Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

TODO

Like users, agents can add multiple reactions to each message in a conversation, and can also remove reactions after adding them. Users and agents can only remove their own reactions, not those placed by others.


You can enable an agent to send reactions using Teams SDK or REST APIs. An agent can send up to two reactions per second. To enable an agent to send a reaction to a message:
Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

TODO remove "enable" everywhere

@learn-build-service-prod
Copy link
Copy Markdown
Contributor

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
# [REST API](#tab/h1)

Apply everywhere

- [Best practices](#best-practices)

## Enable an agent to add reactions
## React to a message
Copy link
Copy Markdown
Author

@nickwalkmsft nickwalkmsft May 16, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## React to a message
## Add and remove reactions on messages

Just cover both

> - `200 OK` is also returned if the agent or bot adds a reaction that already exists or removes one that isn’t applied. These operations don’t return errors.
> - You can find more information on [error codes for sending messages](../bots/build-conversational-capability.md).

## Modify skin tone for emojis
Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Move this to the reference page

Updated the overview of agent reactions in Teams, including changes to
the title, description, and content structure.
@nickwalkmsft nickwalkmsft force-pushed the nickwalkmsft-reactions-doc-update branch from c1c3930 to 03b7aba Compare May 19, 2026 23:24
@microsoft-production-github-app
Copy link
Copy Markdown

Acrolinx Scorecards

We currently enforce a minimum score of 80.

Click the scorecard links for each article to review the Acrolinx feedback on grammar, spelling, punctuation, writing style, and terminology:

Article Score Issues Scorecard Processed
msteams-platform/TOC.yml 92 25 link
msteams-platform/agents-in-teams/agent-reactions.md 87 12 link

More info about Acrolinx

Use the Acrolinx extension, or sidebar, in Visual Studio Code to check spelling, grammar, style, tone, clarity, and key terminology when you're creating or updating content. For more information, see Use the Visual Studio Code extension to run Acrolinx locally.

@learn-build-service-prod
Copy link
Copy Markdown
Contributor

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

@learn-build-service-prod
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 03b7aba:

⚠️ Validation status: warnings

File Status Preview URL Details
msteams-platform/agents-in-teams/agent-reactions.md ⚠️Warning View Details
msteams-platform/TOC.yml ✅Succeeded View

msteams-platform/agents-in-teams/agent-reactions.md

  • Line 33, Column 3: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#enable-an-agent-to-add-reactions' in 'agents-in-teams/agent-reactions.md'.
  • Line 122, Column 172: [Warning: bookmark-not-found - See documentation] Cannot find bookmark '#enable-an-agent-to-add-reactions' in 'agents-in-teams/agent-reactions.md'.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant