Edit

Share via


Deep linking into Viva Engage

Often, you'll want to create a deep link to the Viva Engage app in Microsoft Teams or an entity within Viva Engage, such as a community. For example, you want to include a link to a conversation that a leader shared, a community that you're launching, or a campaign you're emailing about.

This article discusses how to manually construct different deep links into the Viva Engage app.

Tip

While the https://aka.ms/... link is shorter, we recommend the longer https://teams.microsoft.com... link if you're sharing the deep link in Teams. This way, you link directly to the Viva Engage tab without opening a new browser window.

Deep link to the Viva Engage store entry

The following links open the Viva Engage store page in Microsoft Teams:

The following links open Viva Engage in a browser and engage.cloud.microsoft, respectively. If the user has the Viva Engage mobile app installed, the links open the Viva Engage app.

The following links directly open Viva Engage in Microsoft Teams. If the app isn't installed, the user will be prompted to do so.

The following link directly opens Viva Engage in Outlook, if available:

To directly open Viva Engage in Teams to the Answers in Viva page, use one of the following links:

In the browser (engage.cloud.microsoft) or the mobile app:

In Teams:

Links in these formats open the entity in Viva Engage in Teams.

  • https://aka.ms/VivaEngage/Launch?context=%7B%22subEntityId%22:%22type=custom,data=<EntityType>:<EntityId>%22%7D
  • https://teams.microsoft.com/l/entity/db5e5970-212f-477f-a3fc-2227dc7782bf/vivaengage?context=%7B%22subEntityId%22:%22type=custom,data=<EntityType>:<EntityId>%22%7D

However, you also need to:

  1. Replace <EntityType> with one of the following values:

    Type Replace <EntityType> with...
    Post thread
    Community group
    Storyline user
    Campaign campaign
  2. Fill in the <EntityId>. The easiest way is to go to the corresponding page on engage.cloud.microsoft and paste the last part of the URL.

For example, for the storyline of https://engage.cloud.microsoft/main/users/eyJfdHlwZSI6IlVzZXIiLCJpZCI6IjUwMzIxMDg3kyOCJ9, replace <EntityId> with eyJfdHlwZSI6IlVzZXIiLCJpZCI6IjUwMzIxMDg3kyOCJ9.

Important

Don't omit the %22%7D at the end of the URLs.