Steven Merrill

Using HipChat through an IRC client with BitlBee

This post was originally posted on the Phase2 Blog.

Here at Treehouse Agency, we love IRC, as does the rest of the Drupal community. Still, IRC ports are often blocked, and not everyone is comfortable using IRC. We've recently been using HipChat to set up chat rooms for certain new clients.

I already route most of my AIM and GTalk interaction through an IRC gateway using BitlBee, and I wanted to hook HipChat up to an IRC client as well. Here's a guide on how to do this.

(Note that I was having trouble joining channels in my LimeChat last night as I was writing this up, but I might just be missing something. Try it out!)

All the uppercase items come from the XMPP Account Settings page in your HipChat account.

  1. Add the account in Bitlbee.
  1. Before you connect, set it up so that folks' chat names will display properly.
  1. To prevent being spammed with room history every time you join or change status, set your resource to 'bot'.
  1. Connect to the account.
  1. At this point, you can join the &hipchat channel to see all your contacts and use /msg to start talking w/ one of them privately.
  1. Now, add a chat. Note that the information on the XMPP settings pages doesn't give you @chat.hipchat.com. You can set whatever channel name you want.
  1. Before you can join, you must set your nick to match the Room nickname setting in your XMPP settings. You must do this for every room. Use the channel name you decided on earlier for easier access.
  1. Now, join the channel.
  1. Start chatting!
  1. When you're ready to sign out of HipChat, use account off.