This document and guide will assist you in configuring Email Integration within Naverisk. Email integration allows you to link correspondence to associated support tickets.
​

IMPORTANT NOTES: We strongly recommend a separate POP mailbox solely for this purpose. Naverisk Version 2022R2 or higher does support Microsoft 365 OAuth connectivity. (See Section Connection 365 accounts)

When saving your integration please hit Save twice to confirm the changes synchronize. Failure to save twice may leave integration unusable

To set up Email to Ticket Parsing, Create a dedicated POP mailbox to receive emails. Naverisk will frequently check the mailbox and turn any emails in that mailbox to Naverisk Tickets.
Using Email Rules, Naverisk can interpret these emails and automatically assign them an SLA Class, and SLA Status.
​
​Please note:- The mailbox should be clean of mail as it will pull in all mail when it connects.

PLEASE NOTE: If your outbound connection is to an external SMTP Server for relay,

and the 'SSL SMTP' option above is required, then add the appropriate encrypted port

number to the SMTP Gateway - eg: <myencryptedsmtpserver.net:587>

Image is from pre 2022R2

Image is post 2022R2

The first 10 fields are used to configure the collector that Naverisk will be checking for tickets.

The Default SLA Class, Default SLA Status and Default Ticket Source are mandatory fields used to populate ticket attributes on the generated Naverisk ticket.

Many mail providers now use MFA\2FA authentication for secure email. If MFA\2FA is required then Naverisk can still connect to your account via an App Password

This is a secure, auto-generated password for the email account.

Please Note:- That from June 30th 2022 Google require you to use 2FA and an App Password by default. Please see attached guides.

To configure an Application Password, please refer to the Microsoft and Google guides below. Note that while an Application Password can be used for multiple applications, we strongly recommend creating a unique Application Password for Naverisk.

Microsoft office 365/Exchange Online/Azure
​Google

Once you have created the Application Password, enter this password into the Password field in the Naverisk Mail Integration Rule setup.
​Important: Do not use your mail account password

IMPORTANT:- If you are a Cloud Customer please skip to section 3.1

Before proceeding please remove any previous integrations. You may also need to be Global Admin in Azure to “Consent on behalf of the company” this to approve the app registration.
​

The first step is you must create an app registration in your azure portal.

2. Give the registration a name and then choose your account type.

Nb if you choose single tenant you will need add the below line to your config file asper section 5.
​

<add key="MicrosoftIdentityProvider_TenantId" value=""/>

The value is the directory tenant ID value. See below image

​

3. Click on Authentication and choose Web

4. Add the URL of your website and save

The URL should look like below, with your Naverisk web address at the beginning and /Webservices/AuthenticationIntegration.asmx/AuthenticationRedirect after.

5. Go to Certificates & Secrets and add a client secret. Choose the expiry date of the secret. Once done save

Important make sure you keep note of the listed keys you will need to add these to the config file. The generated value called "Value" will be used as the "MicrosoftIdentityProvider_ClientSecret" in the next step.

Edit the config in

C:\Program Files (x86)\Naverisk\SiteController\NaveriskSiteController.exe.config

adding the below keys into the <AppSettings> section.
​

Make sure to update them with the ClientID (from Office365 Overview -> Application (client) ID) and ClientSecret that you generated above (the generated value called "Value"):

Once the keys have been added and saved, you will need to restart your NaveriskSiteController service for them to take effect.

Note: If you need to find Client ID this is in the Overview tab as per the image below

see Application (client) ID

If you need to find your Secret ID this can be found in the Certificates and Secrets tab as per the image below.

2. Choose Microsoft 365 from the drop down menu as above and then enter the details as required.

Please note, The Default SLA Class, Default SLA Status, and Default Ticket Source are mandatory fields used to populate ticket attributes on the generated Naverisk ticket.

Click on connect and you will be prompted to enter your 365 email address

Enter your password and if prompted your MFA authorization.

Once completed your account will show in the email address such as below, and you can then save the integration

Please Note: if you get an error or something like the below then you need to go to your account in 365 and activate the secondary authentication before proceeding.

Make sure to press Save button on the New Email Integration Rule pop up window AND ON THE MIDDLE of the Email Integration page as well.

IMPORTANT:- If you are a Cloud Customer please skip to section 3.2.2

3.2.1 The first step is to configure your account within google.

Here is a quick link to the Google Console

https://console.cloud.google.com/

Please use the guide below to help create the account.
​https://support.google.com/cloud/answer/6158849?hl=en#zippy=%2Cuser-consent%2Cpublic-and-internal-applications

