Hipchat Webhook

This module integrates with Hipchat to allow Hipchat to send messages to Drupal. Possible uses include:

• A keyword response system (similar to Slack's custom responses) that responds with a message to keywords
• A swear word detector
• Any slash command implementation - for example have Drupal get current weather and display it in a message when someone types /weather in Hipchat

Use this compared to the Hipchat module if you want Hipchat to send webhooks to Drupal on events in Hipchat.
Use the Hipchat module if you want Drupal to send notifications to Hipchat on events in Drupal.

Contains

• The basic integration module
• An example module that will create an entity type Hipchat Response and respond with content from the entity on keywords detected in messages (Keywords are in the title)

Installation

• Install the module as usual
• Edit the capabilities JSON at Admin -> Config -> Services -> Hipchat Webhook Settings.
• Change the URL to your Drupal site
• If you want any message to be sent to Drupal, leave the pattern in the webhook section alone, or
• If you want to implement a slash command change the pattern to ^/command
• Go to Hipchat Integrations on hipchat.com and click "Install integration from descriptor URL" at the very bottom of the page. Paste this URL <your drupal site.com>/hipchat/capabilities.json
• Optionally, enable the Keyword Response module and go to Admin -> Content -> Hipchat Keyword Response to create a few responses (for example, use "hello" as a Title and "world" as a Response)

Requirements

• Your site must be publicly accessible for this module to work. Put it for free on Acquia Cloud if you need to

Security

• Drupal receives all or certain messages from the Hipchat rooms but does not store them at all. You should use HTTPs to encrypt the connection.
• The module will only respond if the oAuth Client ID matches the configuration from module installation so no arbitrary scripts will be able to use the API