Simple BBM Integration in WebWorks Featured

Jeremy wrote up a great article about integrating BBM into Cascades, and a few people mentioned they wanted to see an article about getting BBM integrated with WebWorks. I've been kind of off the radar lately, but figured this was a good topic for me to do a quick writeup on.

Now, to contnue with some friendly teasing I directed at Jeremy eariler: integrating BBM into Cascades may be easy, but integrating it into WebWorks makes integrating it into Cascades look like rocket science. Yes, it really is that easy.

If you want to follow along, about 8 months ago I wrote up a BBM Integration Sample that I'll be using in this article. You can find it at

1First, make sure you get your config set up right. For BBM integration, you need two additions:

<feature id="blackberry.bbm.platform" />

2Now that your config.xml is set up, you need to add some JavaScript to register your app with the BBM Server. To do that, you use the following function:

document.addEventListener('DOMContentLoaded', function() {
	blackberry.event.addEventListener('onaccesschanged', function (accessible, status) {
		if (status === 'unregistered') {
				uuid: '33490f91-ad95-4ba9-82c4-33f6ad69fbbc'
		} else if (status === 'allowed') {
			bbm.registered = accessible;
	}, false)

I personally use to get a UUID, but you can get one wherever you want. MAKE SURE YOU ALWAYS GET A NEW UUID! Do not use the one used in this function.

Just put that code in any JavaScript document that's loaded in your app, and your users will be connected!

3Now that you're registered, add whatever BBM Integrated function you want to an event, such as a button click. Some examples:
Allow users to update their BBM Status:

blackberry.bbm.platform.self.setPersonalMessage('I love OSBB!')

Allow people to change Availability Status:

blackberry.bbm.platform.self.setStatus('available', 'I\'m available!')

To invite other people to download your app:


It really is that simple. So get out there, and integrate your apps with BBM!


Shane Cridlebaugh

Co-founder and legal nay-sayer of OSBB. Owner of SCrApps Application Development, WebWorks aficionado, Open Source contributor. SCrid2000 on most blogs. I build awesome BlackBerry apps when I'm not doing legal work or spending time with my wife and two boys.

Follow me on Twitter - @GShaneC

Check out my apps in BlackBerry World

More in this category: « The Power of Ant Build

Leave your comments

Post comment as a guest


People in this conversation

  • Guest (jhonny)

    Great article about BBM integrated with WebWorks. You have picked up a great topic. I have learned a lot from your article which will help me in learning it better.
    Get painting and decorating services here

    Like 0 Short URL:
  • Guest (sheral)

    I always research for articles that can help me. There is obviously a lot to know about this. I think you will make some good points in Features .Keep working, great job! sticker design and printing

    Like 0 Short URL:
  • Guest (jessica alex)

    wonderful article about Simple BBM Integration in WebWorks, you have made a great effort in making this post which i appreciate it a lot. I must say you have assignment help uk for these articles after lot of research.

    Like 0 Short URL:
Subscribe to the official OSBB BBM Channel!



Back to top