Description
Currently, when opening a Teams app via app.openLink, the install dialog is shown, but there is no way to guide users to a specific section within that dialog (e.g. the Reviews tab).
Example of current behavior:
const app_url = "https://teams.microsoft.com/l/entity/<GUID>";
app.openLink(app_url);
This opens the app install dialog, but users must manually navigate to the Reviews section.
Problem
Many users are not aware of the Reviews section or fail to find it easily within the dialog. As a result:
- Users often dismiss the dialog without leaving feedback
- App developers lose valuable user insights
- The UX creates unnecessary friction for collecting reviews
Proposed Solution
Allow deep-linking to specific sections within the install dialog via URL fragments or query parameters.
For example:
const app_url = "https://teams.microsoft.com/l/entity/<GUID>#reviews";
app.openLink(app_url);
This would directly open the Reviews section when the dialog appears.
Alternative approaches
- Support query parameters instead of fragments, e.g.
?section=reviews
- Expose this capability via the Teams JS SDK (e.g. an optional parameter in
app.openLink)
Benefits
- Improves discoverability of the Reviews section
- Increases likelihood of user feedback
- Reduces friction in the user journey
- Enables developers to guide users more effectively
Additional Context
This would be especially useful in scenarios where users are explicitly prompted to leave feedback after completing an action or workflow within an app.
Happy to provide more context or test potential implementations if needed.
Description
Currently, when opening a Teams app via
app.openLink, the install dialog is shown, but there is no way to guide users to a specific section within that dialog (e.g. the Reviews tab).Example of current behavior:
This opens the app install dialog, but users must manually navigate to the Reviews section.
Problem
Many users are not aware of the Reviews section or fail to find it easily within the dialog. As a result:
Proposed Solution
Allow deep-linking to specific sections within the install dialog via URL fragments or query parameters.
For example:
This would directly open the Reviews section when the dialog appears.
Alternative approaches
?section=reviewsapp.openLink)Benefits
Additional Context
This would be especially useful in scenarios where users are explicitly prompted to leave feedback after completing an action or workflow within an app.
Happy to provide more context or test potential implementations if needed.