Alerts to Customers: Difference between revisions

From RangerMSP Wiki - PSA software for MSPs and IT services providers
Jump to navigation Jump to search
No edit summary
No edit summary
 
(16 intermediate revisions by 3 users not shown)
Line 1: Line 1:
=Page Status: in Beta (Work in Progress)=
__TOC__
<br>
=Introduction=
=Introduction=
Starting with RangerMSP 5.3, [[Alerts Server|RangerMSP Alerts Server]] provides the option to send email alerts to customers.
<br><br>
The Alerts to Customers feature sends automatic email alerts to customers when:
The Alerts to Customers feature sends automatic email alerts to customers when:
* A new ticket is created  
* A new ticket is created  
* A ticket is closed  
* A ticket is closed  
* Ticket status is changed (starting with RangerMSP 11)


<br>
<br>
Alerts  are sent via the [[Alerts Server|Commit Alerts Server]], to all [[Ticket_Management#Ticket_Recipients|External Recipients]] defined for the Ticket.
Alerts  are sent via the [[Alerts Server|RangerMSP Alerts Server]], to all [[Ticket_Management#Ticket_Recipients|External Recipients]] defined for the Ticket in the '''Email Recipients tab'''.
External Recipients are defined per Ticket and contain the email addresses of the parties that should be notified whenever there is email correspondence concerning the Ticket. The email addresses may belong to existing Accounts in the database, or they can be email addresses that do not currently exist in an Account. See more details in [[Ticket_Management#Ticket_Recipients|Ticket Recipients]].
External Recipients are defined per Ticket and contain the email addresses of the parties that should be notified whenever there is email correspondence concerning the Ticket. The email addresses may belong to existing Accounts in the database, or they can be email addresses that do not currently exist in an Account. See more details in [[Ticket_Management#Ticket_Recipients|Ticket Recipients]].


New Ticket Alerts are sent when a new Ticket is created for the Account by an employee or via Commit API. See more details in [[#New Ticket Alerts Special Cases|New Ticket Alerts Special Cases]].
New Ticket Alerts are sent when a new Ticket is created for the Account by an employee or via RangerMSP API. See more details in [[#New Ticket Alerts Special Cases|New Ticket Alerts Special Cases]].
 
Ticket Status change Alerts are sent when the Ticket enters one of the selected status.


Closed Ticket Alerts are sent whenever a Ticket is closed, i.e. the Ticket Status changes to Completed.
Closed Ticket Alerts are sent whenever a Ticket is closed, i.e. the Ticket Status changes to Completed.
Line 20: Line 22:
The system comes with default alert templates which can be found in Settings > Email Templates.
The system comes with default alert templates which can be found in Settings > Email Templates.
<br>The default template for new Tickets is: "Ticket – Alerts to Customers – New Ticket".
<br>The default template for new Tickets is: "Ticket – Alerts to Customers – New Ticket".
<br>The default template for Closed Tickets is: "Ticket – Alerts to Customers –Ticket Closed".
<br>The default template for Closed Tickets is: "Ticket - Alerts to Customers - Ticket Status Change".
<br>The default template for Ticket Status Changes is: "Ticket – Alerts to Customers –Ticket Closed".


<br>
<br>
Line 36: Line 39:


=New Ticket Alerts Special Cases=
=New Ticket Alerts Special Cases=
New Ticket Alerts are sent when a new Ticket is created for the Account by an employee or via Commit API.  
New Ticket Alerts are sent when a new Ticket is created for the Account by an employee or via RangerMSP API.  


New Tickets will not trigger an email alert to the customer when:
New Tickets will not trigger an email alert to the customer when:
# You manually change a Ticket's status to New. <br>''Note: Only when a new Ticket is actually created in the database an alert is sent.''<br>
# You manually change a Ticket's status to New. <br>''Note: Only when a new Ticket is actually created in the database an alert is sent.''<br>
# Tickets are created by customers via Commit Email Connector's Email-to-Ticket feature. <br>''Note: In this case the customer will be notified about the new Ticket by the automatic-response sent by Commit Email Connector if enabled. See more details in [[Email_Connector|Commit Email Connector]].''<br>
# Tickets are created by customers via RangerMSP Email Connector's Email-to-Ticket feature. <br>''Note: In this case the customer will be notified about the new Ticket by the automatic-response sent by RangerMSP Email Connector if enabled. See more details in [[Email_Connector|RangerMSP Email Connector]].''<br>
# Tickets are created via Commit Email Connector using automated emails (i.e. formatted emails which are usually sent by external applications) do not trigger an email alert to the customer. See more details about automated emails in [[Email_Connector#Automated_Emails|Automated Emails]].<br>
# Tickets are created via RangerMSP Email Connector using automated emails (i.e. formatted emails which are usually sent by external applications) do not trigger an email alert to the customer. See more details about automated emails in [[Email_Connector#Automated_Emails|Automated Emails]].<br>
# Tickets are created by customers via Commit Web Interface.
# Tickets are created by customers via RangerMSP Web Interface.


<br>
<br>
=Alerts to Customers Settings=
=Alerts to Customers Settings=
IEnabling Alerts to Customers requires [[Alerts Server|Commit Alerts Server]] activation. See more details in Commit Alerts Server.
Enabling Alerts to Customers requires [[Alerts Server|RangerMSP Alerts Server]] activation. See more details in [[Alerts Server|RangerMSP Alerts Server]].


Once Commit Alerts Server is activated, the Alerts to Customers settings should be enabled and configured from Tools > Options > Alerts to Customers.
Once RangerMSP Alerts Server is activated, the Alerts to Customers settings should be enabled and configured in the Alerts to Customers options window from Tools > Options > Alerts to Customers:
<br><br>
<br><br>
[[File:Alerts_to_customers_options.png]]
[[File:Alerts_to_customers_options.png]]
Line 54: Line 57:
The Alerts to Customers settings are defined globally and require Sys Admin privileges.
The Alerts to Customers settings are defined globally and require Sys Admin privileges.


The settings include:
The Alerts to Customers settings include:
<br><br>
<br><br>
'''OFF''' – choosing this option disables all alerts to customers triggered by the events of new Tickets and closed Tickets.  
'''OFF''' – choosing OFF disables all alerts to customers triggered by the events of new Tickets and closed Tickets.  
<br><br>
<br><br>
'''ON''' – choosing this option will enable the Alerts to Customers feature within Commit Alerts Server.
'''ON''' – choosing ON enables the Alerts to Customers feature within RangerMSP Alerts Server.


In this section, administrators can choose which events trigger alerts and which email template will be used for the alerts. Separate templates can be used for new tickets and for closed tickets. The email alerts templates can only be based on plain-text templates.
When enabled, the following options are available:
#'''Alerts About New Tickets''' - Choosing this option will trigger alerts for new Tickets being created in the database.
## '''Use Email Template''' - Choose the Ticket Email Template which will be used when sending email alerts for new tickets.
##  '''Attach PDF Report''' - When sending the email alerts, you can attach a predefined PDF Ticket Report, which will be created automatically and attached to the email to the customer. The report format can be selected from any Ticket report (predefined or, customized). Read more about customizing reports in the [[Report_Designer_User_Guide|Report Designer User Guide]].
# '''Alert about Ticket Status changes''' - Choosing this option will trigger alerts for Ticket Status being changed.
## '''Use Email Template''' - Choose the Ticket Email Template which will be used when sending email alerts for Ticket Status being changed.
##  '''Attach PDF Report''' - When sending the email alerts, you can attach a predefined PDF Ticket Report, which will be created automatically and attached to the email to the customer. The report format can be selected from any Ticket report (predefined or, customized). Read more about customizing reports in the [[Report_Designer_User_Guide|Report Designer User Guide]].
## '''Alert when the Status becomes''' - Select the exact Ticket statuses you want customers to receive an email alert for.
#'''Alerts About Tickets Being Closed''' - Choosing this option will trigger alerts for Tickets being closed.
## '''Use Email Template''' - Choose the Ticket Email Template which will be used when sending email alerts for tickets being closed.  
## '''Attach PDF Report''' - When sending the email alerts, you can attach a predefined PDF Ticket Report, which will be created automatically and attached to the email to the customer. The report format can be selected from any Ticket report (predefined or, customized). Read more about customizing reports in the [[Report_Designer_User_Guide|Report Designer User Guide]].
#'''Web Links''' - Web Links allow your customers to quickly open the customers' Web portal and view or edit the Ticket details. This saves the need to go explicitly to the Web Interface site, login and search for the Ticket in order to see its details.
## '''Add Web Links to Email Alerts for accounts with Active Web Users''' - Choosing this options will automatically add links to the Ticket (via RangerMSP Web Interface) to the email alert's body. The Web Link should be included in the email template selected above in order for it to work. <br> ''Note that Web Links feature requires using RangerMSP Web Interface for Customers.''


It is also possible to attach a predefined PDF Ticket Report, which will be created automatically and attached to the email upon sending the email alert to the customer. The report format can be selected from predefined reports, or, from your own customized reports. To learn more on how to design your own layouts [[Report_Designer_User_Guide|click here]].
<br>
[[File:Alerts_ticket_template_web_links.png]]
<br><br>
<br><br>
'''Web Links'''
Even when this option is enabled, Web Links will be added only when sending email alerts to Accounts that have active Web Users. The Web Links will be added to all Ticket Recipients, regardless of the Contact selected for the Ticket.
Web Links allow your customers to quickly open the customers' Web portal and view or edit the Ticket details. This saves the need to go explicitly to the Web Interface site, login and search for the Ticket in order to see its details.


The Web Links feature requires using Commit Web Interface for Customers.
Note: This option requires enabling Web Links from Tools > Options > Web Interface. See more details in [[Web_Interface#Setting_Web_Links_Options|Setting Web Links Options]].


When using Web Links the system automatically adds links to the email alert body. The Web Link should be part of the email template and links will only be added when the email template includes a reference to add links.  
<br>
 
==RMM Settings==
The direct integration RangerMSP has with RMM systems means that Tickets are automatically created in RangerMSP based on reports from these RMM systems.
 
By default the system will not alert your customers by email about RMM Tickets that are automatically generated. You can control whether customers will be automatically alerted about the creation, closure or status change of such integrated RMM Tickets.


<br>
To configure the RangerMSP Alert Server to send alerts to customers when new RMM tickets are opened, closed or their status changes, click the RMM Settings button in the options window.
[[File:Alerts_ticket_template_web_links.png]]
 
<br><br>
The following window opens:
Even when this option is enabled, Web Links will be added only when sending email alerts to Accounts that have active Web Users
 
[[File:Alerts_to_customers_rmm_options.png]]
 
Choose the Alerts you want to send to customers, and save your changes. Restart the RangerMSP RMM Service in order for the changes to take immediate effect.
 
=Disable Alerts To Selected Accounts=
In some cases, users may want to disable the automatic email alerts for specific customers.


Note: This option requires enabling Web Links from Tools > Options > Web Interface.
To control the Alerts to Customers settings per Account:
# Open the Accounts Window.
# Navigate to the specific Account and from Accounts > Email Alerts menu select between:
#* Stop Alerting This Account about New Tickets
#* Stop Alerting This Account about Tickets Status changes.
#* Stop Alerting This Account about Tickets being Closed.
# Change will take effect immediately in RangerMSP Server service.


<br>
[[File:Disable_alert_to_customer.gif]]


=See Also=
=See Also=
* [[Alerts Server|Commit Alerts Server]]
* [[Alerts Server|RangerMSP Alerts Server]]
* [[Ticket Management|Ticket Management]]
* [[Ticket Management|Ticket Management]]
* [[Web Interface|Commit Web Interface]]
* [[Web Interface|RangerMSP Web Interface]]
 
[[Category:Setup]]
[[Category:Installation]]
[[Category:User Manuals]]

Latest revision as of 07:47, 8 July 2020

Introduction

Starting with RangerMSP 5.3, RangerMSP Alerts Server provides the option to send email alerts to customers.

The Alerts to Customers feature sends automatic email alerts to customers when:

  • A new ticket is created
  • A ticket is closed
  • Ticket status is changed (starting with RangerMSP 11)


Alerts are sent via the RangerMSP Alerts Server, to all External Recipients defined for the Ticket in the Email Recipients tab. External Recipients are defined per Ticket and contain the email addresses of the parties that should be notified whenever there is email correspondence concerning the Ticket. The email addresses may belong to existing Accounts in the database, or they can be email addresses that do not currently exist in an Account. See more details in Ticket Recipients.

New Ticket Alerts are sent when a new Ticket is created for the Account by an employee or via RangerMSP API. See more details in New Ticket Alerts Special Cases.

Ticket Status change Alerts are sent when the Ticket enters one of the selected status.

Closed Ticket Alerts are sent whenever a Ticket is closed, i.e. the Ticket Status changes to Completed.

Alerts Format

The Alerts to Customers email format is defined using textual Ticket Email Templates, which allow users to design the Alert email format. The system comes with default alert templates which can be found in Settings > Email Templates.
The default template for new Tickets is: "Ticket – Alerts to Customers – New Ticket".
The default template for Closed Tickets is: "Ticket - Alerts to Customers - Ticket Status Change".
The default template for Ticket Status Changes is: "Ticket – Alerts to Customers –Ticket Closed".



Additional templates can be used for alerts by selecting them for the Alerts via Options > Alerts to Customers tab.

To switch the template for an Alert:

  1. From the Tools > Options menu
  2. In the Alerts to Customers tab
  3. Choose the template for the alerts

See more details in Alerts to Customers Settings.

New Ticket Alerts Special Cases

New Ticket Alerts are sent when a new Ticket is created for the Account by an employee or via RangerMSP API.

New Tickets will not trigger an email alert to the customer when:

  1. You manually change a Ticket's status to New.
    Note: Only when a new Ticket is actually created in the database an alert is sent.
  2. Tickets are created by customers via RangerMSP Email Connector's Email-to-Ticket feature.
    Note: In this case the customer will be notified about the new Ticket by the automatic-response sent by RangerMSP Email Connector if enabled. See more details in RangerMSP Email Connector.
  3. Tickets are created via RangerMSP Email Connector using automated emails (i.e. formatted emails which are usually sent by external applications) do not trigger an email alert to the customer. See more details about automated emails in Automated Emails.
  4. Tickets are created by customers via RangerMSP Web Interface.


Alerts to Customers Settings

Enabling Alerts to Customers requires RangerMSP Alerts Server activation. See more details in RangerMSP Alerts Server.

Once RangerMSP Alerts Server is activated, the Alerts to Customers settings should be enabled and configured in the Alerts to Customers options window from Tools > Options > Alerts to Customers:



The Alerts to Customers settings are defined globally and require Sys Admin privileges.

The Alerts to Customers settings include:

OFF – choosing OFF disables all alerts to customers triggered by the events of new Tickets and closed Tickets.

ON – choosing ON enables the Alerts to Customers feature within RangerMSP Alerts Server.

When enabled, the following options are available:

  1. Alerts About New Tickets - Choosing this option will trigger alerts for new Tickets being created in the database.
    1. Use Email Template - Choose the Ticket Email Template which will be used when sending email alerts for new tickets.
    2. Attach PDF Report - When sending the email alerts, you can attach a predefined PDF Ticket Report, which will be created automatically and attached to the email to the customer. The report format can be selected from any Ticket report (predefined or, customized). Read more about customizing reports in the Report Designer User Guide.
  2. Alert about Ticket Status changes - Choosing this option will trigger alerts for Ticket Status being changed.
    1. Use Email Template - Choose the Ticket Email Template which will be used when sending email alerts for Ticket Status being changed.
    2. Attach PDF Report - When sending the email alerts, you can attach a predefined PDF Ticket Report, which will be created automatically and attached to the email to the customer. The report format can be selected from any Ticket report (predefined or, customized). Read more about customizing reports in the Report Designer User Guide.
    3. Alert when the Status becomes - Select the exact Ticket statuses you want customers to receive an email alert for.
  3. Alerts About Tickets Being Closed - Choosing this option will trigger alerts for Tickets being closed.
    1. Use Email Template - Choose the Ticket Email Template which will be used when sending email alerts for tickets being closed.
    2. Attach PDF Report - When sending the email alerts, you can attach a predefined PDF Ticket Report, which will be created automatically and attached to the email to the customer. The report format can be selected from any Ticket report (predefined or, customized). Read more about customizing reports in the Report Designer User Guide.
  4. Web Links - Web Links allow your customers to quickly open the customers' Web portal and view or edit the Ticket details. This saves the need to go explicitly to the Web Interface site, login and search for the Ticket in order to see its details.
    1. Add Web Links to Email Alerts for accounts with Active Web Users - Choosing this options will automatically add links to the Ticket (via RangerMSP Web Interface) to the email alert's body. The Web Link should be included in the email template selected above in order for it to work.
      Note that Web Links feature requires using RangerMSP Web Interface for Customers.




Even when this option is enabled, Web Links will be added only when sending email alerts to Accounts that have active Web Users. The Web Links will be added to all Ticket Recipients, regardless of the Contact selected for the Ticket.

Note: This option requires enabling Web Links from Tools > Options > Web Interface. See more details in Setting Web Links Options.


RMM Settings

The direct integration RangerMSP has with RMM systems means that Tickets are automatically created in RangerMSP based on reports from these RMM systems.

By default the system will not alert your customers by email about RMM Tickets that are automatically generated. You can control whether customers will be automatically alerted about the creation, closure or status change of such integrated RMM Tickets.

To configure the RangerMSP Alert Server to send alerts to customers when new RMM tickets are opened, closed or their status changes, click the RMM Settings button in the options window.

The following window opens:

Choose the Alerts you want to send to customers, and save your changes. Restart the RangerMSP RMM Service in order for the changes to take immediate effect.

Disable Alerts To Selected Accounts

In some cases, users may want to disable the automatic email alerts for specific customers.

To control the Alerts to Customers settings per Account:

  1. Open the Accounts Window.
  2. Navigate to the specific Account and from Accounts > Email Alerts menu select between:
    • Stop Alerting This Account about New Tickets
    • Stop Alerting This Account about Tickets Status changes.
    • Stop Alerting This Account about Tickets being Closed.
  3. Change will take effect immediately in RangerMSP Server service.

See Also