3.2.2 Once you have created your google account, within Naverisk, choose Google from the dropdown menu as shown below and then enter the details as required.

Click on connect and you will be prompted to enter your google email address

Enter your password and if prompted your MFA authorization.

Once completed your account will show in the email address, and you can then save the integration.
​

If the certificate has been allowed to expire, then this process should help you reset your connection after you have renewed the certificate in Azure:

Below is the email to ticket route followed by the Naverisk integration (Naverisk 2023 R1 onwards):

Naverisk can send Alerts to dedicated persons, teams or distribution groups. Enter their email address in the textbox for Alert Recipients.

This will only need to be set up for sub Clients and not the Parent Client. This allows emails that are sent in by these sub Clients to be automatically mapped to the correct Client when creating a Ticket.
The format for this will be the email domain without the ’@’ symbol.

In the response email template enter SupportEmailAcknowledge.template to have a non-Client-specific acknowledgement email sent out upon logging of a support ticket.
​

We have also included a couple of alternate template designs. For some variation please try the new templates: SupportAcknowledgeExample1.template or SupportAcknowledgeExample2.template

The Response Email Address does not have to be the address of an existing mailbox. If an address is specified in this field then the acknowledgement email will appear to originate from this address.

To test the Email Integration, send a test email to any email addresses that have been configured for Naverisk to monitor.
If these mailboxes are working correctly and the Email Integration is working, a Ticket will be logged in the Naverisk Console matching the test email.

In addition to setting up Email Integration, set up Naverisk so that support requests from a Client’s domain create support tickets which are automatically associated with that Client. To do this, follow the steps below:

3. When tickets are logged from email address belonging to these domains they will be associated with the correct Client in the Naverisk Tickets Tab.

Alerts for Email Integration are handled differently than Alerts raised automatically by Agent Monitoring. 

To have Notifications sent to a specific email account or distribution group when a Support Ticket is logged via email, just populate the ‘Alert Recipients’ field with the email address that notifications should send to.
If there are a number of recipients for this Notification, then the use of a Distribution Group is recommended. Note that this is for alerting engineers, not for alerting a Client.

In the example above, there are two fields labelled ‘Response Email Template’ and ‘Response Email Address’. These are used to define the Email Template sent out to Clients and what address that email will originate from. 

The Email Templates are located on the Naverisk Site Controller within the folder ‘C:\Program Files (x86)\naverisk\SiteController\EmailTemplates’ by default and can be edited to match your business requirements.

The following example uses a customized template and illustrates what End Users can expect to see as a result:

This is what End Users would see after submitting a Support Ticket by email:

When receiving emails from your customers that generate support tickets, each email that is bridged will also include the signature in most cases. Naverisk has implemented a feature where you can cut off an email at a certain point, for example, the signature in emails. This ensures that a ticket only includes the most relevant information and not the noise from signatures.

To implement this feature, navigate to the Settings tab > Clients & Licensing and take note of the Email cut-off at:

We have this configured to use the beginning of our support email footers and cut off anything else in the email from there.

This means that the signature and anything that follows are not included in the ticket when the email is bridged.

For example, this is what the email looks like when it's about to be sent through Outlook:

The below image is what the Ticket Note will look like in your Naverisk portal when it has been bridged and has the email cut-off functionality configured:

Using the Default Waterline text as per the below screenshot:

This will cut off everything in the email from the generated line in every email. An example of the Waterline Text is included below:

Users can email directly from Tickets. Edit Ticket and select the Activity tab and click Public Reply.

This opens the email editor (HTML). From 2022R2, by default, email recipients of the last email sent or received will be populated in the TOs and CCs fields as public replies.
Additional recipients can be added by clicking on the + icon on the right. You can also type email addresses directly into the address field. The editor supports formatted (HTML) email including fonts, colour, tables and hyperlinks.

The Canned Text button allows pre-defined email text to be inserted.
​
The History button inserts ticket history entries.
​
The Files button is used to attach documents or files to the email, or to insert images inline into the email text.

An explanation of the To and From field (where they are derived from) follows.

To: This is populated based on the Client and Contact Person associated with the Support Ticket.

From: This is populated based on the User assigned to the Ticket. But is customizable.

Note: To set a default From address to be used regardless of User assigned to the Ticket, edit the Response Email Address for your Parent Client under Settings > Email Integration.

Things you need to know about customizing your Templates.

There are different ways to use templates You can use the prebuilt ones or follow the steps below to build your own.

Below is the IncidentNew.template as an example for configuration:

The following are the relevant Fields that can be included in the Template: Incidents Template 

Below are the parameters that you can use in you Template, these can be used in the Subject Line of the Alert which will be used in the first line on the Template, or they can be used for the body of the Email Template.

