How teams create deep links to apps

Question

As shown in the title, how does teams create deep links to applications? I want to quickly access the apps that our organization frequently uses in teams by creating shortcuts on the desktop. Any guidance is greatly appreciated.

Answer 1

Hi @Will Altria

Deep links allow app users to open an app install dialog to know any information about the app or install it in different contexts. You can create a deep link to an app in the following ways:

• Configure deep link manually using the app ID
• Configure deep link using TeamsJS

Configure deep link manually using the app ID

With deep link, you can open an app installation dialog directly from your Teams client using the app ID. https://teams.microsoft.com/l/app/<your-app-id>?tenantId=<tenantId>

<your-app-id> is your application ID (fxxxxxxx-0xxx-4xxx-8xxx-cxxxxxxxxxxx).

Configure deep link using TeamsJS

Apps can use the Microsoft Teams JavaScript client library (TeamsJS) to initiate the app install dialog, eliminating the need for manual deep link generation. Here's an example of how to trigger the app install dialog using TeamsJS within your app:

// Open an app install dialog from your tab
if(appInstallDialog.isSupported()) {
    const dialogPromise = appInstallDialog.openAppInstallDialog({ appId: "<appId>" });
    dialogPromise.
      then((result) => {/*Successful operation*/}).
      catch((error) => {/*Unsuccessful operation*/});
}
else { /* handle case where capability isn't supported */ }

---

If the answer is helpful, please click "Accept Answer" and kindly upvote it. If you have extra questions about this answer, please click "Comment". Note: Please follow the steps in our documentation to enable e-mail notifications if you want to receive the related email notification for this thread.

---