Difference between revisions of "Support Ticket Escalations"

From WHMCS Documentation

(Notes)
Line 1: Line 1:
Found under '''Setup > Support > Escalation Rules''', ticket escalation rules allow you to specify actions to take automatically if a support ticket has been in a specified state for a set period of time.
+
Under '''Setup > Support > Escalation Rules''', ticket escalation rules allow you to specify actions to take automatically if a support ticket is in a specified state for a set period of time.
  
You can select the Departments, Statuses and Priorities that the escalation rule applies to. For example, in the picture below, low and medium priority tickets will be changed to high, a response will be automatically made to the client and an email sent to the members of the specific support department after 4 hours with no response.
+
You can select the Departments, Statuses and Priorities that the escalation rule applies to. For example, in the picture below, low and medium priority tickets will change to high, an automatic response will go to the client, and members of the relevant support department will receive an email after 4 hours with no response.
  
The following merge fields in the Add Reply box:
+
The following merge fields are in the Add Reply box:
  
 
[NAME] - Ticket Submitter Name<br>
 
[NAME] - Ticket Submitter Name<br>
Line 13: Line 13:
 
===Setup===
 
===Setup===
  
Prior to WHMCS 7.1, a dedicated cron task entry is required for escalations to be performed. If you are running WHMCS 7.1 or later, this is '''no longer''' required.
+
WHMCS 7.0 and earlier require a dedicated cron task entry for escalations. If you are running WHMCS 7.1 or later, this is '''no longer''' necessary.
  
 
<div class="source-cli">php -q \path\to\home\public_html\whmcspath\crons\cron.php do_escalations</div>
 
<div class="source-cli">php -q \path\to\home\public_html\whmcspath\crons\cron.php do_escalations</div>
  
Please note the space between cron.php and escalations. The command will run the escalations task of the cron only. It should be configured to run once every few minutes, we recommend every 3-5 minutes.
+
Note the space between cron.php and escalations. The command will run the escalations task of the cron job only. Configure this to run once every few minutes (we recommend every 3–5 minutes).
  
 
===Notes===
 
===Notes===
Escalation rules only apply to tickets submitted after the escalation rule. Tickets submitted before will not be escalated automatically.
+
Escalation rules only apply to tickets that customers submitted after the escalation rule's creation. Existing tickets will not escalate automatically.
  
Escalation rules are applied to every ticket which meets the specified conditions. If no changes are made to the ticket via the specified actions to ensure the ticket no longer meets these conditions, then the escalation rule will continue to affect the ticket until it no longer matches the conditions.
+
Escalation rules apply to every ticket that meets the specified conditions. If nothing happens to ensure that the ticket doesn't meet the conditions, the escalation rule will continue to affect the ticket. It will only stop affecting the ticket when it no longer matches the escalation rule conditions.

Revision as of 19:54, 8 May 2020

Under Setup > Support > Escalation Rules, ticket escalation rules allow you to specify actions to take automatically if a support ticket is in a specified state for a set period of time.

You can select the Departments, Statuses and Priorities that the escalation rule applies to. For example, in the picture below, low and medium priority tickets will change to high, an automatic response will go to the client, and members of the relevant support department will receive an email after 4 hours with no response.

The following merge fields are in the Add Reply box:

[NAME] - Ticket Submitter Name
[FIRSTNAME] - First Name
[EMAIL] - Ticket Submitter Email

Ticketescalations.png

Setup

WHMCS 7.0 and earlier require a dedicated cron task entry for escalations. If you are running WHMCS 7.1 or later, this is no longer necessary.

php -q \path\to\home\public_html\whmcspath\crons\cron.php do_escalations

Note the space between cron.php and escalations. The command will run the escalations task of the cron job only. Configure this to run once every few minutes (we recommend every 3–5 minutes).

Notes

Escalation rules only apply to tickets that customers submitted after the escalation rule's creation. Existing tickets will not escalate automatically.

Escalation rules apply to every ticket that meets the specified conditions. If nothing happens to ensure that the ticket doesn't meet the conditions, the escalation rule will continue to affect the ticket. It will only stop affecting the ticket when it no longer matches the escalation rule conditions.