Skip to content


Subversion checkout URL

You can clone with
Download ZIP
HipChat HTTP API Wrapper in Ruby with Capistrano hooks
branch: master

This branch is 243 commits behind hipchat:master

Merge pull request #23 from ismaelga/master

Just a little formatting fix on Readme file
latest commit 4456ac04e8
@cpjolicoeur cpjolicoeur authored
Failed to load latest commit information.
lib cancelled message color
.document Initial commit to hipchat.
.gitignore Initial commit to hipchat.
LICENSE Change copyright.
README.textile Little formatting fix in Readme
Rakefile Cleaning up ownership info for gemspec
VERSION Version bump to 0.4.1
hipchat.gemspec Regenerate gemspec for version 0.4.1


HipChat Wrapper

A very basic wrapper for the HipChat HTTP API.


client =
client['my room'].send('username', 'I talk')

# Send notifications to users (default false)
client['my room'].send('username', 'I quit!', :notify => true)

# Color it red. or "yellow", "green", "purple", "random" (default "yellow")
client['my room'].send('username', 'Build failed!', :color => 'red')


require 'hipchat/capistrano'

set :hipchat_token, "<your token>"
set :hipchat_room_name, "Your room"
set :hipchat_announce, false # notify users
set :hipchat_color, 'green' #finished deployment message color
set :hipchat_failed_color, 'red' #cancelled deployment message color

Who did it?

To determine the user that is currently running the deploy, the capistrano tasks will look for the following:

  1. The $HIPCHAT_USER environment variable
  2. The hipchat_human capistrano var.
  3. The git var.
  4. The $USER environment variable.

Rails 3 Rake Task

Send a message using a rake task:

rake hipchat:send["hello world"]

Options like the room, API token, user name and notification flag can be set in YAML.


token: "<your token>"
room: "Your room"
user: "Your name" # Default to `whoami`
notify: true # Defaults to false

Engine Yard

Use a deploy hook to send messages from Engine Yard’s Cloud platform.


on_app_master do
  message  = "Deploying revision #{revision[0...6]} to #{node[:environment][:name]}"
  message += " (with migrations)" if migrate?
  message += "."

  # Send a message via rake task assuming a hipchat.yml in your config like above
  run "cd #{release_path} && bundle exec rake hipchat:send MESSAGE='#{message}'"


Copyright © 2010 Mojo Tech. See LICENSE for details.

Something went wrong with that request. Please try again.