Configuring Notifications with HipChat

From WHMCS Documentation

Revision as of 20:58, 19 April 2022 by SarahK (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Configuring HipChat notifications allows you to receive notifications in your HipChat rooms when events occur in WHMCS.

Configuring HipChat Notifications

Begin by navigating to Configuration () > System Settings > Notifications or, prior to WHMCS 8.0, Setup > Notifications and clicking Configure for HipChat.

Notifications HipChat.png

Configure the HipChat module:

  • API Token — The WHMCS HipChat integration requires a HipChat API V2 User Token. This allows WHMCS to communicate with all of your HipChat rooms. Enter your token here. If you don't have an API token, see below.
  • API URLOnly required for HipChat Server users. If using HipChat Server, enter the URL to the API of your hosted instance. HipChat Cloud users should leave this field blank.

Then, click Save Changes. WHMCS will attempt to verify the API token you provided.

  • If verification fails, you will receive an error message. Check that the API token is entered correctly and has all the required scopes before you try again.
  • If verification succeeds, HipChat will become active.

Next, create your first notification rule.

Creating an API Token inside HipChat

To create a new token:

  1. Log in to HipChat and go to Account Settings > API Access.
  2. Under Create new token, enter a label for the token.
  3. Select both the View Room and Send Notification scopes. Failure to select both of these will result in errors.

Notifications HipChat APIToken.png