Marketing Triggers Automation For WHMCS
From ModulesGarden Wiki
(Difference between revisions)
|
|
Line 138: |
Line 138: |
| {| | | {| |
| |style="padding: 0px 0px 0px 45px;"|✔ Select Email Template | | |style="padding: 0px 0px 0px 45px;"|✔ Select Email Template |
| + | |} |
| + | {| |
| + | |style="padding: 0px 0px 0px 45px;"|✔ Mark As Marketing Email |
| |} | | |} |
| {| | | {| |
Line 159: |
Line 162: |
| {| | | {| |
| |style="padding: 0px 0px 0px 45px;"|✔ Select API Execution Admin | | |style="padding: 0px 0px 0px 45px;"|✔ Select API Execution Admin |
| + | |} |
| + | {| |
| + | |style="padding: 0px 0px 0px 45px;"|✔ Mark As Marketing SMS |
| |} | | |} |
| {| | | {| |
Revision as of 10:39, 12 March 2025
Article update is ongoing on this page, watch out for broken links, unclear descriptions and images!
We are sorry for the inconvenience caused.
Marketing Triggers Automation For WHMCS is a tool that automates tasks by triggering specific actions based on customer behavior or initiated processes.
Configure triggers for various events to automatically perform actions such as sending email or ticket notifications, displaying custom popups, or creating admin to-do items. Use the module to eliminate repetitive tasks and maximize your marketing potential.
|
✔ Create Triggers To Launch Specific Automated Actions:
|
✔ View Dashboard With Recently Triggered Actions And Summary
|
✔ Create And Manage Actions:
|
✔ Select Action Template:
|
✔ Configure Specific Settings Per Selected Action
|
✔ Use Available Merge Fields Variables For Selected Action
|
✔ Select Trigger On Specific Action:
|
✔ Configure Related Trigger Settings
|
✔ Select Action To Lunch Based On Trigger
|
✔ Enable Overwriting Pending Action
|
✔ Customize Module Language Files With "Translations" Tool
|
✔ View And Manage Module Logs
|
✔ Specify Title / Description / Due Date Delay (Days)
|
✔ Selects Admin Assignment
|
✔ Use Available Merge Fields Variables
|
✔ Select Department / Assigned Admin / Ticket Template
|
✔ Define Custom Ticket Content
|
✔ Use Available Merge Fields Variables
|
✔ Email Notification To Admin:
|
✔ Select Email Recipients
|
✔ Email Notification To Customer:
|
✔ Mark As Marketing Email
|
✔ Define SMS Custom Message
|
✔ Enable Instant Delivery
|
✔ Select API Execution Admin
|
✔ Use Available Merge Fields Variables
|
✔ Define SMS Custom Message
|
✔ Enable Instant Delivery
|
✔ Select API Execution Admin
|
✔ Use Available Merge Fields Variables
|
✔ Show Client Area Popup:
|
✔ Specify Action Name / Popup Title
|
✔ Toggle Showing Close Button
|
✔ Use Available Merge Fields Variables
|
✔ Activated / Canceled / Renewed / Suspended / Unsuspended / Terminated
|
✔ Affiliate Activated / Link Clicked / Withdrawal Requested
|
✔ Contact Added / Edited / Deleted
|
✔ Knowledgebase Page Viewed
|
✔ Contact Details Updated
|
✔ Registered / Renewed / Transferred
|
✔ Canceled / Unpaid / Refunded / Paid
|
✔ Placed / Canceled / Accepted
|
✔ Created / Suspended / Unsuspended / Terminated / Renewed
|
✔ URL Post Data Contains Parameters
|
- Available Merge Fields Variables:
✔ Addon Activated / Addon Canceled / Addon Renewed / Addon Suspended / Addon Terminated / Addon Unsuspended
|
✔ Addon Removed From Service
|
✔ Affiliate Activated / Affiliate Link Clicked / Affiliate Withdrawal Requested
|
✔ Service Password Changed / Service Package Changed / Service Renewed / Service Suspended / Service Terminated / Service Unsuspended
|
✔ Cancelation Requested / Client Service Details Viewed
|
✔ Client - Quote Accepted
|
✔ Client - Password Changed / Client - Knowledgebase Page Viewed / Client - Email Verified
|
✔ Client - Details Updated / Client - Status Changed / Add / Edit Credit Card / Client - Contact Deleted / Page Viewed / URL Post Data Contains Parameters
|
✔ Client - Contact Added / Client - Contact Edited
|
✔ Domain Details Viewed / Domain Contact Details Updated / Domain DNS Records Updated / Domain Nameservers Updated
|
✔ Domain EPP Code Requested / Domain Registered / Domain Renewed / Domain Transferred
|
✔ Invoice Canceled / Invoice Paid / Invoice Refunded / Invoice Unpaid / Order Accepted / Order Canceled
|
✔ Invoice Gateway Changed / Order Marked as Fraudulent
|
✔ Ticket Reply by Admin / Ticket Closed / Ticket Opened by Admin
|
✔ Ticket Opened by Client / Ticket Reply by Client
|
✔ Supports WHMCS Opt-In/Out Marketing Email Settings
|
✔ Multi-Language Support With Custom Translations Tool
|
✔ Supports Google Analytics 4
|
✔ Supports PHP 8.2 Back To PHP 8.1
|
✔ Supports WHMCS V8.12 Back To WHMCS V8.9
|
✔ Requires ionCube Loader V13 Or Later
|
Installation
1. Log in to our client area and download the module.
|
2. Extract the package and upload its content into the main WHMCS directory.
The content of the package to upload should look like this.
|
3. When you install Marketing Triggers Automation For WHMCS for the first time you have to rename 'license_RENAME.php' file.
The file is located in 'modules/addons/MarketingTriggersAutomation/license_RENAME.php'. Rename it from 'license_RENAME.php' to 'license.php'.
|
4. In order to configure your license key, you have to edit the previously renamed 'license.php' file.
Enter your license key between quotation marks as presented on the following screen. You can find your license key in our client area → 'My Products'.
|
5. Now you have to activate the module in your WHMCS system.
Log in to your WHMCS admin area. Go to 'System Settings' → 'Addon Modules'. Afterwards, find 'Marketing Triggers Automation' and press the 'Activate' button.
|
6. In the next step, you need to permit access to this module.
To do so, click on the 'Configure' button, tick 'Full Administrator' and press 'Save Changes'.
|
7. The final step of the module installation is setting up a cron command that is required for several module features to work properly.
php -q /yourWHMCS/modules/addons/MarketingTriggersAutomation/cron/cron.php actions:run
Note that the above directory is exemplary, please adjust the cron line to your own needs. 5 minute interval is recommended.
|
8. You have just successfully installed Marketing Triggers Automation!
You can access your module under 'Addons' → 'Marketing Triggers Automation'.
|
Management
Marketing Triggers Automation For WHMCS lets you automate tasks based on customer actions and triggered in your WHMCS processes.
In this guide, we will walk you through the management features of the module.
|
Dashboard
The dashboard provides crucial information regarding the module operating processes.
At the top, you will find the 'Configuration Guide' make sure to read it thoroughly to learn how to set up actions and triggers.
This documentation will cover the same topics in detail as well.
|
Besides the guide, the dashboard features 'Recently Triggered Actions' table which presents the history of actions including:
- ID - the event ID number.
- Triggered by - the username of the client or administrator that triggered the action.
- Trigger - which of the triggers launched the action.
- Action - which of the actions was triggered.
- Status - the event status: "Pending", "Finished", "Error" and "Ready".
Note: The 'Ready' status indicates that an action is prepared and waiting for the customer,'
|
The 'Actions Summary' counts actions taken by the module, the counters include:
- Actions Triggered in the Last 24 Hours
- Actions Triggered in the Last 7 Days
- Actions Triggered in the Last 30 Days
- Total Actions Triggered
|
Actions
After the module detects a trigger, the actions associated with that trigger will be automatically launched. To customize the module and compose a list of actions you wish to be launched automatically, navigate to the 'Actions' section of the addon.
To create the first action, click on the 'Create Action' button.
|
Choose the name of the single action for easy identification, it will be selected when adding triggers in the next steps, and then select the action from the list.
|
In this way, add to the list all the actions you wish to be automated and performed after certain system events. Further, you will find descriptions of all possible actions and their specifications to be configured per your need.
To configure the action click on the 'Edit' button.
|
Add To-Do Item
This action will create an item in the WHMCS to-do list. Use it to assign and track specific tasks related to triggers within your workflow.
Complete the following fields and click 'Submit' to create the action.
If you want, you can use merge fields, they can be found below the action form. Find the trigger you plan to use to see merge fields available for it.
- Action Name - name the action, this will help identify it when creating a trigger later.
- Title - enter a title, it will be used to name the to-do item.
- Description - provide a description for the to-do item.
- Due Date Delay (Days) - enter how many days after the trigger the action should be taken.
- Admin Assignment - select which admin will be assigned to the to-do item.
- Initial Status - select the status of the to-do item with which it should be created.
|
Send Email Notification to Admin
Send an email to selected admins. This can be used to notify specific team members about important updates or actions that require their attention.
- Action Name - name the action, this will help identify it when creating a trigger later.
- Email Recipient - select which admins will receive the email, the Triggering Admin, is the admin that is responsible for triggering the event.
- Email Template - select the email template that will be used for the action.
|
Send Email Notification to Customer
Send an email to clients when they trigger the action. This is useful for keeping clients informed or confirming actions they have initiated.
- Action Name - name the action, this will help identify it when creating a trigger later.
- Email Template - select the email template that will be used for the action.
- Mark as Marketing Email - If enabled, this email notification will be classified as a marketing message, and customers who have opted out of marketing emails will not receive it.
If the option is disabled, the email will be sent regardless of the customer's marketing preferences. Note: If WHMCS has the "Marketing Emails" feature completely disabled in its settings, all notifications will be delivered regardless of the switch status.
|
Open Support Ticket
This action will create an open support ticket for the customer that triggers it. It helps automate the process of addressing customer issues by automatically generating a ticket for prompt follow-up.
- Action Name - name the action, this will help identify it when creating a trigger later.
- Department - select the department to assign the ticket to.
- Assigned Admin - select the admin that will be assigned to the ticket.
- Ticket Templates - select a ticket template for its contents, or pick 'Custom' to create a new one.
Note: Ticket templates can be found in WHMCS under 'System Settings' → 'Email Templates' → 'Support Messages'.
- Subject - enter a subject for the ticket, you can use merge fields here. The full list of merge fields can be found at the bottom of the page.
- Priority - select the priority level of the ticket.
- Ticket Creator - select who should be the creator of the ticket.
- Custom Ticket Content - if you decide to create your custom ticket template, an editor will be displayed where you can write its contents including merge fields, HTML tags and CSS styles.
|
|
Send SMS Notification to Admin
Send an SMS message to selected admins. This can be used to notify admins about important updates or actions that require their attention via SMS.
- Action Name - name the action, this will help identify it when creating a trigger later.
- API Execution Admin - select which admin will be used to execute the API.
- Notified Admins - select which admins will receive the message. 'Triggering Admin' is the admin that has triggered the action.
- Instant Delivery - enable to skip the SMS Center For WHMCS queue and send the message immediately.
- Message Type - select a message type from SMS Center For WHMCS or create a 'Custom Message'.
- SMS Custom Message - if 'Custom Message' is selected this field will appear. You can enter the message text including merge fields found under it.
|
Send SMS Notification to Customer
Send an SMS message to the triggering client. This allows you to quickly notify the client via SMS about important updates or actions they have initiated.
- Action Name - give the action a name to help you identify it when setting up a trigger later.
- API Execution Admin - choose the admin who will execute the API for this action.
- Mark as Marketing SMS - If enabled, this SMS will be classified as a marketing message:
- "Marketing SMS" checkbox in the client profile is disabled - Customers will not receive the SMS.
- "Marketing SMS" checkbox in the client profile is enabled - Customers will receive the SMS.
- If Mark as Marketing SMS in the addon is disabled, clients will receive messages regardless of their marketing preferences.
- Instant Delivery - turn this on to bypass the SMS Center For WHMCS queue and send the message right away.
- Message Type - pick a message type from SMS Center For WHMCS or create your own 'Custom Message'.
- SMS Custom Message - If you select 'Custom Message', this field will appear, allowing you to enter the message content, including any applicable merge fields.
|
|
Show a popup window with a notification you customize. This can be used to alert users or display important messages in a visually engaging way.
- Action Name - name the action, this will help identify it when creating a trigger later.
- Popup Size - select the size of the popup.
- Show Close Button - if enabled, the popup will include the close button.
- Popup Title - include the title of the popup.
- Popup Template - select a template for the popup or pick 'Custom' to create a new one.
Note: You can include templates by adding a new .tpl file under 'modules/addons/MarketingTriggersAutomation/resources/popupTemplates'.
- Popup Message - if 'Custom' popup template is selected, you can create your message here, including merge fields, HTML, JS and CSS code.
|
This is how the notification is displayed to the user.
|
Once all the actions have been configured, you can manage them further by editing or deleting individual actions.
Alternatively, you can use the mass action function to delete multiple actions at once.
|
Triggers
Once the set of actions you wish to be automatically launched is ready, you can proceed and set up triggers that will cause these actions to be activated.
Move to the 'Triggers' section now and click on 'Create Trigger'.
|
While creating a trigger, you will need to specify:
- Name - name the trigger.
- Status - enable or disable the trigger, you can always change the status later.
- Trigger - select the trigger for the action.
- Action - select the action to be taken when the trigger occurs.
- Overwrite Pending Action - enable to ensure only the latest data update occurs.
- Action Delay Unit - select the unit for action delay (seconds, minutes, hours, days).
- Action Delay Value - enter the value for action delay.
- Additional Trigger-specific Fields - some triggers might include additional configuration fields.
|
|
Here is a list of all available triggers:
Add/Edit Credit Card Client - Email Verified Order Accepted
Addon Activated Client - Knowledgebase Page Viewed Order Placed
Addon Added to Service Client - Password Changed Upgrade Page Viewed
Addon Cancelled Client - Quote Accepted Page Viewed
Addon Removed Client - Status Changed Quota Status Changed
Addon Renewed Domain Contact Details Updated Service Created
Addon Suspended Domain DNS Records Updated Service Details Viewed
Addon Terminated Domain Details Viewed Service Package Changed
Addon Unsuspended Domain EPP Code Requested Service Password Changed
Affiliate Activated Domain Nameservers Updated Service Renewed
Affiliate Link Clicked Domain Registered Service Suspended
Affiliate Withdrawal Requested Domain Renewed Service Terminated
Cancellation Requested Domain Transfer Failed Service Unsuspended
Order Cancelled Domain Transferred URL Post Data Contains Parameters
Order Marked as Fraudulent Invoice Refunded Ticket Reply by Client
Client - Contact Added Invoice Unpaid Ticket Closed
Client - Contact Deleted Invoice Cancelled Ticket Opened by Admin
Client - Contact Edited Invoice Gateway Changed Ticket Opened by Client
Client - Details Updated Invoice Paid Ticket Reply by Admin
|
After a trigger is added, you can disable/enable it with the 'Status' toggle, as well as edit or delete it with the action buttons.
|
You can also use the mass function to delete multiple triggers at once.
|
Customizing language files is now extremely easy with the "Translations" tool that is now available directly in the addon. Its user-friendly design makes managing various language file tweaks a smooth and efficient process. Prepare translations for the original English files with this handy built-in tool.
For specific instructions on how to use this tool please refer to its dedicated article, you will find it here.
|
The "Logs" tool makes monitoring and managing module activity records simple and efficient. It provides options to categorize, filter, and view detailed entries, giving you control over the logs. Features like bulk deletion, rule-based deletion, and export options make it easy to organize and maintain your logs.
For detailed guidance on using this tool, check its dedicated article, which is available here.
|
Tips
1.You can combine various triggers and actions into almost countless combinations. The examples provided in the documentation are just a few of the possible configurations.
|
Update Instructions
An essential guidance through the process of updating the module is offered here.
Ensure successful completion of the module update by carefully following each step, thereby preventing data loss or any unforeseen issues. Additionally, you will find a current list of supplementary actions necessary for a smooth update process there.
|
Upgrade Guide
Seeking a solution that offers greater flexibility, customization tailored to your precise needs, and unrestricted availability? There is an option that not only proves to be cost-effective in the long run but also includes prioritized support services, making it a truly valuable investment.
Opt for the Open Source version of your Marketing Triggers Automation For WHMCS module to unlock these benefits. Simply click on either the Get Source Code or Upgrade To Lifetime button found on the product's page in our client area to complete the one-step upgrade process, with a dedicated discount already applied.
Follow a comprehensive guide covering the transition process, the advantages it brings, and step-by-step instructions on what to do next after the order has been successfully finalized.
|
Common Problems
1. When you have problems with connection, check whether your SELinux or firewall does not block ports.
|