Last year I blogged about how to make auto-contact URLs for Lync voice and IM.

A few days ago, a reader emailed me about going one step further – embedding an IM link in a SharePoint page.

“I am trying to add a Hyperlink to SharePoint to automatically start a Lync Chat with someone. I did try to use the example you gave IM:but SharePoint wants only certain formats, which IM: is not one of.”

“I tried with most of them adding your syntax with no luck. Would you have any suggestions here to get SharePoint to open a Instant Chat to users via a Hyperlink?”

Personally, I never tried to set up an IM link in SharePoint. The tel: link always suited me.

So I went in search of a solution.

Will an Instant Message Link Work in SharePoint? Depends on the Format.

You can’t just drop an IM:<> link onto a SharePoint page. You’ll see this error:

Accepted URL Formats in SharePoint 2010

Which is what stymied the reader.

Pretty soon I came across this forum thread: Tel Hyperlink in SharePoint – TechCenter

In it, Paul J Barton posted a clever workaround. It reads like this:

1. Open Notepad and create the tel link My Number, save as text file (in my case tel.txt).
2. Open SharePoint and navigate to a doc library, upload text file from step 1.
3. Open a page and get it in edit mode, drop in a content editor web part, edit webpart settings and you will get a input box to enter the path to content.
4. Enter /%doclibname%/tel.txt, change the chrome of the web part so you only see the link, not the webpart title etc.
5. Save the page and you now have your tel link without SharePoint messing with your markup.

Paul clearly wrote this for creating tel: links in SharePoint. But since Lync will auto-recognize IM links as well as phone numbers, it SHOULD work for those as well.

Let’s find out if it will!

The Process of Creating an IM Link SharePoint Would Allow

Following the workaround’s instructions, I created a text file with a valid IM address. The format must be:
<a href=”IM:<>”>IM Chris</a>

(Make sure you have this formatting exactly right. Including the brackets around the SIP address. I missed ONE bracket the first time and the link failed.)

After saving, I uploaded it to a document library. For purposes of this tutorial, I’ll say it was in /PM/Testing Library/. So its location URL becomes:
/PM/Testing Library/TestIM.txt
Remember that.

Next I went to an existing Site Page, and clicked “Edit Page”.
In Page Edit Mode, you should see page locations where you can click to “Add a Web Part”. I clicked one, and activated the Page Tools tab in the nav bar.

What we want is in the Media and Content menu – the “Content Editor” Web Part.

SharePoint 2010 Web Parts Menu

Click Add on the right to add it. You’ll see the new Web Part in the original page location, with “Click here to add new content” showing.

Ignore that. Instead click the arrow at top right of the field, opening its menu. Then click “Edit Web Part.” This will open up the full menu on the right.

Enter the location URL of your text file in the Content Link field.Content Editor Web Part Menu

You’ll see I’ve done this in the image on the right.

As Paul says in his workaround, click Appearance to change the chrome type.

In the “Chrome Type” drop-down menu, choose “Title and Border” or “Title Only”. This way the link will only show the link name you specified.

Click OK.

You should now see your IM link in the Web Part box. Click “Stop Editing” in the nav bar.

Once the page has refreshed, click your IM link to test it. If it’s formatted right, a new Lync IM window will pop up, ready to start a conversation!

It Works! Use to Generate Auto-Contact IM URLs in SharePoint

This is a workaround, albeit a clever one. I expect Lync Server 2013 will have something more elegant in its SharePoint integration.

In the meantime, many thanks to Paul for his input!

If you want more on creating HTML links for Lync services, head to this page at Lync 2010 HTML URL Protocols for HREF tags

How to Create Lync Auto-Contact IM Links in SharePoint 2010

5 thoughts on “How to Create Lync Auto-Contact IM Links in SharePoint 2010

  • November 10, 2014 at 11:59 am

    Is there anyway to keep Lync from registering IM: ? We have an application that also registers IM: on install but Lync stomps on it when it stars rendering our app useless.

    • November 10, 2014 at 2:32 pm


      Thanks for the comment. I’m not seeing a way to prevent Lync from registering IM on install; since it’s server-based and interconnected with Microsoft apps, it likely presumes you don’t have a default IM client already.

      However, it is possible to change the default IM provider on a system. Go into the Registry and locate this key:
      HKEY_CURRENT_USER\Software\IM Providers
      You can change the default value here, to your other application. Your sysadmin should be able to push an update out to everyone via Group Policy too.

      Hope that helps!

  • August 4, 2015 at 10:06 am

    Hi – I’m supporting a SP2013 Enterprise (on premise) environment. A couple months ago our IT dept upgraded Lync to Skype…and now the Site Users web part will not display user status, cannot IM or email or call people from the web part that way Lync allowed. I’m not having any luck in resolving this issue, and am wondering if you have any familiarity/ideas for this topic?
    Thanks so much.

    • August 19, 2015 at 7:40 am

      Hi Tracy,
      Thanks for the comment. I’m not a SharePoint guy myself, but it may be that the new Skype4B version is incompatible. I’m seeing a couple other instances of this happening on support forums.

      I’ll ask our SharePoint expert what he thinks & get back to you.


Leave a Reply

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