Mail Scanner

Configuring and Using the Mail Scanner

The Mail Scanner function can be used to create trouble tickets to CRM from the received emails of a certain email account. With scanner conditions and actions it is possible to identify the emails that should be scanned and perform the right actions to create the tickets. When the scanner is up and running, it is also possible to reply to the customer’s ticket and have the reply to be sent as an email reply.

Creating a New Scanner

The mail scanners can be managed on Settings → Mail Scanner.

By default, there are no scanners in the system. A new scanner can be added by clicking the Add Mail Scanner button. The new scanner requires the following information (see also the picture below):

  • Name – This is shown only internally in the CRM and does not affect the operation of the scanner.
  • Active
  • Host – The server name of the email account. This depends on the email provider you are using and might require some internet searching. (The host (IMAP) for Outlook 365 is usually outlook.office365.com and for Gmail it is imap.gmail.com).
  • Type – The protocol which is used to access the email – IMAP is recommended.
  • Encryption – SSL or TSL encryption.
  • Certificate validation – It is recommended to switch this on.
  • Scan type – The selection for which emails are scanned, only the unread or all the emails since the last scan.
  • Username and password – The email address and password for the email account used.

When the information for the scanner has been filled clicking the Save button will create the scanner. The scanner is not operational right away, since it needs to be activated separately. It is recommended to determine the conditions and actions before the activation.

Setting Up Conditions and Actions

When a new mail scanner has been created, it can be run, activated, edited and deleted with the buttons in the Actions column (see the picture below). There are two buttons for editing the scanner: with the Edit button you can access and edit the information determined, when the scanner was first created (see the section above). By clicking the Rules button you can determine conditions and actions for the scanning.

A new condition is created by clicking first the Rules button and then Add scanner rule. You will first need to give the condition a name and set it active. Next you’ll need to select the appropriate email account’s folders, whose emails will be dealt with according to the condition(s) (see the picture below). Finally the actual condition(s) is(/are) created by clicking the Add rule button and determining an email field, operator and value. The conditions can be grouped and ordered the same way as the conditions in the report generator and they can be either in AND or OR relations with each other.

The rule should also include one or more actions. The actions are performed in the order they are added. You can add a new action by clicking the Add action button and selecting a suitable action from the following:

  • Create contact if not exists – The scanner checks whether the sender of the email is already as a contact in CRM, and if not, it creates them. If the action “Create or update ticket” is performed after this, the contact is then linked to the trouble ticket.
  • Create or update ticket – Creates a new trouble ticket or updates an existing one with the same subject field. This action requires some configuring: by clicking the Edit button (see the picture below), you can activate the fields that are updated when the ticket is created/updated (see further below). The regex field can be left untouched in most cases.

  • Move to folder – Moves the email(s) to wanted folder. The name of the folder must be determined in the field that appears next to the picklist.
  • Delete message – Deletes the email(s).

The picture below demonstrates a configuration made for a “Create or update ticket” action – all the tickets created will have an ‘Open’ status and a certain assignee. The Account and Contact name fields do not need to be activated, since the scanner automatically identifies a contact by their email address and links both the contact and their account to the ticket.

After the conditions and actions have been determined, remember to Save them. The scanner can now be activated and run for the first time.

Replying to Tickets by Email

Since the trouble tickets are received by email, it is also thoughtful to reply to the customer by email. With the mail scanner, it is possible not only to transform the email to a ticket, but also comment on it in the CRM and have the comment sent to the customer as an email. When the customer replies to the comment in the email, the reply will also be added as a comment on the ticket.

To enable the conversation flow between the CRM and email, you’ll first need to set up the email template, which is used in the emails. This is done in Settings → E-mail Templates by editing the Change Comments template (see the picture below).

The picture below shows an example of a template, that is ready to be used with the ticket comments. To send the ticket to the contact, check Contact Email in the field Send to.

It is also important to use certain tags to ensure that the emails are processed correctly. In the Subject field there must be a tag for the ticket number ($helpdesk-ticket_no$), so that the scanner can match the reply with the right ticket. To show the ticket comments in the email, there must be a tag for the comments ($helpdesk-comments$) on Message body. It is also recommended to use the tag $helpdesk-replyabove$ in the first row of the message – this way only the text that the contact writes above the tag will be transformed to a comment when the contact replies.

Another setting that must be done is determining the email address and sender name that are shown as the sender to the customer. These are determined in Settings → Additional Settings in the section SMTP settings (see the picture below).

NB! The email address must be the same address that receives the original emails (tickets) from the customers!

Product Based Commission
Percent Steps Based Commission
Volume-Based Provision
Project Settings
Automatic Emails
Contact Portal: Settings and Actions
Combined Shape