metallicgloss / whmcs-discord-notifications Goto Github PK

A hook to push a range of different WHMCS notifications instantly to a Discord channel.

License: Mozilla Public License 2.0

PHP 100.00%

php whmcs discord notifications hook simple free

whmcs-discord-notifications's Introduction

WHMCS Discord Notification Hook

Want instant Discord notifications? Need to know when you've received a ticket reply without waiting for emails to give you a notification? This hook will allow just that! It's free, open-source and customisable - offering a range of instant notifications within your Discord server.

Brought To You For Free By

Zare.com - Affordable DDoS Protected Server Solutions

Zare offers a range of high-performance bare metal dedicated servers available across Europe; connected to a global high-capacity low-latency network and with state-of-the-art Corero DDoS protection included as standard, you can be certain your online presence will not be hindered by your host.

With affordable prices, fast provisioning and full access to your hardware, upgrade your infrastructure and switch to Zare today.

View Available Servers

Installation Instructions

Download a free copy of this GitHub repo or release version; you should end up with a .zip file.
Extract the file and upload the includes folder within the zip to your base WHMCS directory (we'd recommend doing so on a development environment first).
Open up the file you have just uploaded, which will be within the includes/hooks directory. The full path is includes/hooks/WHMCS-Discord-Notifications.php
Modify lines 11-41 to enter your Discord configuration. Comments are provided below each option to assist you in understanding what data is needed for each.
Modify lines 42-74 to your liking to enable or disable which notifications are sent by the hook to your Discord server.
Give it a test! Check to make sure it sends through to the channel configured within your Discord server; if it doesn't work, double-check your config options! Enjoy!

Configuration Options

Set a specific rank depending on the notification type to get pinged to deal with it.
Automatically generated link to instantly navigate to the page the notification is relating to.
Configurable name of the bot sending messages.
Configurable avatar profile image (allowing the same webhook to be used by multiple installs).
Configurable message colours.

Notification Types

Ticket Notifications

New Ticket Opened
New Ticket Reply Received
New Ticket Note
Ticket Flagged To Staff Member

Invoice Notifications

Invoice Payment Received
Invoice Refunded
Invoice Late Fee Added

Order Notifications

Order Marked as Pending
Order Paid
Order Accepted
Order Marked As Fraudulent
Order Cancelled
Order Cancelled and Refunded

Network Issue Notifications

New Network Issue
Network Issue Modified
Network Issue Closed

Misc Notifications

Cancellation Request Received

whmcs-discord-notifications's People

Contributors

Stargazers

Watchers

whmcs-discord-notifications's Issues

More detailed

Make it more detailed:

when the action is associated with some user, display first name last name and email od the user + avatar in the embed author, and set link to the embed author irl to user page in admin area.
display more info, like ticket subject, product names in order, ...

Hebrew Not Working

Hi I find a bug that lang Hebrew not working

Issue with Fraud Orders

I have orders being marked as fraud (forcefully by setting a super strict threshold)
I have tested most of the other features, but for some reason the fraud will not throw a webhook alert.

Any idea what might be the cause? I was able to replicate this on another host with my dev instance of WHMCS.

I am currently using the latest WHMCS with PHP version 8.1

Order Number Not Displaying

Hello,

I would just like to say that this is an amazing module! :) Thank you for making this open source.

However, unfortunately, when someone generates an order & pays for it, the order number does not display. Moreover, when I try to click the link in the embed, it just redirects without an order ID. I suspect that WHMCS may have changed a variable which is causing this. The invoice number works fine.

I have also contacted someone I know that also uses this module, and they experience the same issues on their install. Currently, we are running WHMCS 8.4.0, while the other person I know is running WHMCS 8.5.1.

Thank you!

User name, avatar and link in embed author

When the action is triggered by some user, display first name, last name and email of the user + avatar in the embed author, and set link to the embed author url to user page in admin area.

Install location

I am trying to get this installed I have put it in includes/hooks/WHMCS-Discord-Notifications.php
I have filled all the info into the PHP file with the admin area webhook URL company name but I am wondering why nothing happens when we get a new order/ticket

can you help me please

Order create, user create notifications

Send webhook when user was created and user was registered.

Not working

im trying to use this and i configured it correctly i think, I added the discord webhook at the top and chose my company name and put the admin URL location. is there anything else i need to do to make it work?

To-do notification

Add notification when something has been added to your to-do list. Useful when you use auto release module for product and want to be notified when you should setup the service.

Today 10 Jan 2023 Notifications stoped working suddenly, as its been working from 2021

Today 10 Jan 2023 Notifications stopped working suddenly, as it's been working from 2021
I did create a new WebHook but still no notifications are going through, config is 100%

Something stopped working.

At first I want to thank you for this awesome free and open source project, I've been using it for near two years with any issue, but I've just noticed that for some reason at 10th January 2023 it stopped working without any change or modification in its config. Could this have something to do with latest WHMCS update ? Did it stopped working for any one else ?

Many thanks !