Difference between revisions of "Support Ticket Statuses"

From WHMCS Documentation

m (Add TOC)
(Status Options)
 
(6 intermediate revisions by the same user not shown)
Line 1: Line 1:
__TOC__
+
Ticket statuses allow you to better organise your workflow. The setup area allows you to customise the default statuses and create your own.
  
Ticket statuses allow you to better organise your workflow & the setup area allows you to customise the default statuses as well as creating your own.
+
You can access this feature at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Ticket Statuses''' or, prior to WHMCS 8.0, '''Setup > Support > Ticket Statuses'''.
  
The ticket system has '''4''' core statuses.  These are '''Open, Answered, Customer-Reply & Closed'''.  As the core system statuses, this means that tickets are set to them automatically by the system when various events occur.  For example when a customer replies to a ticket it is set to "Customer-Reply", and when an admin replies it is set to "Answered".  The names of these statuses therefore cannot be changed, but you can still edit their color and the way they are treated.
+
== Statuses ==
  
There are 2 additional default statuses: '''On Hold & In Progress'''  These aren't required and can be fully customised, including renaming and even deleted entirely should you not wish to have them at all.
+
The ticket system has four core statuses:
  
You can add any additional statuses that you want and these will then appear in the admin ticket interface as options for you to assign tickets to when viewing or replying to them. The options you select allow you to determine how they are handled by the system and are explained in more detail below.
+
* '''Open'''
 +
* '''Answered'''
 +
* '''Customer-Reply'''
 +
* '''Closed'''
 +
 
 +
The system sets tickets to these automatically when various events occur. For example, when a customer replies to a ticket, the system sets it to '''Customer-Reply'''. When an admin replies, it sets it to "Answered".  You can't change the names of these statuses but you can still edit their colors and the way the system handles them.
 +
 
 +
There are two additional default statuses: '''On Hold''' and '''In Progress'''. These aren't required and you can fully customize them, including renaming and even deleteing them entirely if you don't want to have them at all.
 +
 
 +
You can also create more statuses that you can add to tickets when you view or reply to them. The options you select determine how the system handles them.
  
 
==Status Options==
 
==Status Options==
Line 13: Line 22:
 
For each ticket status, you can set the following attributes:
 
For each ticket status, you can set the following attributes:
  
*'''Status Color''' - A six-digit hexadecimal representation of the color to display that status in
+
*'''Status Color''' — Enter a six-digit hexadecimal representation of the color to display that status in.
*'''Include in Active Tickets''' - Ticking this box includes the status in the tickets considered as open (or more precisely, not closed)
+
*'''Include in Active Tickets''' — Check this box to display this as an option for tickets that aren't closed.
*'''Include in Awaiting Reply''' - Ticking this box includes the status in the tickets considered as awaiting a reply by staff
+
*'''Include in Awaiting Reply''' — Check this box to display this in tickets that are awaiting a reply by staff.
*'''Auto Close''' - This is used to determine if tickets set to this status should be included in the automatic closing after a defined period of inactivity (no replies). It is defined in Setup > Automation Settings.
+
*'''Auto Close''' — Choose whether to close tickets in this status after a defined period of inactivity (no replies). Define how the ticket will close in '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Automation Settings]]''' or, prior to WHMCS 8.0, '''Setup > Automation Settings'''.
*'''Sort Order''' - This determines in what order the ticket statuses are displayed
+
*'''Sort Order''' — Set the order in which ticket statuses appear.
  
 
==Translations==
 
==Translations==
  
The 6 default statuses come with translations into all the languages offered with WHMCS. For any custom statuses however, you can also create translations for those. This is done by adding a line to the language file for the desired language in the format:
+
The six default statuses come with translations into all the languages that WHMCS offers. For any custom statuses, you can create custom translations. To do this, add a line to the desired language file in this format:
  
  $_LANG['supportticketsstatus'''statusnamehere''''] = "Translation";
+
  $_LANG['supportticketsstatusstatusnamehere'] = "Translation";
  
The '''statusnamehere''' value comes from the default status name that you enter in the setup, with any non A-Z characters removed (including spaces) and then converted to lowercase.  If no translation is found in a language file, then the title entered in the setup is used.
+
The <tt>statusnamehere</tt> value comes from the default status name that you enter. This name must only contain lowercase alphanumeric characters.  If no translation exists in a language file, the system won't use the title.

Latest revision as of 19:08, 5 May 2022

Ticket statuses allow you to better organise your workflow. The setup area allows you to customise the default statuses and create your own.

You can access this feature at Configuration () > System Settings > Ticket Statuses or, prior to WHMCS 8.0, Setup > Support > Ticket Statuses.

Statuses

The ticket system has four core statuses:

  • Open
  • Answered
  • Customer-Reply
  • Closed

The system sets tickets to these automatically when various events occur. For example, when a customer replies to a ticket, the system sets it to Customer-Reply. When an admin replies, it sets it to "Answered". You can't change the names of these statuses but you can still edit their colors and the way the system handles them.

There are two additional default statuses: On Hold and In Progress. These aren't required and you can fully customize them, including renaming and even deleteing them entirely if you don't want to have them at all.

You can also create more statuses that you can add to tickets when you view or reply to them. The options you select determine how the system handles them.

Status Options

For each ticket status, you can set the following attributes:

  • Status Color — Enter a six-digit hexadecimal representation of the color to display that status in.
  • Include in Active Tickets — Check this box to display this as an option for tickets that aren't closed.
  • Include in Awaiting Reply — Check this box to display this in tickets that are awaiting a reply by staff.
  • Auto Close — Choose whether to close tickets in this status after a defined period of inactivity (no replies). Define how the ticket will close in Configuration () > System Settings > Automation Settings or, prior to WHMCS 8.0, Setup > Automation Settings.
  • Sort Order — Set the order in which ticket statuses appear.

Translations

The six default statuses come with translations into all the languages that WHMCS offers. For any custom statuses, you can create custom translations. To do this, add a line to the desired language file in this format:

$_LANG['supportticketsstatusstatusnamehere'] = "Translation";

The statusnamehere value comes from the default status name that you enter. This name must only contain lowercase alphanumeric characters. If no translation exists in a language file, the system won't use the title.