Difference between revisions of "Service Desk/Outbound Email"

From Emersion
Jump to: navigation, search
(Testing the Event)
(page moved to confluence)
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE: Outbound Email for Service Desk}}
+
This page has [https://resources.emersion.com/display/EKB/Outbound+Email moved]
= Overview =
 
Service Desk Outbound Email is an optional extension to the Service Desk Module. It provides the ability for service providers to notify end users by email of a new note being entered against a ticket
 
 
 
This extension handles ''outbound'' email only. A different extension handles inbound email notifications for the Service Desk. If you would like more information on the Service Desk Outbound Email extension, please contact Emersion Sales.
 
 
 
Once the module is enabled for your service provider account, you will need to perform some configuration to get it up and running.
 
 
 
= Configuration =
 
This section describes how to configure Cumulus to allow the system to send automatic email updates to end users upon creating a new note against a service desk request.
 
 
 
== Prerequisites ==
 
Upon subscription to the module, Emersion will map the '''Notify Service Ticket Updated''' [[Events|system event type]] to your service provider account for each [[account profile]] you have.
 
 
 
You can then create [[SystemEvents/Templates|event templates]] for each account profile.
 
 
 
== Create the Event Template ==
 
Service providers will need to customise a new [[SystemEvents/Templates|email template]]. Once the template is ready, enable the event.
 
 
 
To begin creating and customising your template go to the following location(s):
 
 
 
* NAV: '''Events > Templates > Email'''; OR <br />
 
* NAV: '''Events > Templates > SMS'''
 
 
 
It is recommended to choose the ''Default Account Recipient''.
 
 
 
For the subject, we suggest starting with the ticket ID event variable to populate the subject line with the ticket ID. For example: <span style="text-decoration: underline;">Ticket %%serviceRequestId%% %%summary%% has been updated</span>.
 
 
 
[[File:Events outbound 001.png|800px|]]
 
 
 
== Enable the Event ==
 
Before you can use the event, it must be enabled. For more comprehensive help regarding events and event templates, click the links below.
 
 
 
= Testing the Event =
 
Once the event is enabled with a template configured, service providers can test it using the basic process below.
 
 
 
Most customers will at least one test customer (end user) account to aid in activitesd like trainign and troubleshooting. Other times, Emersion create a test customer under your service provider account for the purposes of support. If you have an exiting test account, use this for the testing of the event. If we have done this, it will most likely named "Emersion Test". If you do not have a test account, create one and give it any name you like. 
 
 
 
Then, before you create or update any tickets, first ensure that the Primary Contact's email address is set to an email address that you have access to, such as a personal email address, or an email mailbox you set up purely for testing. Either will work, as long as you can log into it and send/receive emails from it.
 
 
 
Once you have your mailbox and test customer ready, use the following procedure.
 
------
 
Test Procedure
 
------
 
* Create a [[Service_Desk/Create|new service desk ticket]] for this account.
 
* Save the ticket.
 
* Go back into the ticket and add a note.
 
* Fill out your note and change the status, as appropriate.
 
* Ensure you have the '''Customer visible?''' checkbox enabled.
 
* You will now see a new checkbox '''Send this response to the customer'''. <span style="text-decoration: underline; color: red;">This checkbox MUST be enabled for the event to send an email to the customer.
 
* Click '''Save'''
 
 
 
[[File:Events outbound 002.png]]
 
 
 
An email will be sent to the customer via our standard events system. You can monitor this via '''Events > Message Queue > Email Queue''' and filter on the account ID you are testing. The '''Notify Service Ticket Updated''' event type will appear in the results.
 
 
 
'''''!! Important !!''''' If the system is experience heavily load (such as at the start of the month when the majority of service providers are in the middle of a bill run), be aware could be several minutes before you see the email message.
 
 
 
If you do not see the email message within 30 minutes, review your set up carefully and re-test after making any configuration adjustments. If you need further assistance, raise a ticket with us and include the details of your test case. We will be pleased to assist.
 
 
 
= See Also =
 
* [[Events|Events]]
 
* [[SystemEvents/Templates|Creating Event Templates]]
 

Latest revision as of 17:55, 8 May 2018

This page has moved