Page Comparison

Mail Handlers process downloaded (fetched) emails from the inboxes configured in Mail Accounts. Every Mail Handler is linked to a Mail Account and defines the actions that should be executed when an incoming email is processed.

It is important to know a little background information how these Mail Handlers work:

1. First, Catch email Accept email is checked. By default, this step is skipped (disabled). This can be used to filter messages in a mailbox if it has multiple email addresses (like mail aliases). By default, all messages are passed through, regardless of the recipient addresses.
   1. If Catch Accept email is set to Equals if any recipient equals to any of the following addresses then  then email is processed if To/CC/BCC address equals to any of the specified email addresses
   2. If Catch Accept email is set to Matches if any recipient matches any of the following regexpsregular expressions then email is processed if To/CC/BCC address matches to any of the specified regular expressions
2. Secondly, they to find the user on behalf the actions will be executed, using the From address in the email.:
   1. If the user is found, then it will be used as Reporter for creating issues, the Author for adding comments, the user who executes transitions, etc...
   2. If the user is not found and Default reporter is set in the Mail Handler, then the Default Reporter will be used
   3. If the user is not found and Default reporter is not set, then execution is aborted
3. Thirdly, various filters are applied to accept for or reject the incoming message from further proccessing. More details can be found on the Filters page.
4. As a next step, the mail handler tries to find to the corresponding issue
   1. It extracts parts from the mail Subject that look like an issue key.
   2. It checks if there is an issue with the extracted issue key
   3. If issue does not exist, then it continues with next extracted part from the Subject that look like an issue key
   . The applied strategy is detailed on the Issue lookups page.
5. Finally, actions are processed, as discussed on the Mail Handler Actions page:
   1. If an issue was found, it will be remembered and actions like Add comment, Execute transition, Send auto reply, etc... can use this issue
   2. If issue was not found, then the first action that is executed should be a Create Issue action. 

Mail Handler configuration dialog has two four tabs. On the first tab, general parameters can be configured (the details about the other tabs can be found on the respective sub-pages).

Image RemovedImage Added

Important settings

• Set the linked account from the available Mail Accounts
• Set the Default reporter to any valid user as a fallback, when the user can not be determined by the From address. By default, there is no fallback user and processing will be aborted if no user can be found by the From addressSet Catch email to configure the email addresses or regular expressions that should match with the To/CC/BCC address. By default, it is disabled
• If it is set to Equals to any of the following addresses, then emails will be processed only if the To/CC/BCC address of the email equals to any of the specified email addresses.
  For example, if you have a mailbox support@example.com with aliases support@example.net and support@example.org and you want to process only emails sent to example.net or example.org (not example.com), then add two lines in the appearing text area:
  support@example.net
  support@example.org
If it is set to Matches any of the following regexps, then emails will be processed only if the To
• /CC/BCC address of the email matches with any of the specified regular expressions.
  For example, if you have a mailbox with addresses info1@example.com, info2@example.com, support1@example.com, support2@example.com and want to process email that are sent to addresses starting with support, then add this line in the appearing text area (note that dot is escaped before .com):
  support(*.)@example\.comIf fallback to default reporter  is set, then Email This Issue retries executing the action with the selected default reporter if the execution with the current reporter fails due to permission error.

After general settings are configured, switch to the second 4th tab (Rules and actions) to set up the mail handler actions that should executed during processing the incoming mail.