For some example ideas on how you could set up your templates, we have preloaded the system with some examples. Please refer to SupportAcknowledgeExample1.template and SupportAcknowledgeExample2.template

Naverisk has the ability to send HTML coded templates for delivery.

For our Onsite customers, this will require a Site Controller Parameter to be set to enable this functionality: <add key="EmailEncoding" value="HTML"/>

​For more information on this change, please refer to the Site Controller Parameters Guide in the Naverisk Help.

The first line is used as the subject of the email, the rest of the template consists of the HTML content and will be shown as the Body of the email.

These HTML templates need to be saved with a .html.template extension.

As some email clients may have difficulty with receiving HTML, Naverisk recommends that you also create an accompanying plain text version using the standard .template extension, for Naverisk to fall back on and send in case the HTML version is not accepted by the recipient email client.

When assigning an HTML template as a Response Email Template, the .HTML is not required as the correct template with be automatically used by the system.

For some example ideas on how you could configure your HTML templates, we have preloaded the system with some basic examples utilising simple to modify HTML code. For your reference please check out SupportAcknowledgeExample1.html.template and SupportAcknowledgeExample2.html.template.

Please remember that when assigning a HTML template as a Response Email Template, the .HTML is not required as the correct template with be automatically used by the system, so you only need to enter SupportAcknowledgeExample1.template

Under Settings > Email Templates you have the ability to upload text or html based content to send out on your alerting emails

To upload a customized template file, please use the ‘Add’ feature on the right of the template you wish to change:

This will provide you with familiar file selection box to select the template file:

And when successfully uploading, you will see the Custom Template Name as populated with the file name:

Keep in mind that just like most of the Naverisk systems, all settings are Client-specific and can be set differently for different clients based on their varying requirements.

So, we will need to ‘Share’ this template with the sub-clients, if we want it to apply to their tickets too.

This can be accomplished by clicking the green Edit Icon:

And ticking the 'Share Custom Template with Sub-Clients" option:

Additionally, you can also make changes to the template directly using this ‘Edit’ option, and by selecting the ‘Template’ tab:

From this screen, you can modify the Subject Line of the email alert that will be sent, and the email's main body will be presented for you to reword and customize.

Once you are satisfied with the form and have saved the changes, you can forcibly generate an email to test its appearance. This uses the ‘Send Test Email’ button found in the top right:

Select the email you wish to generate, the Client you wish to generate it against, and the email address you wish to send the test through to:

Please note, that the Tests emails are not generated from a Ticket. Ticket parameters mentioned in section 2.5.1, will not be populated in this test ticket:

Naverisk will create an alert when it is unable to get an email from your specified email integration server. See the image below. This will be a notification for each ticket.

In Naverisk Settings you can add a sending service for your email

Note:- This is for Onsite Configurations Only

You can send mail to a variety of services including 365.

If you are using 365 you can relay through an account. We recommended an account that is dedicated to your email correspondence such as helpdesk@Itsupport.com and it must have a minimum of a basic 365 license if you are not using MFA. This is so you can activate SMTP Authentication (see the below images under MFA settings)

Here is an example of the 365 settings to enter,
​
PLEASE NOTE THE SERVER ADDRESS.

smtp-legacy.office365.com (This doesn't use TLS but SSL)

helpdesk@Itsupport.com
App Password for that account

SSL switched on

IMPORTANT

Please Note and important the account can have MFA enabled but you will need to get an app Password. This will require a minimum of a Business Standard Account
​
​Microsoft 365
For 365 click on the below link
​https://mysignins.microsoft.com/security-info

Go to security info and add assign in the method being an App Password and follow the next prompts. An app Password will be automatically created for you. Use this as the password within Naverisk.

Important: The below setting must be switched on in the mailbox settings within the user on 365 otherwise it will not authenticate,

Gmail Account
​
For Google app password creation please use the link below for instructions.

Google App Password

If you are using one of the Naverisk Cloud servers to spoof emails to your domains, you will need to add an entry to your SPF record. We use filtering for security. The record to add to your own SPF record is as below.
​
This will allow your domain to be authenticated on our servers. If you do not do this your email will be marked as spam or may not even be delivered.

This may happen if using Office 365 as the POP Service. If the body of an email is not displayed or showing in the Naverisk Tickets, try disabling TNEF for that Office 365 mailbox.

How to disable TNEF;

$Session = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri https://ps.outlook.com/powershell/ -Credential $LiveCred -Authentication Basic –AllowRedirection

Import-PSSession $Session

Set-RemoteDomain Default -TNEFEnabled $false