What are the reasons why techmail will filter an email message?
Environment:
Oracle B2C Service, techmail
Resolution:
There are various reasons why an incoming email message could be filtered by techmail. The Incoming Email Filter Details report (Public Reports > Service > Email Reports (ID 227)) can help you troubleshoot why certain emails are being filtered out or rejected. This report lists every email filtered out or rejected in the past twenty-four hours. All rejected emails are deleted, but you can setup a reject address for your mailbox(es) to receive a forwarded copy of the rejected emails per Answer ID 1976: Accessing discarded email messages .
Please see the various filtering methods techmail uses and the causes below to assist you in your troubleshooting. If you need assistance Ask Technical Support and provide the rejected email or its complete email header per Answer ID 4781: Collecting email headers or source for Oracle B2C Service Technical Support.
Returned email
Check to see if the mailbox is configured to delete returned messages. A hard bounce will also flag a contact's email as invalid. Refer to
Answer ID 2800: Bounced E-mail message handling for bounce information and
Answer ID 2603: Cannot send response due to invalid email address for implications of contact email being invalidated
Invalid Address
Occurs if sender's From or Reply-to address is longer than 80 characters or does not match a valid email format. Refer to Answer ID 6381: Email address limitation
Sender address
0 - Updating an incident by email is allowed from any email address based on reference number match only. IMPORTANT! SETTING THIS VALUE TO 0 MAY IMPACT SECURITY OR PRIVACY CONCERNS FOR YOUR SITE.
Header content
Check the mailbox configuration and the Discard Headers filter. If something contained within the message header matches an entry in the Discard Headers filter, the message will be filtered. Items should be return delimited. Refer to Answer ID 6492: Discard Filters on mailboxes
Subject content
Check the mailbox configuration and the Discard Subject filters. If something contained within the subject of the message matches an entry in the Discard Subjects filter, the message will be filtered. Items should be return delimited. Refer to Answer ID 6492: Discard Filters on mailboxes
Body content
Check the mailbox configuration and the Discard Body filters. If something contained within the body of the message matches an entry in the Discard Body filter, the message will be filtered. Items should be return delimited. Refer to Answer ID 6492: Discard Filters on mailboxes
Bulk precedence (or Bulk email priority)
This will occur when two conditions are met. The header of the message will have the Content-Type Precedence set to "Bulk", "Junk" or "List" AND the mailbox is configured to "Delete Bulk Messages." The issue can be resolved by either unchecking the "Delete Bulk Messages" box within the mailbox configuration, or have the customer work with their mail administrator to remove the "Bulk" precedence being set for their messages.
Auto-responder
This will occur based on the "Discard Automatic Responses" value set within the mailbox's configuration. This can be set to Off, Conservative, Moderate or Aggressive and the values are set in the corresponding configuration values. Note, there is a separate configuration value for the header and body portion of the message.
Moderate - EGW_AR_MODR_BODY_FLTR, EGW_AR_MODR_HEAD_FLTR
Aggressive - EGW_AR_AGGR_BODY_FLTR, EGW_AR_AGGR_HEAD_FLTR
This can also occur via the EGW_MAX_PER_ADDRESS configuration. The EGW_MAX_PER_ADDRESS setting specifies the maximum number of emails that will be accepted from an individual email address within the time period specified in the EGW_MAX_MSG_DURATION setting. This is used to identify and stop auto-responder email loops. Setting EGW_MAX_PER_ADDRESS to 0 disables the email loop detection. The default value is 23. Refer to Answer ID 10338: Configurations EGW_MAX_PER_ADDRESS and EGW_MAX_MSG_DURATION explained.
- If a contact is sending 25 emails to the same mailbox (mailbox_id 1) within 12 hours, only 23 incidents will be created and the last 2 messages will be discarded;
- If a contact is sending 33 emails to 3 different mailboxes (10 emails to mailbox_id 1, 11 emails to mailbox_id 2 and 12 emails to mailbox_id 3) 33 incidents will be created and no email will be discarded.
Duplicate email
A duplicate email will be filtered when any email having the same date within four hours, from email addresses (i.e., from the same sender), subject, body, file attachment size, file attachment name as an existing incident is found. This is controlled by the EGW_DISCARD_DUPLICATE_ENABLED configuration setting.
Examples:
- Two messages with the same from, subject, content, and file attachment. This should cause duplicate to be discarded.
- Two messages with the same from, subject, content, but for the file attachment, name them identically but be sure the sizes vary (easiest with text or word files, make one very long). This should not be considered a duplicate and should create two incidents in the system.
- Two messages with the same from, subject, content, and file attachment sent to two different mailboxes that exist within the same site. This should cause a duplicate to be discarded.
Customer disabled
Check the contact record and make sure the record is not Disabled. Check contacts.disabled field. If the contact is disabled, the message will be filtered.
Bad reply format
If EGW_REPLY_BETWEEN_ENABLED=1 AND mailbox configuration “Force Reply Between Lines" is enabled, then the message did not contain the content between the lines correctly and the message will be filtered.
-Reply strings match the message base for the interface
-There are no extraneous characters or HTML formatting being added
SLA required
Check to see if the customer's site requires an SLA be applied to a contact and/or organization in order to receive service. If so and the contact and/or organization does not have an SLA applied, the message will be filtered.
Account required
Check the EGW_AUTO_CONT_CREATE and EGW_AUTO_CONT_CREATE_MA configuration settings. If either of these are not enabled, and the contact record does not already exist, the message will be filtered.
Workflow rules
This is caused when an incident rule has specifically prevented the creation of the incident with the rule action of Do Not Create incident. Search for all rules with an action of Do Not Create incident.
S/MIME signature and S/MIME decryption
This is caused when the mailbox is configured for S/MIME and the message does not match the pre-loaded root certificates or certificates which have been added through the File Manager. Check the mailbox configuration settings related to S/MIME and/or the "Additional root certificates" directory in the File Manager. Refer to Answer ID 4853: "There was a problem with your S/MIME Signature Certificate" error message
Message MTA
Unsubscribe
When the email is a marketing unsubscribe email.
SSS response
If the email contains any tracking strings associated with a different Oracle B2C Service site the email will be filtered. All outgoing emails contain a tracking string and any replies or forwards of these emails being sent to a different site will be subject to filtering. The tracking string of the filtered email may be in the email header 'In-Reply-To' line or embedded within the email body. Refer to Answer ID 5331: Incident Update by Email for a description of these tracking strings.
