Skip to content

Targeted messaging phase 1.5: User sends & slash commands#14360

Merged
nickwalkmsft merged 378 commits into
mainfrom
nickwalk-slash-commands
May 28, 2026
Merged

Targeted messaging phase 1.5: User sends & slash commands#14360
nickwalkmsft merged 378 commits into
mainfrom
nickwalk-slash-commands

Conversation

@nickwalkmsft

@nickwalkmsft nickwalkmsft commented May 23, 2026

Copy link
Copy Markdown
Collaborator

Supersedes #14182.

ADO: https://domoreexp.visualstudio.com/MSTeams/_workitems/edit/5246775

Targeted messaging 1.5: user sends, slash commands. Also includes updates to prompt suggestions.

Previews:

@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-slash-commands.md 97 7 link
msteams-platform/agents-in-teams/targeted-messages.md 94 9 link
msteams-platform/includes/bots/suggested-actions.md 89 6 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

Learn Build status updates of commit 5d17306:

✅ Validation status: passed

File Status Preview URL Details
msteams-platform/agents-in-teams/agent-slash-commands.md ✅Succeeded View
msteams-platform/agents-in-teams/targeted-messages.md ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/agent-private-response.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/agent-public-response.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/agent-responses-actions.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/agent-slash-commands.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/private-prompt-preview.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/public-prompt-preview.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/slash-command-compose-box.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/slash-command-desktop.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/slash-command-example.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/slash-command-mobile.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/slash-command.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/targeted-messages/targeted-message-example.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/targeted-messages/targeted-messages.png ✅Succeeded View
msteams-platform/assets/images/bots/suggested-action-channel-desktop.png ✅Succeeded View
msteams-platform/assets/images/bots/suggested-action-channel.png ✅Succeeded View
msteams-platform/assets/images/bots/suggested-action-gc.png ✅Succeeded View
msteams-platform/assets/images/bots/suggested-action-personal-chat-desktop.png ✅Succeeded View
msteams-platform/assets/images/bots/suggested-action-personal-chat.png ✅Succeeded View
msteams-platform/includes/bots/suggested-actions.md ✅Succeeded View
msteams-platform/TOC.yml ✅Succeeded View

For more details, please refer to the build report.

@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.

@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-slash-commands.md 97 7 link
msteams-platform/agents-in-teams/targeted-messages.md 94 9 link
msteams-platform/includes/bots/suggested-actions.md 89 6 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

Learn Build status updates of commit 05d10ea:

✅ Validation status: passed

File Status Preview URL Details
msteams-platform/agents-in-teams/agent-slash-commands.md ✅Succeeded View
msteams-platform/agents-in-teams/targeted-messages.md ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/agent-private-response.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/agent-public-response.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/agent-responses-actions.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/agent-slash-commands.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/private-prompt-preview.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/public-prompt-preview.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/slash-command-compose-box.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/slash-command-desktop.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/slash-command-example.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/slash-command-mobile.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/slash-command.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/targeted-messages/targeted-message-example.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/targeted-messages/targeted-messages.png ✅Succeeded View
msteams-platform/assets/images/bots/suggested-action-channel-desktop.png ✅Succeeded View
msteams-platform/assets/images/bots/suggested-action-channel.png ✅Succeeded View
msteams-platform/assets/images/bots/suggested-action-gc.png ✅Succeeded View
msteams-platform/assets/images/bots/suggested-action-personal-chat-desktop.png ✅Succeeded View
msteams-platform/assets/images/bots/suggested-action-personal-chat.png ✅Succeeded View
msteams-platform/includes/bots/suggested-actions.md ✅Succeeded View
msteams-platform/TOC.yml ✅Succeeded View

For more details, please refer to the build report.

@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.

@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-slash-commands.md 94 9 link
msteams-platform/agents-in-teams/targeted-messages.md 94 9 link
msteams-platform/includes/bots/suggested-actions.md 89 6 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

Learn Build status updates of commit 4287613:

✅ Validation status: passed

File Status Preview URL Details
msteams-platform/agents-in-teams/agent-slash-commands.md ✅Succeeded View
msteams-platform/agents-in-teams/targeted-messages.md ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/agent-private-response.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/agent-public-response.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/agent-responses-actions.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/agent-slash-commands.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/private-prompt-preview.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/public-prompt-preview.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/slash-command-compose-box.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/slash-command-desktop.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/slash-command-example.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/slash-command-mobile.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/slash-command.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/targeted-messages/targeted-message-example.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/targeted-messages/targeted-messages.png ✅Succeeded View
msteams-platform/assets/images/bots/suggested-action-channel-desktop.png ✅Succeeded View
msteams-platform/assets/images/bots/suggested-action-channel.png ✅Succeeded View
msteams-platform/assets/images/bots/suggested-action-gc.png ✅Succeeded View
msteams-platform/assets/images/bots/suggested-action-personal-chat-desktop.png ✅Succeeded View
msteams-platform/assets/images/bots/suggested-action-personal-chat.png ✅Succeeded View
msteams-platform/includes/bots/suggested-actions.md ✅Succeeded View
msteams-platform/TOC.yml ✅Succeeded View

