LWRP for sending messages to Atlassian's HipChat
Pull request Compare This branch is 44 commits behind cwjohnston:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



This cookbook provides a hipchat_msg resource, making it easier for chef recipies to send messages to a chat room on Atlassian's HipChat service.


Should work on any platform where Chef runs. Tested on Ubuntu.


  • Authentication token for an existing HipChat account.
  • 'hipchat' gem (automatically installed by this cookbook's default recipe).


  • speak - do it (the default)
  • nothing - don't do it


  • room - the name of the room you would like to speak into (requied).
  • token - authentication token for your HipChat account (required).
  • nickname - the nickname to be used when speaking the message (required).
  • message - the message to speak. If a message is not specified, the name of the hipchat_msg resource is used.
  • notify - toggles whether or not users in the room should be notified by this message (defaults to true).
  • color - sets the color of the message in HipChat. Supported colors include: yellow, red, green, purple, or random (defaults to yellow).
  • failure_ok - toggles whether or not to catch the exception if an error is encountered connecting to HipChat (defaults to true).

Usage examples

    include_recipe 'hipchat'

    hipchat_msg 'bad news' do
      room 'The Pod Bay'
      token '0xdedbeef0xdedbeef0xdedbeef'
      nickname 'HAL9000'
      message "Sorry Dave, I'm afraid I can't do that: #{some_error}"
      color 'red'

Change log

  • 0.0.4 - A git mishap necessitated the release of this version. No changes to code.
  • 0.0.3 - notify now defaults to true, fixed using resource name as message body when no message is specified
  • 0.0.2 - Adding support for specifying message color
  • 0.0.1 - First public release


Consider using HTMLEntities or similar to encode messages before sending them.

License and Author

Author:: Cameron Johnston cameron@rootdown.net

Copyright:: 2012, Cameron Johnston

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at


Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.