First thing you will need to do, is to create an instance of a
notification manager and adding the handler to it, with
an HipChat client and the API token you can generate from the HipChat
admin interface:

Then you only need to define a notification with a few, HipChat-specific,
properties and trigger it:

1234567891011121314

<?php$notification=newHipChatNotification('YOLO!',// message'Alex',// sender'room1',// name of the room you want this message to appeararray('hipchat_notify'=>true,// optional: should send notifications to everyone?'hipchat_color'=>HipChat::COLOR_GREEN,// optional: background color of the notification'hipchat_message_format'=>HipChat::FORMAT_TEXT,// optional: text or html));$manager->trigger($notification);

The greatness of Notificator are its handlers, so if you feel
we should add another, useful handler, just shout out!
Even better, you can contribute to the project by sending
a pull request
like Alessandro,
Pascal and
Luis already did!

Notes

The sad truth is that capistrano has an hipchat gem/extension, but you cant really plug it the way you want (at least this happens to non-rubiers) ↩