For more details, please refer to the build report.

@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.

@nickwalkmsft nickwalkmsft self-assigned this May 28, 2026
Comment thread msteams-platform/agents-in-teams/targeted-messages.md Outdated
Comment thread msteams-platform/agents-in-teams/targeted-messages.md Outdated
Targeted message operations can return `400 Bad argument` when the payload is invalid. On create, this error usually means the recipient is missing. Call `WithRecipient(account, isTargeted: true)` with a valid Account object. The same requirement applies to the `Send TM` API.

# [HTTP](#tab/api)
`400 Bad argument` can also occur when recipient data is included where it shouldn't be. Don't pass a recipient on update or delete, and don't include it in the `Edit TM` API payload.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Not critical: I would recommend a table in the next version. Any reason for a verbose description over a table?

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

A few things:

  • Error tables typically aren't a good fit for developer documentation; they work well in reference. Our reference story around Teams SDK isn't great right now but it'll improve and will start to include that kind of stuff.
  • This could be shorter (still prose, but just a few sentences covering the most essential and potentially confusing stuff). Long term much of this info could be relocated to a more general error handling/troubleshooting article. A lot of this is general error/troubleshooting information, not specific to TM.

@dampbrownshoes dampbrownshoes left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

one nit on TMs not being supported in 1-1 bot chats both from user to bot and bot to user. (also mean slash is not supported 1-1 bot chat).

@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-slash-commands.md 95 9 link
msteams-platform/agents-in-teams/targeted-messages.md 94 9 link
msteams-platform/includes/bots/suggested-actions.md 89 6 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 b013560:

✅ Validation status: passed

File Status Preview URL Details
msteams-platform/agents-in-teams/agent-slash-commands.md ✅Succeeded View
msteams-platform/agents-in-teams/targeted-messages.md ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/agent-private-response.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/agent-public-response.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/agent-responses-actions.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/agent-slash-commands.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/private-prompt-preview.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/public-prompt-preview.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/slash-command-compose-box.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/slash-command-desktop.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/slash-command-example.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/slash-command-mobile.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/slash-command.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/targeted-messages/targeted-message-example.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/targeted-messages/targeted-messages.png ✅Succeeded View
msteams-platform/assets/images/bots/suggested-action-channel-desktop.png ✅Succeeded View
msteams-platform/assets/images/bots/suggested-action-channel.png ✅Succeeded View
msteams-platform/assets/images/bots/suggested-action-gc.png ✅Succeeded View
msteams-platform/assets/images/bots/suggested-action-personal-chat-desktop.png ✅Succeeded View
msteams-platform/assets/images/bots/suggested-action-personal-chat.png ✅Succeeded View
msteams-platform/includes/bots/suggested-actions.md ✅Succeeded View
msteams-platform/TOC.yml ✅Succeeded View

For more details, please refer to the build report.

@nickwalkmsft
nickwalkmsft marked this pull request as ready for review May 28, 2026 19:37
@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-slash-commands.md 98 6 link
msteams-platform/agents-in-teams/targeted-messages.md 94 9 link
msteams-platform/includes/bots/suggested-actions.md 89 6 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 85d49c8:

✅ Validation status: passed

File Status Preview URL Details
msteams-platform/agents-in-teams/agent-slash-commands.md ✅Succeeded View
msteams-platform/agents-in-teams/targeted-messages.md ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/agent-private-response.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/agent-public-response.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/agent-responses-actions.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/agent-slash-commands.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/private-prompt-preview.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/public-prompt-preview.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/slash-command-compose-box.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/slash-command-desktop.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/slash-command-example.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/slash-command-mobile.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/agent-slash-commands/slash-command.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/targeted-messages/targeted-message-example.png ✅Succeeded View
msteams-platform/assets/images/agents-in-teams/targeted-messages/targeted-messages.png ✅Succeeded View
msteams-platform/assets/images/bots/suggested-action-channel-desktop.png ✅Succeeded View
msteams-platform/assets/images/bots/suggested-action-channel.png ✅Succeeded View
msteams-platform/assets/images/bots/suggested-action-gc.png ✅Succeeded View
msteams-platform/assets/images/bots/suggested-action-personal-chat-desktop.png ✅Succeeded View
msteams-platform/assets/images/bots/suggested-action-personal-chat.png ✅Succeeded View
msteams-platform/includes/bots/suggested-actions.md ✅Succeeded View
msteams-platform/TOC.yml ✅Succeeded View

For more details, please refer to the build report.

@nickwalkmsft nickwalkmsft changed the title Targeted messaging & slash commands revisions Targeted messaging & slash commands May 28, 2026
@nickwalkmsft nickwalkmsft changed the title Targeted messaging & slash commands Targeted messaging phase 1.5: User sends & slash commands May 28, 2026
@nickwalkmsft
nickwalkmsft merged commit 8feb03d into main May 28, 2026
4 checks passed
@nickwalkmsft
nickwalkmsft deleted the nickwalk-slash-commands branch May 28, 2026 20:48
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.

3 participants