Email Incoming & Parsing Rules

<< Click to Display Table of Contents >>

Navigation:  Configuration > Admin Config >

Email Incoming & Parsing Rules

Overview

There is a possibility to setup action triggers via email message events. We can setup an incoming email parsing rules to process incoming emails and perform an action upon satisfying one of the defined rules. Firstly, we must setup an email message account connection via POP3 or IMAP protocol. Secondly, we must define one or more rules to execute actions.

 

Email Incoming Setup page

email_incoming

1.Protocol selection

2.Email server

3.Username, typically it's an email address

4.Password for the email address

5.Port of the protocol selected

6.Authentication selection

7.SSL enabled

8.Wait period between mailbox parsing jobs, this period should be large enough to let each cycle to complete it's process before the next cycle starts, because otherwise, the cycles will overlap and this may lead to multiple action jobs triggered for one email event. The mailbox used should be dedicated to EMS email parsed events, because if it is a general mailbox, then there can be a lot of emails not related to generating action triggers and since each job cycle has to look through all the emails in the mailbox, this would cause huge processing delays, especially overtime, since more and more emails will appear in the mailbox as the time passes. In general, the waiting period should be at least 20-40 seconds. If the waiting period is set to 0, then the mailbox parsing jobs will not be executed.

9.Delete emails that have been processed, this is good practice to prevent mailbox parsing jobs to check already processed emails

10.Save the modified form parameters by using the ‘Save’ button. Use the ‘Test’ button to verify the connection; please wait for some time to receive a popup response window, email servers may take some time to generate a response message

 

 

Email Incoming Rules page

email_incoming_rules

1.Which email the message should come from

2.Enable email message subject filter

3.Subject entry field Contains or Equals to the email message subject, i.e.: Subject Action = 'Contains', Subject entry field = 'Test' and email message subject = 'Testing email', 'Test' is contained within 'Testing email' and thus this rule is satisfied for the subject line. Another example, Subject Action = Equals', Subject entry field = 'Test' and email message subject = 'Testing email', 'Test' is not equal to 'Testing email' and thus this rule is not satisfied for the subject line

4.Subject entry field

5.Enable email message body filter

6.Body entry field Contains or Equals to the email message body, works in the same way as the Subject Action

7.Body entry field

8.Enable rule

9.Action to execute upon satisfying all the conditions for the rule. Actions are defined in Device Action page and should not contain special replacement tags contained within <% %>, because they will not be converted to actual values since these actions are simply executed and not attached to any Device or Wireless Device