Creating Microsoft Teams PSTN Calling Deep Links

Creating links for phone numbers on a desktop operating system is easy. Just like mailto: links, Windows PCs have link handlers for callto: or tel: URLs. These kinds of links are often found on websites or google search results and provide great convenience because a user just has to click a link to start dialing.

Even though there are many different protocols, the most popular ones are:

If you haven’t already configured a default App for calling on Windows, you’ll be prompted to choose an app for calling links.

And that’s it. Next time you click on a phone number link, your PC will automatically use Teams to make the call.

Mobile operating systems are a different story. Because they are very restricted in terms of customization, clicking on a callto: or tel: link will most likely start a call using your mobile number/network — which makes total sense.

But what if you have a business application or an internal website and would like your users to initiate calls using their business number configured in Microsoft Teams instead of their mobile number?

It’s definitely possible but it requires a bit of work. To be specific, to achieve this, we need a specific deep link. But what are deep links?

Basically, they are just links followed by some application specific stuff which will not only open the App but also start an action inside said App. For example, we can use a deep link to open a specific channel or even a tab inside a channel in Teams.

If you want a link which will launch Teams and start a PSTN call, you need to create the link like this. The most important part is the “4;” placed just before the phone number. This will tell Teams to call a PSTN participant.

The <user> part of the URL is actually optional. So a real world example would look something like this.

Since this is a simple URL, we can also prettify the link by giving it a title.

To finish off, here are some Gifs of how it looks on an iPhone and an Android device.

Clicking a Teams calling deep link from within the app on Android.

Clicking a Teams calling deep link from within the app on iOS.

Clicking a Teams calling deep link from another App/Website on Android (works on iOS too.)

When launching a deep link starting with https:// as demonstrated above, it will always open your default browser, before the Teams App is launched. Unless, you’re clicking the deep link from within Teams as shown in the first two Gifs.

Thanks again for the tip!

Related posts:

Dimensions Network. “How to Add StrikeCoin to MyEtherWallet” is published by Stephen Mullens.

Algorithmocene noun /ˈalɡərɪð mə si:n/ — presumably the next geological epoch following our short-lived Anthropocene For the record, our species isn’t the first to single handedly remake the planet…

What I am observing a lot in youngsters and people of my age is that they are tired all the time. Always in half sleep or yawning. I was myself the same kind of person till sometime back. But I…