Community Knowledge Base

Email

SmarterTrack is a help desk and ticketing system, it is not a mail server. As such, it doesn't have the ability to receive email messages like a mail server, nor can it send ticket responses via email. Instead, SmarterTrack uses existing email accounts and pulls the messages from those accounts in, and then turns them into tickets. Similarly, when a reply is sent, SmarterTrack uses the same email account and sends the response through an external mail server. In this way, SmarterTrack acts more like an email client like Microsoft Outlook: it pulls messages from a mail server, and then sends messages back out through the same mail server, just like en email client.

This section, then, is where administrators set up the POP and SMTP accounts that are used by each department for pulling messages into the system that are converted into tickets (via POP), then sending out replies to those tickets (via SMTP). There are some other, email-server-like features that can be implemented such as auto-clean rules, black lists for withholding automated system emails, encoding, and more.

The Email area is also used for customizing any system messages as needed, like those sent to customers when a ticket is automatically closed, for password recovery, and more. These system messages are pre-written and, by default, many contain some variables for things like ticket numbers, usernames, links to community posts, and more. However, each of these pre-defined messages can be edited as needed.

To access this section, log into the management interface with an administrator account. Select Settings from the Navigator, then click on Email in the navigation pane. The email settings will load in the content pane and the following tabs will be available:

Options

Use this tab to edit the following settings:

  • Default Encoding - To specify the encoding format, select the appropriate option from the list. By default, this is set to Unicode (UTF-8) and is the recommended setting. However, if messages come in from mail servers in different countries who rely on different encoding (e.g., Cyrillic), this setting can be adjusted accordingly.
  • Delivery Delay - To specify the number of seconds automated messages from the system are delayed, type the appropriate number in this field. Setting a delivery delay can keep the connection between your help desk and your mail server running smoothly. By default, the delivery delay is 10 seconds.
  • Delete Failed Emails After - The number of days after which undelivered emails are deleted. By default, failed emails are deleted after 30 days. Note: Emails that cannot be delivered are stored in the App_Data/Spool/Failed folder. For more information, see Spool.
  • Delete Raw Content After - To specify the values at which raw content should be deleted, type the appropriate number in the fields for days, files, and MB.
    • Day(s) - The number of days after which files are purged from the system. By default, raw content is purged after 30 days.
    • File(s) - The maximum number of files that will be kept before the files are purged from the system. By default, the maximum number of files is 25,000. Note: SmarterTools recommends keeping this option at the default setting or lower.
    • MB - The maximum amount of space available for raw content storage. If this amount of space is exceeded, the files are purged from the system. By default, the maximum amount of space is 10,000 MB.
  • Automated Email Blacklist - Any email address or domain you add to this text box will be excluded from receiving any departmental auto-responders or any automated emails sent by SmarterTrack. This includes emails like ticket received notifications, surveys, emails generated from events, etc. Addresses/domains should be entered one per line.
  • Filter duplicate incoming emails - Checking this box can prevent SmarterTrack from receiving a large influx of new tickets due to auto-responder loops.
  • Remove redundant embedded replies in emails - Checking this box will truncate emails by removing redundant embedded replies. For example, sometimes replies from users can contain multiple copies of previous conversations between that user and the agent. Checking this box removes most, if not all, of that "redundant" content to keep replies shorter, and easier to read and follow.

SMTP

