How can I create a weblink to open an App inside Teams in a specific screen?

Question

Hi All,

I am using this type of link to open a PowerApps app inside Teams and it is working.

https://teams.microsoft.com/l/app/c407d4b9-d16c-4771-98c8-8634bc48fdd9?tenantId=cb2e1a4c-fc99-4904-b813-3f23276c7000

How can add a parameter or something to open a specific screen of my app directly?

Thanks for any help.

Answer 1

To create a weblink that opens an app inside Teams and navigates to a specific screen, you can use deep links. Deep links allow you to navigate directly to specific content or actions within an app.

If you have a PowerApps app and you want to open a specific screen, you need to ensure that your app handles the context parameter to navigate to the specific screen.

https://teams.microsoft.com/l/entity/c407d4b9-xxxx-8634bc48fdd9/screen123?webUrl=https://apps.powerapps.com/play/<appId>?screen=ScreenName&label=Screen 123&context={"key":"value"}

Replace <appId> with your PowerApps app ID and ScreenName with the name of the screen you want to navigate to.

Notes:

• Ensure that your app is configured to handle deep links and can process the context parameter to navigate to the specific screen.
• The specific support for context parameters may vary based on the app and its configuration.

Ref: https://learn.microsoft.com/en-us/microsoftteams/platform/concepts/build-and-test/deep-link-application?tabs=format1%2Cteamsjs-v2%2Cformat2%2Cspecific%2Cformat3%2Cformat4%2Cformat5

Thanks, 

Prasad Das

************************************************************************* 

If the response is helpful, please click "Accept Answer" and upvote it. You can share your feedback via Microsoft Teams Developer Feedback link. Click here to escalate.

Answer 2

Hi Prasad,

Thanks for your help!

I am not sure if there is a difference between the link you provided or other (below) that I tested:

https://teams.microsoft.com/l/entity/c407d4b9-d16c-4xxxx-98c8-8634bc48fdd9/screen123?webUrl=https://apps.powerapps.com/play/c407d4b9-d16c-4xxxx-98c8-8634bc48fdd9?screen=ScreenName&label=Screen 123&context={"key":"value"}

On your link, I do not understand if I have to put the screen name in the URL and inside the app take the parameter on the context or not.

Now, I am using this url:

https://teams.microsoft.com/l/entity/c407d4b9-d16c-4xxxx-98c8-8634bc48fdd9/screen123?webUrl=https://apps.powerapps.com/play/c407d4b9-d16c-4xxxx-98c8-8634bc48fdd9?context={"subEntityId":"Approvals"}

And I have this in my app, and it returns empty:

Coalesce(Param("subEntityId"), "")

Thanks for any help!

Answer 3

This url works !!

https://teams.microsoft.com/l/entity/a6b63365-31a4-XXXX-92ec-710b71557af9/_djb2_msteams_prefix_1050222163?context=%7B%22channelId%22%3A%2219%3AmlRkIKz6e6UK-xqHJw40yYNjhvqphjHKJ52n3Ad-h941%40thread.tacv2%22%2C%22subEntityId%22%3A%22Approvals%22%7D&tenantId=cb2e1a4c-fc99-4914-b513-3f23276c7000

With the parameter SubEntityId = "Approvals"