Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The ticket received message template allows for the following tags:

TagsDescriptionNotesSince
{ticket_hash_code}A hash code for validating ticket repliesRequired to be in the subject line to allow for tickets to be replied to by email

{ticket.id}

The system-level ticket ID

{ticket.code}The ticket numbere.g. "1821914"
{ticket.department_id}The system-level department ID of the department this ticket belongs to

{ticket.staff_id}The system-level staff ID of the staff member assigned to this ticketMay be empty
{ticket.service_id}The system-level service ID of the service this ticket is in relation toMay be empty
{ticket.client_id}The system-level client ID of the client this ticket is assigned to

{ticket.email}The email address the ticket was emailed in fromOnly set when the email address is piped in and unrecognized
{ticket.summary}A brief ticket summary

{ticket.priority}The system-level ticket prioritye.g. "critical", "high", "medium", etc.
{ticket.priority_language}The language for the translated ticket prioritye.g. "Critical", "High", "Medium", etc.
{ticket.status}The system-level ticket statuse.g. "open", "awaiting_reply", "closed", etc.
{ticket.status_language}The language for the translated ticket statuse.g. "Open", "Awaiting Reply", "Closed", etc.
{ticket.date_added}The UTC datetime stamp of ticket creationFormatted as "YYYY-MM-DD HH:MM:SS"
{ticket.date_closed}The UTC datetime stamp the ticket was closedMay be empty. Formatted as "YYYY-MM-DD HH:MM:SS"
{ticket.reply_id}The system-level reply ID attached to this ticket

{ticket.reply_staff_id}The system-level staff ID of the staff member that sent this reply

{ticket.reply_type}The system-level type of replyi.e. "reply", "note", "log". Emails are only sent when the type is "reply"
{ticket.reply_has_attachments}Whether or not this specific reply has any attachments

{ticket.has_attachments}Whether or not any replies to this ticket have any attachments

{ticket.details}The ticket reply details in plain text

{ticket.details_html}The ticket reply details in HTML

{ticket.reply_date_added}The UTC datetime stamp of the replyFormatted as "YYYY-MM-DD HH:MM:SS"
{ticket.company_id}The system-level company ID this ticket was created under

{ticket.department_name}The name of the department this ticket belongs to

{ticket.department_email}The email address of the department this ticket belongs to

{ticket.override_from_email}Whether or not the email template's from address has been replaced with the department emaili.e. "1" or "0"
{ticket.reply_by}The system-level type indicating where the ticket reply came fromi.e. "system", "staff", "client", or "email"
{client.first_name}The first name of the client that opened this ticket

{client.last_name}The last name of the client that opened this ticket

{reply_contact.first_name}The first name of the last contact to reply to this ticket

{reply_contact.last_name}The last name of the last contact to reply to this ticket

Departments

Info
titlePOP/IMAP Settings

When selecting POP or IMAP for email handling, be sure to select the proper Security option for the port you are using. None, TLS, or SSL may be required depending upon the port number you are connecting to. See http://www.arclab.com/en/amlc/list-of-smtp-and-pop3-servers-mailserver-list.html for a list of common configurations.

...

OptionDescription
NameThe department name is shown throughout the interface to reference the department a ticket may be assigned to.
DescriptionThe department description is shown on client-facing pages.
Allow only clients to open or reply to ticketsChecking this option will only allow tickets to be assigned to this department from a known client.
Require Human Verification for unauthenticated usersOnly appears when the client only option is unchecked.  Checking this option will require human verification for unauthenticated users to create a new ticket.
Email

A unique department email address should be set for email handling.

Info

If you are importing email via POP/IMAP/Piping the email address of your department MUST match the email address you are checking. If you are forwarding mail from support@domain.com to support@sub.domain.com then the address for your department must be support@sub.domain.com


Override the from address set in email templates with the email address set for this departmentChecking this option will set the From address in support ticket emails to this department's email.
Default PriorityTickets created without a priority set (e.g. from email) will be created using the default priority status.
Email Handling

Email Handling will allow for additional configuration for automatic ticket retrieval via email through POP/IMAP or piping.

Configuring departments for ticket piping will allow tickets to be retrieved and processed into Blesta immediately.

OptionDescription
Piping ConfigurationConfiguring piping may vary. See Email Piping for more information.


Configuring departments for POP/IMAP ticket retrieval is dependent on the automation task "Download Tickets". Ticket emails will be retrieved at the interval set for that cron task.

OptionDescription
SecuritySSL, TLS, or no security flags may be configured to determine whether tickets are retrieved securely.
Box NameThis is the name of the folder/inbox on the email account that will contain new tickets for import.
Mark Messages asEmails that are processed need to be marked as Read, or Deleted entirely so that they are not imported again. POP3 will always delete messages, but IMAP may be marked as read to avoid importing the same message as a ticket more than once.
HostEnter the hostname to connect to to retrieve email.
UserEnter the username of the email account.
PassEnter the password to the email account.
PortEnter the port to connect on to retrieve email. This may vary depending on mail server settings and protocol.


Automatically Close Tickets

After the selected number of days have passed, any tickets belonging to the department will be automatically closed if the following conditions are met:

  • The last person to reply to the ticket was a staff member
  • The ticket status is not "In Progress", or already closed.

Tickets are closed by cron, and are so dependent on the "Close Tickets" automation task.

A pre-defined response may be defined, and any tickets that are auto-closed will be updated with the set response.

Automatically Delete Tickets (v2.14.0)

After the selected number of days have passed, any tickets belonging to the department will be automatically deleted if the following conditions are met:

  • The ticket is in the "Trash" status.

Tickets are deleted by cron, and are so dependent on the "Delete Trash Tickets" automation task. Tickets can also be deleted manually as noted in the 'Tickets' section of this page.

StatusThe department status may be Hidden or Visible. This indicates whether a client may view and create a ticket in this department from the client interface. Note that tickets may still be created if emailed into this department.

...