SmarterTrack does not utilize an internal SMTP server to send email messages. Therefore, an external SMTP account must be configured to send ticket responses and system notifications. Accounts configured in this section can be chosen in the Brand and Department settings so that the address(es) can be used for sending system notifications (the brand's SMTP account) or for ticket replies sent from various departments. To add a new SMTP account, click Add in the content pane toolbar. To edit an existing account, select it and click Edit in the content pane toolbar, or double-click the row. A modal window will display the following options:

  • Authentication - SmarterTrack utilizes two forms of email authentication when adding accounts: standard username/password authentication or Microsoft's OAuth2. For any non-Microsoft email service, standard username/password authentication should suffice. However, when using any Microsoft Exchange online service, like Office365/Microsoft365 or Hotmail, you must use Microsoft OAuth2 authentication. (See info below.)
  • Server - The outgoing SMTP server name.
  • Email Address - The email address from which messages are sent.
  • Display Name - The name used to identify the mail server. This field is optional but recommended.
  • Encryption - Select the level of security used for sending emails: None, SSL, or TLS.
  • Server Port - The port used to connect to the SMTP Server. By default, the SMTP Server port is 25. Note: If SSL or TLS is used, this port will need to change to match the security setting.
  • SMTP Auth Username - The identifier used to authenticate with the SMTP server. This field is optional.
  • SMTP Auth Password - The corresponding password used to authenticate with the SMTP server. This field is optional.
  • Ignore SSL warnings - Select this to ignore any warnings present if there are issues with the encryption method chosen.
  • Make this the default account - Select this to make the account added the default account for the brand.

POP

POP accounts can be used to import tickets from email. To add a POP account, click Add in the content pane toolbar. To edit an existing account, select it and click Edit in the content pane toolbar, or double-click the row. (NOTE: By default, any messages pulled into SmarterTrack via POP are deleted from the mail server. To change this behavior, the "Leave Messages on Server" option MUST be checked.) A modal window will display the following options:

  • Authentication - SmarterTrack utilizes two forms of email authentication when adding accounts: standard username/password authentication or Microsoft's OAuth2. For any non-Microsoft email service, standard username/password authentication should suffice. However, when using any Microsoft Exchange online service, like Office365/Microsoft365 or Hotmail, you must use Microsoft OAuth2 authentication. (See info below.)
  • Server - The outgoing POP server name on which the email account resides.
  • Email Address - The full email address associated with the POP account. Some mail servers offer the ability for the Username to be different than the actual email address, or don't allow the full address as the Username. To ensure the proper account is used for POP importing, both the Username and Email Address need to be added when setting up a POP account.
  • Encryption - Select the level of security used for receiving emails: None, SSL, or TLS.
  • Server Port - The port used to connect to the POP server. By default, the POP server port is 110. Note: If SSL or TLS is used, this port will automatically change to the default port necessary to match the security setting.
  • Login Username -The identifier used to log into the POP server.
  • Login Password - The corresponding password used to log into the POP server.
  • Import Frequency - The interval, in minutes, that SmarterTrack checks the POP account for new messages. By default, the import frequency is 2 minutes.
  • Department - The department that will utilize the POP settings for ticket importing.
  • Able to Start Tickets - The role required to submit a ticket via email. For more information, see Roles.
  • Leave Messages on Server - By default, when you retrieve email through POP3, the emails are deleted from the mail server. Checking this will cause email messages retrieved via POP to stay on the mail server.
  • Ignore SSL warnings - Select this to ignore any warnings present if there are issues with the encryption method chosen.

Note: When importing emails, the department autoresponder will not be sent for emails more than 3 days old.

Use of Microsoft OAuth2 Authentication

In 2021, Microsoft started deprecating basic authentication when using their Exchange online services. As a result, SmarterTrack now offers Microsoft OAuth2 authentication for SMTP and POP connections. (NOTE: OAuth is not supported for SMTP Shared accounts.)

If you are using a Microsoft Exchange online account -- Office365, Hotmail, Live.com or MSN.com email addresses -- You WILL NEED TO USE OAUTH2 FOR AUTHENTICATION moving forward.

The process for using OAuth2 is not that much different than using the standard username/password authentication -- at least from the user's perspective. On the back end, however, it's much different, and much more secure.

  1. Select Microsoft OAuth2 for your authentication method.
    • SmarterTrack will pre-fill the server name. (NOTE: If using an msn.com email address, you will need to change the server name to smtp-mail.outlook.com/pop-mail.outlook.com but the encryption and ports can remain the same.)
  2. Next, hit the Connect button on the modal. A new window will open that will ask you to log in to your Microsoft account, and to select the type of account you're using. (I.e., Work/school or personal). Please understand that any Exchange online email account is also considered a Microsoft account, so you would log in with your Exchange online account and select whether it's a work/school account or a personal account. (If you're unsure, you will need to contact your IT administrator(s) or someone with knowledge of the type of account that was set up.) From there, you'll be logged in to the Microsoft platform and SmarterTrack will fill in your email address and default the Encryption and Port to those recommended by Microsoft.
  3. Select any other options by checking the boxes next to them.
  4. Hit the Save button.

That's pretty much all you have to do. Once the account has been added, you will have the ability to modify things like SSL/TLS encryption and port, if needed.

NOTE: There are some prerequisites to be aware of in Office365. We have a detailed walkthrough of setting up OAuth accounts (Standard and Shared) in our knowledgebase. See How to Setup O365 Accounts in SmarterTrack Using OAuth

Master Templates

Master Templates are used to control the outer HTML appearance of certain emails sent from SmarterTrack. For example, system emails, email Event Actions, and autoresponders all use a Master Template so that these messages are sent with the same layout and design. Each Brand hosted within SmarterMail can have its own Master Template that provides further branding and ensures customers are comfortable with the messages they receive.

NOTE: SmarterTrack offers a default Master Template that will be used by any message that is not, or can not be, assigned to a Brand. Therefore, this default template should be kept simple so as to not confuse customers if multiple Brands are used in SmarterTrack. Additional, more Brand-specific templates can be created, then assigned to the Brand when configuring the Brand's Options.

When creating a Master Template, the HTML tab is used to create/add custom HTML that forms the basis of the template. The Preview tab can be used to view what the HTML will render for outgoing emails. (It uses default text for rendering the body of the message.) Any Master Template that's created can use one or more of the Variables listed on the HTML tab, but ALL templates must include the [%BODY%] variable in order to function properly.

Templates

When certain actions occur within the system, SmarterTrack can send an email based on that action. For example, if a company wants to send a follow-up survey to a customer after a ticket resolution, the system will automatically send an email requesting the customer complete the survey. These system-generated emails are predefined and no new templates can be created. However, administrators can use this section to edit the template content. Each template is sent using the Brand SMTP settings. See below for more information on the available templates:

Auto-Close Ticket

This email is used when a department is set to automatically close tickets after a certain amount of time. The email notifies the customer that a particular ticket was closed, but that the ticket can be re-opened by simply replying to it. The following variables are available:

  • Ticket Number - The ticket number assigned to the closed ticket. [%TICKETNUMBER%]
  • Subject - The Subject of the closed ticket. [%SUBJECT%]
  • Date - The date the ticket was closed. [%DATE%]
  • Current Time - The time the ticket was automatically closed. [%TIME%]
  • Brand Name - Company name as defined in brand settings. [%COMPANY%]
  • Portal Url - The URL of the customer portal. [%PORTALURL%]

Community Activity Digest

This email is sent on a regular basis and is used to notify the customer of activity on Community threads they are subscribed to. The following variables are available:

  • Activity Summary List - A summary list of all Community activity that the user is subscribed to [%COMMUNITYACTIVITYLIST%]
  • Date - The date (on the server) the activity happened. [%DATE%]
  • Current Time - The time (on the server) the activity happened. [%TIME%]
  • Brand Name - Company name as defined in brand settings. [%COMPANY%]
  • Portal Url - The URL of the customer portal. [%PORTALURL%]

Community Conversation Notification

This email is used to notify a customer that a message was sent to them from another Portal user. The following variables are available:

  • Username - The username of the person sending the message. [%USERFROM%]
  • Comment - The text/comment that was sent. [%MESSAGETEXT%]
  • URL - A link to the user's profile. [%PROFILEURL%]
  • Date - The date (on the server) the activity happened. [%DATE%]
  • Current Time - The time (on the server) the activity happened. [%TIME%]
  • Brand Name - Company name as defined in brand settings. [%COMPANY%]
  • Portal Url - The URL of the customer portal. [%PORTALURL%]

Community Post Moved Notification

This email is used to notify a customer that a post they created was moved to a new Thread. The following variables are available:

  • New Subject - The new post subject, if it was changed. [%NEWSUBJECT%]
  • Subject - The post's original subject. [%OLDSUBJECT%]
  • Post - The full text of the original post. [%POSTTEXT%]
  • Username - The username of the person creating the post. [%USERNAME%]
  • URL - A link to the user's profile. [%PROFILEURL%]
  • Date - The date (on the server) the activity happened. [%DATE%]
  • Current Time - The time (on the server) the activity happened. [%TIME%]
  • Brand Name - Company name as defined in brand settings. [%COMPANY%]
  • Portal Url - The URL of the customer portal. [%PORTALURL%]

Email Rejected Due to Lock

This template is used to notify a customer that the ticket they are replying to has been closed and locked and offers a way to initiate a new ticket. The following variables are available:

  • Subject - The subject of the email that came in. [%SUBJECT%]
  • Email Address - The email address of the original sender. [%EMAIL%]
  • Ticket Number - The ticket number assigned to the rejected ticket. [%TICKETNUMBER%]
  • Date - The current date (on the server). [%DATE%]
  • Current Time - The current time (on the server). [%TIME%]
  • Brand Name - Company name as defined in brand settings. [%COMPANY%]
  • Portal Url - The URL of the customer portal. [%PORTALURL%]

Email Rejected Due to New Ticket Requirements

This template is used to notify a customer that they don't meet the department's required role for starting a ticket. For example, a billing department may require users to be Registered Users of SmarterTrack, but they are attempting to submit the ticket anonymously. For more information, see Roles. The following variables are available:

  • Subject - The subject of the email that came in. [%SUBJECT%]
  • Email Address - The email address of the original sender. [%EMAIL%]
  • Date - The current date (on the server). [%DATE%]
  • Current Time - The current time (on the server). [%TIME%]
  • Brand Name - Company name as defined in brand settings. [%COMPANY%]
  • Portal Url - The URL of the customer portal. [%PORTALURL%]

Email Rejected Due to Policy

This template is used to notify a customer that the department they're trying to contact does not accept tickets via email. This email will be sent when a POP account is not enabled for the department. Instead, tickets need to be created via the Web portal. For more information, see Email. The following variables are available:

  • Subject - The subject of the email that came in. [%SUBJECT%]
  • Email Address - The email address of the original sender. [%EMAIL%]
  • Date - The current date (on the server). [%DATE%]
  • Current Time - The current time (on the server). [%TIME%]
  • Brand Name - Company name as defined in brand settings. [%COMPANY%]
  • Portal Url - The URL of the customer portal. [%PORTALURL%]

Forgot Login

This template is used to send the password to the registered email account on file when a user forgets his/her login information and they click on the "Forgot Login?" link on the Web portal. The following variables are available:

  • Base URL - The full URL to the portal. [%SITEURL%]
  • Username - The username of the account requesting the password reset. [%USERNAME%]
  • Password - The password of the account (required). [%PASSWORD%]
  • Change Password URL - The URL the user clicks on that will allow them to reset their password. [%CHANGEPASSWORDURL%]
  • Date - The current date (on the server). [%DATE%]
  • Current Time - The current time (on the server). [%TIME%]
  • Brand Name - Company name as defined in brand settings. [%COMPANY%]
  • Portal Url - The URL of the customer portal. [%PORTALURL%]

Survey

This template is used to offer a survey to a customer after their ticket is resolved. The following variable is available:

  • Ticket Number - The ticket number the customer will use as a reference for the survey. [%TICKETNUMBER%]
  • Subject - The subject of the resolved ticket. [%TICKETSUBJECT%]
  • Survey Hyperlink - A link to the survey that the customer can click to go to the actual survey. [%SURVEYURL%]
  • Survey HREF - The text link set up for the survey. This is then used in place of the Survey Hyperlink to provide a friendly text string to click versus a long URL. [%SURVEYHREF%]
  • Customer Name - The customer's display name. [%CUSTOMERNAME%]
  • Customer Username - The username of the customer. [%CUSTOMERUSERNAME%]
  • Date - The current date (on the server). [%DATE%]
  • Current Time - The current time (on the server). [%TIME%]
  • Brand Name - Company name as defined in brand settings. [%COMPANY%]
  • Portal Url - The URL of the customer portal. [%PORTALURL%]

Ticket List

This template is used when a customer requests an emailed list of all previous tickets. The following variable is available:

  • All Tickets - All Tickets that belong to user. [%TICKETLIST%]
  • Email Address - The email address associated to the tickets. [%EMAIL%]
  • Date - The current date (on the server). [%DATE%]
  • Current Time - The current time (on the server). [%TIME%]
  • Brand Name - Company name as defined in brand settings. [%COMPANY%]
  • Portal Url - The URL of the customer portal. [%PORTALURL%]

Verify Email Address

This template is used to confirm a new user's email address. The following variables are available:

  • Username - The username on the account, [%USERNAME%]
  • Full Name - The full name for the user signing up, [%FULLNAME%]
  • Email Address - The email address on the account, [%EMAIL%]
  • Link - The link they need to click on to verify the account (Required). [%LINK%]
  • URL - The full URL that needs to be clicked. [%URL%]
  • Date - The current date (on the server). [%DATE%]
  • Current Time - The current time (on the server). [%TIME%]
  • Brand Name - Company name as defined in brand settings. [%COMPANY%]
  • Portal Url - The URL of the customer portal. [%PORTALURL%]