Deep links into Teams tab app prompting user to install the Teams app (while in the Teams app)

[adamreisnz]

We are running into a weird issue, which doesn't happen every time, but often when a user clicks a deep link to a tab in our Teams app.

The deep link is constructed like so:

https://teams.microsoft.com/l/entity/%{teams_app_id}/%{tab_name}?context={\"subEntityId\":\"%{tab_context}\"}"

The link is sent via a card to the Teams bot, as part of a response to a HELP command.
In general this works fine, and it takes the user to the correct page when they first click on the link.

However, when they click it a second time, they are asked to "stay better connected with the Teams desktop app")

See video for an example of this behaviour:

2025-07-20_14-00-31.mp4

Ironically, this only happens when the user is already in the Teams app. It doesn't happen when they click on the link in the web version of Teams.

[microsoft-github-policy-service]

Hi @adamreisnz! Thank you for bringing this issue to our attention. We will investigate and if we require further information we will reach out in one business day. Please use this link to escalate if you don't get replies.

Best regards, Teams Platform

[Prasad-MSFT]

Hi @adamreisnz, thanks for raising your issue. This is a Teams client behavior and not something you can fully control from your app or bot. There is no programmatic fix for the "stay better connected" prompt at this time.