What is the URI scheme in order to open MS Teams from another APP (deep link) ?

[sujeban]

Is MS Team currently supporting deep link to just open the app if so what is the URI scheme ?

[#2]

Which app? The desktop client can be invoked by using msteams://aaaaaaaaaaaaanything if that's what you mean.

[#3]

@VasilMichev is there a way to use the same structure to link directly into a document or a chat or a channel or such, from an email or a chat or anywhere else? Tired of having people go through the web link opening just to confirm that they wanted a document in the desktop app they already have open...

Something like msteams://{organization}/{teamName} or similar?

[#4 · Accepted solution]

You might find this helpful, if you haven't already found it: https://docs.microsoft.com/en-us/microsoftteams/platform/concepts/build-and-test/deep-links

[#5]

@VasilMichevVery Helpful comment. Thanks!!!

This worked for me.

[#6]

Excellent. Many thanks!

[#7]

@Chrispytwist i love this but i want it to immediately open in teams instead of a browser. I was hoping i could use ms-team:upn@domain.com and have it launch a chat with that user UPN in the Teams app

[#8]

@Shawn Keenehave you figured out how to accomplish this yet?

[#9]

@DRG-TFisicaro I'm afraid not.  Something like below works, but since it's HTTPS it will launch the browser first.

Although since the web server just immediately launches the real app, I think it's possible if I could just sniff out what the server response is from this. I'll try harder 😉

https://teams.microsoft.com/l/chat/0/0?users=Email address removed&topicName=ChatFromWeb&message=Hi Shawn

[#10]

Well that was easier than I expected. When you navigate to that HTTPS URL above, it bounces you to this below. And this is what you can put in your Run box (or whatever) to skip the browser step.

msteams:/l/chat/0/0?users=Email address removed&topicName=ChatFromWeb&message=Hi Shawn&deeplinkId=f5c3e062-2b02-4a6a-b10b-afe6d1a27858&launchAgent=join_launcher&type=chat&directDl=true&msLaunch=true&enableMobilePage=true&fqdn=teams.microsoft.com

[#11]

You can also link to a Call.
https://teams.microsoft.com/l/call/0/0?users=email address removed for privacy reasons

Dear Teams Devs. May we also have a deep link for a user's organisation tab, please?
(The tab that shows organisation structure)

[#12]

@LeiChat @Shawn Keene Did either of you also find a way to link to a channel of a specific team using the msteams: schema?

I played around with /channel/ and /conversations/, but got neither to work (besides bringing the Teams app into focus).

[#13]

@JS_NKD 

To link to the chat of a channel you can right click your channel in teams and select get link to channel. Then replace https with msteams. You'll get something like this

msteams://teams.microsoft.com/l/channel/<channelid>/<channelName>?groupId=<groupid>&tenantId=<tenantid>

[#14]

@nicoleahmed Thanks, but I failed to mention that I want to link to a private channel, for which there is no function to get the link.

[#15]

Well never mind, copying the link from MS Teams web page and replacing the https with msteams there DOES work for private channels as well! 🙂
i.e. https://teams.microsoft.com/_#/conversations/<CHANNELNAME>?threadId=<SOMEID>@thread.tacv2&ctx=channel
to msteams://teams.microsoft.com/_#/conversations/<CHANNELNAME>?threadId=<SOMEID>@thread.tacv2&ctx=channel

Thank you!

[#16]

you're welcome - glad it worked