Blog | On the Web | About me
Daniele Vistalli @ BleedYellow


Getting social ?

Yes, it is possible.

In the last few weeks I've been working a lot with the connections & samtime web APIs (I'm beta-testing Connections 2.0) and I liked those a lot.

So, back from work I begun to think about a way to integrate the great BleedYellow infrastruacture that's made available by
the BleedYellow team.

I started to work with Sametime Links API (that a great API but I think it's under-exploited,
learn more here) to replace the Google Badges I was using on my blog.
I introduced a month ago the possibility for visitors of my blog to ping me and start a chat direclty from the context of my website.

Now I replaced it with my samtime links integration using the BleedYello IM infrastructure.

I asked Chris Whisonant about making this information public and he confirmed, go for it.

So here's how you can do the same and STLinks enable your site / blog.


In your page head you need to add this piece of code:

<!-- Sametime BY - integration -->

<link rel="stylesheet" href="" type="text/css" />

<script type="text/javascript" src=""></script>
<script type="text/javascript" >
setSTLinksURL('', 'en');
STHost = '';

<!-- Sametime BY - integration -->

line in red is related to stylesheets and is used to import the sametime links stylesheet you could even copy & cusomize styles into your site stylesheet but with this you have all you need.

green section is where sametime links starts up, first, I imported the mail STLinks javascript file, than I updated the resource base (I'm using remote resources so I need to tell stlinks where to load stuff from).
I also set the STHost variable to address a missing parameter in Bleedyellow's hostinfo.js file (a sametime file that publish information on sametime connectivity).

Finally i "writeSTLinksApplet", this creates in you page the applet that will handle communication to the sametime server and event handling inside the browser.

As you can see I pass "" as a parameter to writeSTLinkApplet, this means that any user clicking on links at your site will be identified as when they start a chat session with you. To better undestand the meaning of parameters please refer to the STLinks documention. (see Resources)

The setup is done.

Linking your name

Now that your page has begun to talk to the server it's time to lie down you "active links".

To do this you use the
writeSametimeLink api to complete the work:

<script type="text/javascript">
writeSametimeLink('CN=Daniele Vistalli,O=BleedYellow', 'Daniele Vistalli', false, 'icon:yes;');

The writeSametimeLink call has two parameters.

The first has to be your "resolved" fullname in the BleedYellow address book. As you can imagin the pattern is CN=FirstName LastName,O=BleedYellow.

The second is you "abbreviate" name but it doesn't matter since with the third parameter we're telling sametime not to reslove the username. (This is needed since the Bleedyellow server is not allowing name resolution when the requesting partner is a guest).

The last parameter allow customization of the appearance, in this case I decided to show a small icon near the user name.

What could be done

This is pretty basic and Sametime allows for a number of things to be done. For instance we could wrap the STLinks api and the new Sametime Connect WebAPI together and use the "best available" option.

Then we could build a dynamic menu around the user link or anything else.

The thing I wanted to point out is how easy is to integrate awareness using IBM Sametime Links toolkit, one of the best and less used feature of the sametime platform.

What's next

In the next post I'll show some of the magic that the SemanticTagService is bringing to IBM products. It's used in connections and it's going to be available in new products too (like Websphere Portal 6.1). I hope to see the SemanticTagService come to Domino 8.5 too. It's a powerful new way to make your pages live.

More on this very soon.


Comments (0)
Daniele Vistalli May 13th, 2008 20:10:38

1) Thanks
Dave Hay 09/23/2009 21:08:48

Hi Daniele

Again, thanks for your excellent help here - your post saved us a lot of time this afternoon, and I've blogged my own findings here: -

{ Link }

2) never mind, got it to work, but
Daniele Vistalli 08/04/2009 21:11:09

To see the correct placement of the code just open up the source code page for my blog homepage. I currently commented the instant messaging code but you can easily spot it to update your templates.

It's an integration of the sametime links feature. This means that you can start a web chat clicking on the status icon.

Let me know how it works for you.

3) never mind, got it to work, but
Keith Brooks 08/04/2009 21:01:12

this is only for awareness, can you make it a web based chat as well?

4) where doeas it go in the domino blog template?
Keith Brooks 08/04/2009 20:50:35

if you know where to put this code int he domino blog template, please email me and let me know.

5) Thank you
Ulrich Krause 05/14/2008 7:32:50

I've updated my blog design and enabled IM chat on my blog.

Works great!

6) Some other articles
Carl t 05/14/2008 2:34:14

 Add a Comment
Web Site:
Comment:  (No HTML - Links will be converted if prefixed http://)
Remember Me?