Microsoft Teams deep links in email signatures

Microsoft Teams deep links in email signatures

[Update]: This blog post was updated on June 28, 2021.

Are you using Microsoft Teams? Advertised as “the hub for teamwork in Office 365”, in most cases it allows employees to communicate and collaborate with high efficiency. If you are using it as a primary means of communication, it is vital to direct your co-workers to this channel. So, is there an easy and efficient method to link to Teams? There is! The secret is to use the so-called deep links.

Microsoft Teams deep links in email signatures

Teams deep links can make both your email signatures and Teams even more useful. You don’t know what deep links are? I’ll be happy to explain.

Deep links are most commonly used by developers who want to integrate Teams with other applications. It does not mean, however, that it takes a power user to use deep links in practice. In this article, I will show how to use deep links in email signatures to:

Finally, as an extra treat, I will present how to distribute those features to all employees without them lifting a finger.

Who does not love emails? In the business world, it is the bread and butter of communication. However, in some cases, it is more efficient to discuss some matters in a group chat. Microsoft Teams allows creating such chats and deep linking makes it possible to do this directly from an email. First, let’s look at the deep link’s format:<mailbox 1>,<mailbox 2>&message=<message content>

Such a link, when clicked or pasted into a browser, will open a Teams chat window with the comma-separated users, identified by their UPNs. Additionally, the <message content> will appear in the chatting window, ready to be sent.

As you may know, URLs are not happy with all characters. While it is perfectly fine to type in a message with spaces (they will be converted to their URL value %20), question marks and all other punctuation marks need to be inserted manually by using their codes. W3schools offers a good reference point for that.

So, for example, the following link will open a chat window with T. Edison and F. Sinatra, with the message “Hi guys! How are the preparations for the event going?”, guys%21How are the preparations for the event going%3F

Another kind of Teams’ deep link that might come in handy in email signatures is a scheduling link. Clicking such a link will bring up a scheduling dialog with the person who clicks as the organizer and the attendees specified in the link. The format is as follows:<subject>&startTime=<date>&endTime=<date>&content=<content>&attendees=<list of comma-separated user UPNs>

I would not recommend using the time-related attributes in email signatures. I explain why in the Limitations section of the article.

A sample link below will open a scheduling dialog with the meeting subject “afternoon tea” and “Created from an email signature” as the content. John D. and Brian S. are selected as the attendants of the meeting. The Scheduling assistant lets you choose a good time for the meeting. tea&content=Created from an email signature&,
Schedule a meeting in teams using deep links


The sad part is that the links will work only for those who have the Teams client installed (the browser version does not seem to work as well) and who are part of your organization. To be more specific, the link will be clickable in both cases and will prompt to run Teams but all the carefully prepared attributes (such as attendants, title, details) will be lost.

When it comes to the scheduling dialog, the startTime and endTime attributes look like they might come in handy, but rather not for static links in email signatures. Here is why:

First, according to a Microsoft article on deep links, you need to enter the date in the “long ISO 8601 format”. Add to it that URLs do not support all special signs, and the right formatting becomes a very troublesome task.

Secondly, think about using a specific date and time in such a link. In most cases, you would need to update the link on a regular basis. And what if the time you specify is already taken? It is much more reasonable not to use those optional attributes and let your co-workers use the Scheduling assistant to pick the right time.

Still, despite those problems, deep links in email signatures might come in handy. Fortunately, there is a way to make them appear in email signatures automatically, without any action on the user’s end.

Add personalized links to everyone’s signatures

Now, if you wanted every user in your organization to use those links, you will encounter some obstacles:

  • Creating deep links with the right attributes for each user.
  • Distributing those links to Outlook, OWA, and whatever other email client your users might be having, or guiding users to do so.
  • Making sure those links will be sent only inside the organization, since they do not work for external recipients.

Bring all those things together and it turns out that adding those links into users’ signatures is an extremely time-consuming or even nearly impossible task. Fortunately, you can avoid all these hurdles by using CodeTwo Email Signatures 365.

CodeTwo Email Signatures 365 is an email signature management tool which ensures all your email communication is signed with professional email signatures. Here is how to use it to automatically deploy email signatures with personalized deep links:

  1. Create a new email signature rule, only for internal emails.
  2. Pick one of the designs from the signature template library. Since it is an internal email signature, it is a good idea to create a short and simple template.
  3. Now, in the email signature editor, place the cursor where you would like your deep link to be and click the Meeting link button on the ribbon.
    ESIG insert Teams deep link
  4. In the Insert meeting link window, choose Custom link as the link type (1). Using the Label and Picture fields (2), you can decide which element will be clickable – it can be either a text, picture or both. Next, click the button (3) next to the URL field to specify your link.
    ESIG insert meeting link options
  5. In the window that opens, paste the deep link in its general form and substitute <mailbox> with the {E-mail} placeholder and specify the <message content> You can personalize the message content with standard user placeholders, like the {First name}, or personalize the whole message using custom attributes (learn more about using custom attributes in email signatures). You can also apply those changes to other links (for example, a scheduling link) as well. When you are done, click OK in both windows and apply the changes made to your signature template.
    Meeting link URL - Teams deep link

When you save the rule, every employee associated with this rule will have a deep link (that starts a chat or schedules a meeting with this person) in their email signature.

It took me 5 minutes to add this rule. 5 minutes and all employees have unified email signatures with their contact details, photos and personalized deep links to a Teams chat and a meeting dialog:

Sample email signature with Teams deep links

That is only a slight fraction of what the software can do. Learn more about its features

Useful links:

Leave a Reply

Your email address will not be published. Required fields are marked *