Help files

Email Monitor Trigger

The Email Monitor Trigger periodically checks an email account and executes a Process when an email that satisfies the specified criteria arrives.

Email_Monitor_Trigger_Image_1.png

Custom Description

Add a custom description to the trigger which will be shown in the Triggers tab under "Description"

Check Email Every

In the trigger's configuration dialog you specify how often the trigger should check for new emails. The default value is every 5 minutes.

Email Account Settings

For WinAutomation to monitor the email messages on an email server (as also to retrieve and process them), it must be able to access the server through the IMAP protocol. For more information you may check the corresponding session at the Retrieve Emails action.

Therefore, in order set a Email Monitor Trigger, it is necessary that you enter the IMAP Server Connection properties, consisting of:

  • the IMAP Server property, where you enter the IMAP Server address (e.g. imap.gmail.com).

  • the Port, where you specify the communication port, with  the most commonly used Server Port for IMAP being 993. However some IMAP Servers may require to specify different Port in order to perform properly.

  • whether SSL should be enabled, so that communication with the client could be performed over a secure connection (as required by some email servers),

  • User Name, where you enter the username of the e-mail account you want to access

  • Password, where you enter your email account’s password

Check for Emails Where...

In the next group of fields, you need to specify the values of the email properties that will fire the trigger. Leaving all the fields of this group empty will cause the trigger to fire and the Process will be executed for every email that arrives into the mailbox.

In order to restrict the type emails that will fire the trigger you should enter specific values in the appropriate fields defining that you want to check:

  • all emails or only for unread  (Retrieve property field)

  • for emails that end up into a specific folder (Mailbox Folder is: property field)

  • for emails coming from a specific sender (“From” Field Contains: property field)

  • for emails being addressed to a specific recipient (“To” Field Contains: property field)

  • for emails that contains specific keywords in the subject (Subject Contains: property field)

  • for emails that contains specific keywords in the body (Body Contains: property field)

Of course you may enter your preferences for more than one of the above properties and combine trigger firing criteria.

On trigger failure retry every

Optionally set a time period after which the Trigger will attempt to resume monitoring after encountering an error.

Note that the Email Monitor Trigger will only check for the specified email types and not retrieve them from the email server (where they will consequently remain marked as “unread”).

So, if in the Process that is executed by the trigger you need to process the email(s) that caused the Process to run, you should use the Retrieve Emails and the Process Emails actions.