Outgoing Email

Note that the steps for selecting the Office 365 Application for outgoing email are for Issuetrak version 15.5 and above. If you are running a version older than 15.5 this option will not be present.

To activate your system's outgoing email capabilities, including system-generated email notifications and user-initiated messages from the email issue and email article links:

Steps:

  1. Click the gear icon in the upper right > click on Outgoing Email beneath Email.
  2. Select Use Outgoing Email beneath Outgoing Email Settings.
  3. Under Outgoing Mail Server Configuration, choose the type of email service you will use from the "Connection Type" dropdown menu.
    1. If you choose Google Application, then you must have configured Issuetrak to communicate with Google's API framework. Once you've done that, make the appropriate selection from the Application dropdown menu that appears afterward. Skip to step 7 afterward.
    2. If you choose Office 365 Application, then you must have configured Issuetrak to communicate with Office 365. Once you've done that, make the appropriate selection from the Application dropdown menu that appears afterward. Skip to step 7 afterward.
    3. If you will be using SMTP to send outgoing email, then Custom from the dropdown menu. Afterwards, proceed to step 4.
  4. Enter the name of the SMTP server sending your site's email as the Email Server. You can use a DNS name such as smtp.mycompany.com or an IP address.

If you are an Issuetrak Cloud customer, please see our article about the configuration options that are available to you for email delivery.

  1. If your server is configured for TLS Encryption, check the box Use TLS Encryption and modify the port setting if necessary. The default TLS port is 587.
  2. If authentication is required for the mail server you specified, select the Use Authentication checkbox to display the Username and Password fields and enter the required information.
  3. Enter an email address for the Email Sender Address (e.g. "service@examplesite.com"). This value will be the default From / Reply To address for all system-generated emails. Unless the User is selected in step 10, this will also be the default From/Reply To address for all user-initiated emails.

For best results, configure Incoming Email (IEM) to ensure any replies will be automatically added as notes to related issues.

  1. Enter a name/title for the Email Sender Name (e.g. “Your Service Team”). This value will be the default of the From / Reply To name in emails sent from the system.
     
  2. To test the mail server information provided, click the Test Mail Server button. A new window will appear and allow you to enter an email address to receive a test email via the server information provided.

    If the test is successful, a green message will appear below the To Address field that states Connection Successful. If the test is unsuccessful, a red message will appear with details to assist in resolving the connection issue. If you cannot achieve a successful connection after correcting the specified settings, please contact our Support Team for assistance at 757-213-1351, support@issuetrak.com, or the Support Site.
  1. Under Outgoing Email Settings, select a Return Email Address Default for user-initiated emails.
    • The System will default to the "Email Sender" and "Email Sender Name" defined for a system-generated email in steps 7 and 8.
    • The User will default to the email address and name of the user initiating the email.
  2. To format outgoing messages using HTML, select Use HTML Format for Outgoing Email.
  3. To override the built-in default that excludes Subscribers from notification of events they themselves initiate, select Email to Initiator.

Email to Initiator is not normally recommended. The assumption behind this built-in default is initiators know the event occurred and often find its notification redundant. With the option checked, whoever performs an action (add note, assign, etc) will get an email confirmation of that action.

For example:
         - If a submitter adds a note to an issue, they will not be sent notification that this note was added to the issue.
         - If a user assigns an issue to themselves, they will not be sent notification that this issue was assigned to them.

  1. To send email notifications to Subscribers with On Note selected when issue Substatuses change, select Send Email on Substatus Change.

The Substatus option must be activated from the Optional Fields screen for this setting to work. You can access that page by clicking the gear icon in the upper right > click on Optional Fields under System.

  1. To include a Suppress Email Notifications option on the View and Edit Issues screens, select Allow Suppression of Email Notifications for Issues. To display this option to Agents only (which we strongly recommend), select Only Allow for Agents.
  2. Select the order to display notes within email notifications.
    • Ascending Order will display oldest to newest.
    • Descending Order will display newest to oldest.
  3. Choose whether to enable Profile Change Notifications. This feature will send an email notification to the affected user (if it has a valid email address) when changes are made to their user account. To enable this feature, check the box next to Enable Notifications.
  4. Click Update.

A confirmation message will appear when this process is complete.


 

Viewing the Outgoing Email Log

A list of all email messages sent by the system within the last seven days is available within the Outgoing Email Log. You can access that log using the steps below.

Steps:

  1. Click on the gear icon in the upper right.
  2. Click on Outgoing Email beneath Email.
  3. Click View Log on the right quick menu.

From here, you may select a Search On option, enter a search value, and click Search to filter/search the list. The list will re-populate with messages matching the criteria.

You may use the Previous and Next buttons to page through the list. Clicking on a column heading will sort the list by the column’s values. View Body links will allow you to view the content of a message in a separate window.