Configuring Notifications with Slack

From WHMCS Documentation

Revision as of 12:37, 25 October 2017 by Matt (talk | contribs) (Configuring Slack Notifications)

Configuring Notifications with Slack allows you to receive notifications in your Slack channels when events occur within WHMCS.

For more information on Notifications, please refer to the Notifications Documentation.

Configuring Slack Notifications

To enable WHMCS to communicate with the Slack API, WHMCS requires an OAuth Access Token.

You can create an OAuth Access Token quickly and easily by following the steps below.

Installing the WHMCS App to your Slack Workspace

1. Begin by visiting https://api.slack.com/

2. Click the Start Building button to start the process of creating a new app.

3. Enter a name for the app. We recommend something like 'WHMCS'. Also choose the workspace you wish to add the app to. Then click continue.

4. Under the Add features and functionality heading, select the Permissions option.

Slack-permissions.png

5. On the following screen, scroll to the Scopes section and add the following two scopes:

  • Access information about user’s public channels (channels:read)
  • Send messages as WHMCS (chat:write:bot)

Slack-scopes.png

6. Click Save Changes

7. Now navigate to Install App in the sidebar.

Slack-install.png

8. Click the Install App button.

9. Confirm you authorize the permissions for the app that you just configured.

Slack-authorize.png

10. You will now be presented with the OAuth Access Token you need for WHMCS integration. Copy this value.

Slack-oauth-token.png

11. Now return to WHMCS and navigate to Setup > Notifications.

12. Under the Slack notification provider, click Configure

13. Enter the OAuth Access Token you copied in step 10 where requested and hit Save Changes to complete the process.

WHMCS will attempt to verify the OAuth Access Token provided. If the verification fails you will receive an error message. Check the Access Token is entered correctly, has all the required scopes and try again. If successful, the modal will close and Slack will change to active.

You are now ready to Create Your First Notification Rule.