hubot-hipchat
Getting Started
The HipChat adapter requires node-stringprep
which in turn, requires
icu-config
to be available in the path. If you're trying to play locally,
then you need to install icu4c
, which, conveniently, homebrew can take care
of for you
% brew install icu4c
But brew
will not link any of the utilities, you'll have to do that by hand
(in particular icu-config
which is needed for node-stringprep
to build
correctly (it'll just appear like a broken package otherwise which will be
really disturbing)). You can link it with brew using brew link icu4c
.
You will also need to edit the package.json
for your hubot and add the
hubot-hipchat
adapter dependency.
"dependencies": {
"hubot-hipchat": ">= 0.0.1",
"hubot": ">= 2.0.0",
...
}
Then save the file, and commit the changes to your hubot's git repository.
If deploying to Heroku you will need to edit the Procfile
and change the
-a campfire
option to -a hipchat
. Or if you're deploying locally
you will need to use -a hipchat
when running your hubot.
Configuring the Adapter
The HipChat adapter requires the following environment variables.
HUBOT_HIPCHAT_JID
HUBOT_HIPCHAT_NAME
HUBOT_HIPCHAT_PASSWORD
HUBOT_HIPCHAT_ROOMS
HipChat JID
This is your hubot's Jabber ID, it can be found in your XMPP/Jabber account settings and will look something like [email protected]
.
HipChat Name
This is the full name exactly as you see it on the HipChat account for your hubot. For example "Gnomotron Bot".
HipChat Password
This is the password for your hubot's HipChat account.
HipChat Rooms
This is a comma separated list of JID/conference rooms that you want your hubot to join. You can leave this blank to have your hubot join every room.
Configuring the variables on Heroku
% heroku config:add HUBOT_HIPCHAT_JID="..."
% heroku config:add HUBOT_HIPCHAT_NAME="..."
% heroku config:add HUBOT_HIPCHAT_PASSWORD="..."
% heroku config:add HUBOT_HIPCHAT_ROOMS="...,..."
Configuring the variables on UNIX
% export HUBOT_HIPCHAT_JID="..."
% export HUBOT_HIPCHAT_NAME="..."
% export HUBOT_HIPCHAT_PASSWORD="..."
% export HUBOT_HIPCHAT_ROOMS="...,..."
Configuring the variables on Windows
Coming soon!