-
Notifications
You must be signed in to change notification settings - Fork 167
SSO for Message Extension
Message extensions allow the users to interact with your web service through buttons and forms in the Microsoft Teams client. They can search or initiate actions in an external system from the compose message area, the command box, or directly from a message. You can send back the results of that interaction to the Teams client in the form of a richly formatted card.
Function | Scenario | Example |
---|---|---|
Action Commands | You want some external system to do an action and the result of the action to be sent back to your conversation. | Reserve a resource and allow the channel to know the reserved time slot. |
Search Commands | You want to find something in an external system, and share the results with the conversation. | Search for a work item in Azure DevOps, and share it with the group as an Adaptive Card. |
Link Unfurling | You want to complete a complex task involving multiple steps or lots of information in an external system, and share the results with a conversation. | Create a bug in your tracking system based on a Teams message, assign that bug to Bob, and send a card to the conversation thread with the bug's details. |
There is a MSDN document going to introduce the SSO ability for Message Extension. This artile says that SSO handlers just work for Search Actions
and Link Unfurling
.
According to the mechanism introduced in the article, we have implemented an api handleMessageExtensionQueryWithSSO
in @microsoft/teamsfx
, which can help users realize me's sso more conveniently.
API Name | Message Extension Invoke Type | SDK Minimum Version |
---|---|---|
handleMessageExtensionLinkQueryWithSSO | composeExtension/queryLink | 2.3.1-beta.2023110805.0 |
handleMessageExtensionQueryWithSSO | composeExtension/query | 2.0.0 |
Please reference this sample code for the basic usage.
API sample link |
---|
handleMessageExtensionLinkQueryWithSSO |
handleMessageExtensionQueryWithSSO |
Scenario-based Tutorials
- Send notifications to Teams
- Respond to chat commands in Teams
- Respond to card actions in Teams
- Embed a dashboard canvas in Teams
Extend Teams app across Microsoft 365
- Create and test a personal tab across Microsoft 365
- Create and test a search-based message extension across Microsoft 365
Documentation
- Manage Application settings with Teams Toolkit
- Manage Microsoft Entra Application Registration with Teams Toolkit
How To Guides
- How to use an existing Microsoft Entra app
- How to use a multi-tenant Microsoft Entra app
- How to customize debug tasks
- How to connect to existing APIs
- How to add single sign on in Teams Toolkit for Visual Studio Code
- How to enable Single Sign-on in Teams Toolkit for Visual Studio
- How to configure Tab capability within your Teams app
- How to configure Bot capability within your Teams app
- How to configure an Outlook Add-in capability within your Teams app
- How to configure Message Extension capability within your Teams app
- How to automate ci/cd pipelines
- How to integrate Azure Functions with your Teams app
- How to integrate Azure API Management