Deep linking into Viva Engage

You can create a deep link to the Viva Engage app in Microsoft Teams or to any entity within Viva Engage, such as a community or a campaign. For example, create and forward 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 link action prompts the user 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

To complete the deep link, define the following values:

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

    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.