August 29th, 2023

Adaptive Card-based Loop components are now in preview

Adaptive Card-based Loop components are live and actionable units of productivity that stay in sync and can move freely across Microsoft 365 apps, starting with Microsoft Teams and Outlook. At Build ‘22, we announced a private preview for developers to create Adaptive Card-based Loop components, and since then we have partnered with organizations such as SAP, Zoho and Priority Matrix to build experiences that will allow their users to bring live business data into chats and emails. Previously, we shared with you the variety of scenarios that our partners have been working on.

We’re excited to announce that Adaptive Card-based Loop components are now available in public preview! In this article, we want to give you a sneak peek into how you can build your own first set of live, actionable, portable Adaptive Card-based Loop components to bring your business content directly into Teams, Outlook, and other Microsoft 365 apps.

Fig. Adaptive Card-based Loop components let you build experiences which will allow your users to share and act upon business content across Teams and Outlook.

Fig. Adaptive Card-based Loop components let you build experiences which will allow your users to share and act upon business content across Teams and Outlook.

How partners can develop Adaptive Cards as Loop Components

There are three distinct stages in your journey to building Adaptive Card-based Loop components:

  1. The pre-requisites
  2. The magic ingredient
  3. The experience

Stage 1: The pre-requisites

Overall, if you already have a message extension app, then enabling Adaptive Card-based Loop component is a very quick process.

ServiceDesk Plus – an IT Service Management solution by the Zoho Corp., is leveraging the power of Adaptive Card-based Loop components to optimize its incident and ticket management use cases. In the words of Jagadeesh Goddumuri, a Product Manager driving M365 integrations at Zoho., “Through adopting Adaptive Card-based Loop components we expect to reduce context switching for our users across multiple applications, hence improving the incident response time and in turn making our customers’ businesses more efficient. For the developers this implies a huge ROI with minimal effort, along with a significant improvement in CSAT. Finally, we are a step closer in seamlessly connecting and tightly integrating our product with Microsoft platforms, enhancing the user experience, and maximizing the potential of our solution”.

Stage 2: The special ingredient

Once you have taken care of the pre-requisites, the next step is to add the special ingredient which makes Adaptive Card-based Loop components live and portable. You need to include the URL that uniquely identifies the unfurled content, which usually is the link that’s pasted, in the metadata.webUrl property of your Adaptive Card payload.

Fig. Add metadata.weburl property to turn your existing Adaptive Card experiences to Loop component

Fig. Add metadata.weburl property to turn your existing Adaptive Card experiences to Loop component

Stage 3: The experience

In this stage, you are expected to follow the best practices to ensure your end users get the best experience possible through your Loop component keeping up with the live, actionable, and portable promises. In the words of Pablo Diaz-Gutierrez, CTO Priority Matrix, “Our goal is to help our users focus on high-impact tasks. It’s hard to focus on anything if you’re constantly taken in and out of context, and every time a user must switch apps, there’s a cognitive price to pay for the switch. Adaptive Card-based Loop components are an excellent example of how we meet our users where they already are, helping them reduce context switching.

Priority Matrix – a comprehensive task and priority management solution, has empowered its users to collaborate upon tasks more effectively in M365. Priority Matrix tasks exhibit the following properties when rendered as Loop components:

  • Live: When a Loop component loads, it shows fresh, up to date information about a task.
  • Embeddable: Content is shown in different contexts with equivalent functionality but native feel.
  • Actionable: Users can not only view information, but also interact with tasks without leaving the current app. Moreover, users can launch the Priority Matrix web experience natively using the Stage View functionality in Teams and Outlook.
  • Portable: Users can copy and paste content across supported apps and all instances stay in sync.

Overall, we advise developers to start with a Loop component with basic functionality, and then iterate as needed based on user feedback. A simple card experience is easier for your users to understand, and easier for our app reviewers to validate. And on a final note, listen to the feedback received during the app submission process and incorporate the reviewers’ recommendations, as they want to help you meet the guidelines and deliver a great experience for your customers.

AC-based Loop components empower users and are easy to build

Working with your team can be hard when you have different goals and schedules and the team is distributed across different locations. Loop components make it easy to share and edit content from different apps and sources in Teams chat and Outlook messages. No more switching between apps to find what you need. Just look at the Loop component and reply right away. It’s fast and simple!

If you are interested in building Loop components for your application, follow these steps:

  1. Create a Microsoft 365 developer tenant or sign in with your test tenant credentials.
  2. Enable Targeted Release for everyone.
  3. Send an email from the tenant admin account to AC loops Dev Preview Help. Microsoft will verify the admin user and enable support for Loop components for this tenant.

For more details you can refer our technical and design guidelines.

Happy building!

Follow us on Microsoft 365 Developer (@Microsoft365Dev) / Twitter for the latest updates and announcements.

2 comments

Discussion is closed. Login to edit/delete existing comments.

  • endra hidayah

    this is cool, very useful for me. thanks men

  • Chris Smith

    This is very exciting. The first experiment I tried with Adaptive Cards proved futile, as I wanted to send a card to multiple recipients, but have the data contents stay in sync. Does this mean this will be possible, and just keep the data in sync using Loops components essentially as the data store? Could we do this with Lists as a potential datasource, where those updated values would be reflected on the Loop/Adaptive Card...

    Read more