{"id":11741,"date":"2022-10-12T07:52:40","date_gmt":"2022-10-12T14:52:40","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/?p=11741"},"modified":"2022-10-12T06:44:43","modified_gmt":"2022-10-12T13:44:43","slug":"boost-your-microsoft-teams-app-experience-with-new-link-unfurling-capabilities","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/boost-your-microsoft-teams-app-experience-with-new-link-unfurling-capabilities\/","title":{"rendered":"Boost your Microsoft Teams app experience with new link unfurling capabilities\u00a0\u00a0"},"content":{"rendered":"

Making your work easier, and more intuitive, is what we’re all about. Links are one of the most popular forms of content shared in Microsoft Teams today. At Microsoft, we are investing deeply in this space to enable rich discovery and content collaboration experiences, with <\/span>link unfurling<\/span><\/i> at the center of these workflows.<\/span>\u00a0<\/span><\/p>\n

\"Image<\/a><\/p>\n

 <\/p>\n

What is link unfurling?<\/h2>\n

Teams\u2019 users constantly share links in chats and meetings to exchange information about work, news, videos and more. This makes the user who receives the message click the link and switch to other platforms to consume the content. Wouldn’t it be helpful if users could see an overview of the link before clicking it? That way users can work more intuitively and efficiently without compromising context switching.<\/p>\n

With link unfurling, by simply copying and pasting a URL into a Teams chat, Teams users can get an adaptive card with a rich, interactive preview of the app content, presented in the same context of the chat or meeting where they work.<\/p>\n

To enable Link unfurling, your app can register to receive an invoke activity when URLs with a particular domain are pasted into the compose message area. The invoke contains the full URL that was pasted into the compose message area. You can respond with a card that the user can unfurl for additional information or actions. This works as a search command with the URL as the search term.<\/p>\n

Types of link unfurling<\/h2>\n

With link unfurling for Teams, flexibility is key. Whether your app requires authentication, installation or not, link unfurling allows you to provide a seamless experience for your app users.<\/p>\n

How do we do it? When a user shares a link in Teams, we first check to see if we can match it to a Teams app to generate a specified preview for it and handle the authentication flow as needed by your app. If the link doesn\u2019t map to a Teams app, then we create a preview of your web site through basic or rich actionable previews.<\/p>\n

This diagram shows you a quick view of the scenarios you can manage with link unfurling:<\/p>\n

\"This<\/a><\/p>\n

To learn more about how to implement link unfurling previews using your Teams app, learn more here<\/a>.<\/p>\n

To learn about building portable, live adaptive card-based loop components for your unfurled app links, see here<\/a>.<\/p>\n

Expand your app visibility, discoverability, and ultimately your app usage<\/h2>\n

What if you could leverage the benefits of link unfurling to provide a seamless experience to your users even when your app isn’t directly installed on Teams? App adoption can be hindered by the user having to find and install your app first, which can be time-consuming. Beyond the benefits link unfurling provides for end users, as a developer it also allows you to expand your app visibility, discoverability, and ultimately its usage by our mutual customers.<\/p>\n

Welcome zero-install link unfurling<\/em><\/h3>\n

With zero-install link unfurling, any time one of your links is shared in Teams, your app can unfurl it and showcase its value and skills right in the flow of conversation, regardless of if the user has discovered or installed your app before.<\/p>\n

The zero-install link unfurling experience is governed by all Teams admin security policies, which means that if an app is blocked at the tenant level, zero-install link unfurling won’t preview it.<\/p>\n

Get started with zero-install link unfurling<\/h3>\n

To get your app ready for zero-install link unfurling these are the 3 main steps:<\/p>\n

    \n
  1. Prepare your app, opt-in via manifest\n