OCMLABS/MODULE-SUPPORT-TICKET · EMAIL NOTIFICATIONS

Email Notifications

  • Magento
  • Adobe Commerce
  • Hyvä

Support Tickets sends five distinct transactional emails across the ticket lifecycle. All five are sent automatically while Enable Support Tickets is set to Yes (the default), with no additional configuration beyond the Admin Notification Email and Email Sender settings under System Settings.

The five notification events

EventTriggerRecipientDefault template
New ticket - customerCustomer submits a new ticketThe customer who opened the ticketocmlabs_support_ticket_email_templates_new_customer_template
New ticket - adminCustomer submits a new ticketAdmin Notification Email from configocmlabs_support_ticket_email_templates_new_admin_template
New comment - customerAdmin posts a replyThe ticket ownerocmlabs_support_ticket_email_templates_comment_customer_template
New comment - adminCustomer posts a replyAdmin Notification Email from configocmlabs_support_ticket_email_templates_comment_admin_template
Ticket resolved - customerCustomer clicks Mark as ResolvedThe ticket ownerocmlabs_support_ticket_email_templates_resolved_template

Admin-side notifications go to the single address set in Stores > Configuration > OrangeCollar > Support Tickets > General > Admin Notification Email. If you want multiple staff to receive the same alerts, use a distribution list or alias rather than trying to configure multiple addresses. Leave the field empty to turn off admin emails.

Admin status changes, from the ticket page or the grid’s bulk actions, do not send any email. Setting a ticket to Resolved in the admin does not send the resolved email.

Available template variables

Every template receives these variables:

VariableDescription
ticket_idNumeric ticket ID
ticket_subjectThe ticket title
ticket_statusCurrent status code (open, pending, in_progress, or resolved)
ticket_priorityPriority code (low, medium, high, or urgent)
view_urlCustomer-facing URL to the ticket view page
account_urlURL of the customer’s Support Tickets list

Some templates receive extra variables:

TemplateExtra variables
New ticket - admincustomer_name, customer_email, admin_url
New comment - customercomment_message (the reply that triggered the email)
New comment - admincustomer_name, comment_message, admin_url

admin_url is the admin ticket edit URL. The new ticket - customer and ticket resolved templates use only the common variables.

Customizing a template

Each of the five templates can be replaced with a custom Magento email template from the admin:

  1. Go to Marketing > Communications > Email Templates > Add New Template.
  2. In the Template dropdown, pick the default Support Tickets template you want to override (for example, “Support Ticket - New Ticket (Customer)”).
  3. Click Load Template to populate the editor with the shipped version.
  4. Edit subject and body, then save under a recognizable name.
  5. Return to Stores > Configuration > OrangeCollar > Support Tickets > Email Templates and select your custom template from the dropdown for that event.

Finally, flush the config cache:

TERMINAL
$ bin/magento cache:flush config

Because the shipped templates use standard Magento variable syntax ({{var ticket_subject}}, etc.), your custom template can use any of the variables listed above for that template.

How-to: customizing a support ticket email template, 1:03

Sender identity

The Email Sender setting controls which Magento email identity (General Contact, Sales Representative, Customer Support, etc.) is used as the From address for every outgoing notification. Configure identities under Stores > Configuration > General > Store Email Addresses and then pick one in the Support Tickets config.

Troubleshooting delivery

CAUTION /

No admin emails arriving. Confirm Admin Notification Email is set. A blank value means admin notifications have no recipient and are silently skipped. Also confirm Enable Support Tickets is set to Yes; when it is No, no ticket emails are sent at all.

NOTE /
  • Emails sending to the wrong address. Sender identity is per store view. On multi-store installations, override the sender per store view under the scope switcher on the configuration page.
  • Template changes not appearing. Flush the config cache (bin/magento cache:flush config) after changing the template selection.
  • Magento email queue. Support Tickets uses the standard Magento transport, so if your Magento instance queues email (via system/smtp/ or a third-party module), ticket emails are queued alongside everything else.

See also

Related pages

In this module