WHMCS Discord Notifications

WHMCS Discord Notifications

Developed By BillyAB

Compatible with WHMCS v8.7

WHMCS Discord Notifications Module

This module integrates WHMCS with Discord by sending notifications through Discord webhooks. Whenever an event in WHMCS meets the specified criteria, a notification is pushed to a Discord channel. This is particularly useful for keeping your team or community up to date with your WHMCS instance without having to check it directly.

Features

  • Easy configuration through WHMCS admin panel
  • Customizable message content and color
  • Optional role mention
  • Custom webhook avatar
  • Uses Discord Webhooks for efficient and easy integration

Author

  • William Beacroft

Installation

  1. Download the module.
  2. Upload the modules folder to the root of your WHMCS installation folder.
  3. The Discord.php and lib folder should be in the following directory whmcs/modules/notifications/Discord.
  4. Go to the WHMCS admin panel, navigate to "Setup" -> "Notifications".
  5. Activate the Discord Notifications module.
  6. Configure the settings accordingly. (refer to the discord documentation for creating the webhook for your discord server)
  7. Create notification rules and configure any override settings accordingly.

Configuration Settings

Discord Webhook URL

  • Type: text
  • Description: The Discord Webhook URL that notifications should be sent to.

Company Name

  • Type: text (Optional)
  • Description: This will be the name of the user that sends the message in the Discord channel.

Message Colour

  • Type: text (Optional)
  • Description: This is the sideline color for the message. The color code format within this script is standard hex. Exclude the beginning # character if one is present.

Notification Role ID

  • Type: text (Optional)
  • Description: If you'd like to have a specific group pinged on each message, please enter the ID here. Only include the numerical ID.

Webhook Avatar Image

  • Type: text (Optional)
  • Description: Your desired Webhook Avatar. Please make sure you enter a direct link to the image.

Per Rule Override Settings

Customise Message

  • Type: text (Optional)
  • Description: Allows you to customise the primary display message shown in the notification.

Discord Webhook URL

  • Type: text (Optional)
  • Description: Override the Discord Webhook URL for this notification to send to a different channel.

Colour

  • Type: text (Optional)
  • Description: Override the side line colour for the message. The color code format within this script is standard hex. Exclude the beginning # character if one is present.

Notification Role ID

  • Type: text (Optional)
  • Description: If you'd like to have a specific group pinged for this message rule, please enter the ID here (this is in addition to the module settings). Only include the numerical ID.

Usage

Once the module is installed and configured, you can set up WHMCS to send notifications based on specific events. For example, you can set it to notify you whenever a new ticket is created, an invoice is paid, etc.

Make sure the webhook URL is set correctly to ensure that notifications are sent to the desired Discord channel.

Contributing

For bug reports, feature requests, or any other queries regarding this module, please get in touch with me or via GitHub issues. GitHub URL: https://github.com/BillyAB/WHMCS-Discord-Notification-Module

Disclaimer

This module is provided as-is, and while efforts have been made to ensure its quality, the author is not responsible for any issues that may arise from the use of this module. It's important to test this module in a safe environment before deploying it in a production setting.

This module is in no way associated with Discord Inc., its subsidiaries, and its related companies. The Discord logo is copyright Discord Inc.

Links

GitHub: https://github.com/BillyAB/WHMCS-Discord-Notification-Module

Latest Release: https://github.com/BillyAB/WHMCS-Discord-Notification-Module/releases/latest

Buy me a coffee: https://ko-fi.com/billyab

 

Reviews

5 stars
2
2
4 stars
0
0
3 stars
1
1
2 stars
0
0
1 star
0
0

Homefighter950 @homefighter6703

December 4, 2023 at 06:18:40 PM

It is a very great AddOne, when multiple Events run, is it possible to wait and send in one Message?

William Beacroft @william3471

December 27, 2023 at 09:55:34 PM

Hi, glad you like it!
I understand your frustration on this one, especially for notifications generated by the daily cron job, but unfortunately due to the limitations in the WHMCS NotificationModuleInterface class which this module uses there is no way that I can find to queue up/group delivery of multiple messages. This is unfortunately the same for any of the other notification types in WMHCS (Slack, email etc.)

Owner@BillyAB  
  • 11 months ago

Chuck Remerez @chuck3630

June 23, 2023 at 10:58:29 PM

Notifications are instant, the setup is easy, and it's boosted our productivity a lot. It's become an essential part of our work. Highly recommended!

  • 1 year ago
  • Version Number 1.0.1

Richard TheShiper @richard3583

June 21, 2023 at 12:30:42 AM

This works great! Easy set up and well done, I would love if we could on the hook list the Product that was it was related to… e.g. when a new order is placed it shows the current info plus what Product/Service it is.

Otherwise amazing work!

William Beacroft @william3471

June 23, 2023 at 10:53:34 PM

Hi, thanks for your positive feedback!
Unfortunatly that information isn't presented by WHMCS to the NotificationInterface class as far as I can see (as I'd have quite liked it too). Every attribute that is presented by WHMCS to the notification module is sent to you.

Owner@BillyAB  
  • 1 year ago
  • Version Number 1.0.1

Version Compatibility


Compatible with WHMCS v8.7

Full Version Compatibility


  • Selected versions of WHMCS v8.7
        8.7.0 - 8.7.2
  • Selected versions of WHMCS v8.6
        8.6.0 - 8.6.1
  • All versions of WHMCS v8.5
  • All versions of WHMCS v8.4
  • All versions of WHMCS v8.3
  • All versions of WHMCS v8.2
  • All versions of WHMCS v8.1
  • All versions of WHMCS v8.0
  • All versions of WHMCS v7.10
  • All versions of WHMCS v7.9
  • All versions of WHMCS v7.8
  • All versions of WHMCS v7.7
  • All versions of WHMCS v7.6
  • All versions of WHMCS v7.5
  • All versions of WHMCS v7.4
  • Selected versions of WHMCS v7.3
        7.3.0
  • All versions of WHMCS v7.2
  • All versions of WHMCS v7.1
  • All versions of WHMCS v7.0

Support for this product

The best place to start if you need help with a specific product is to contact the developer. All WHMCS Marketplace developers have both a website and support URL listed.

Developed By BillyAB

Changelog

v1.1.0 Released July 4th, 2023

Latest Version


  • Add support for per notification rule ping roles

 

Previous Versions


v1.0.1 Released June 17th, 2023

View/hide detailed changelog

v.1.0.1 Created correct directory structure for module.

 

v1.0 Released June 15th, 2023

View/hide detailed changelog

v1.0

Inital release

 

See also

Discord Notifications

A simplistic, free & open source hook allowing instant Discord notifications when an action is triggered.

Free
Netgsm Sms

Netgsm Sms addon provides you sending customized bulk sms and creating sms templates.

Free
MSG91 SMS/OTP Plugin

MSG91 WHMCS SMS plugin gives you the power and flexibility to stay connected with your customers by sending them an SMS and OTP's for 2FA at the crucial steps that matters the most.

Free
SMS Manager

More Advanced SMS System

Commercial
SMS Alert

Send automated SMS alert from WHMCS, and verify users mobile with OTP

Free