Managing AWS SES (Simple Email Service)

This tool is used to capture email bounces and automatically mark them as bad addresses.

Terms

Transient Email Failures 

Are emails that cannot be delivered because of non-permanent problems. These may be temporary issues like "out of the office", or problems with a particular email like "cannot accept email from this address".

Permanent Email Failures 

Are emails that cannot be delivered for reasons that will not recover, like "user does not exist"

Email Bounce List 

A database table found in the Email Bounce Process Collection that includes an entry for every bounce email detected.

AWS SES 

Amazon Web Services - Simple Email Service.

AWS SQS 

Amazon Web Services - Simple Query Service, a persistent messaging tool.

AWS SNS 

Amazon Web Services - Simple notification Service, a push notification tool.

Email Blocked List 

An internal list of email addresses that have permanent bounces or a request to stop emails to the address was sent.

Roles

Administrator 

A user with the Administrator checkbox set in their user record, under permissions. Administrators can review the email drop list.

How To

How to Approve a FROM address on Amazon AWS SES

Send an email to support@contensive.com that contains each email address or the whole domain.

How to setup Amazon SES Email

1. Go to aws.amazon.com and sign in to the console.
2. Select SES.
3. Select Email Addresses under Identity Management.
4. Enter an email address to verify and click on VERIFY A NEW EMAIL ADDRESS.

IMPORTANT NOTE ABOUT FROM ADDRESSES

If your email is managed on an AMAZON SES server, you must make sure that all email addresses used in the FROM field are verified before you send a group or system email using them.

To verify your from addresses, you will login to your AWS account if you have your own, or contact support@contensive.com if Contensive manages your email server.

1. Go to aws.amazon.com
   
2. Login with user name and password for the account
   
3. Click on SES under APPLICATION SERVICES section
   
4. Click EMAIL ADDRESSES from the menu on the left
   
5. Click VERIFY A NEW EMAIL ADDRESS button at the top of the page
   
6. Enter the email address and click VERIFY THIS EMAIL ADDRESS
   
7. The email address will be listed as PENDING VERIFICATION until an email sent to that address is received and the link in the email is clicked
   
8. The email address will be listed as VERIFIED after someone clicks the link in the email sent to that address
   

How to setup Amazon SES Email Bounce Processing

1. You must have first configured SES Email
2. Click on Amazon SNS (Notifications) on the Amazon AWS Dashboard. Create a topic.
3. Click on Amazon SQS (Message Queues). Add a message queue. Subscribe the queue to the the SNS topic. Get the URL in the details tab and save in the "AWS SQS Bounce Email Queue Endpoint" in the Email Bounce Settings.
4. Go to Amazon (SES) and assign the sending Domain and/or email addresses to the SNS topic.
5. Go to Amazon Identity & Access Management and create a new user for the email block process. Under permissions, add a policy for "AmazonSQSFullAccess". Under Security, create an access key. Save the "AWS Access Key Id" and the "AWS Secret Access Key" in the Email Bounce Settings.
6. in Email Bounce Settings, check the box next to "Allow AWS Email Bounce Processing".
7. To test the configuration, send to the following AXS SEs email addresses from the system.
   • success@simulator.amazonses.com
   • bounce@simulator.amazonses.com
   • ooto@simulator.amazonses.com
   • complaint@simulator.amazonses.com
   • suppressionlist@simulator.amazonses.com

How to Manage Bounce Processing on the Website

1. Periodically review the list at Manage Add-ons, Email Bounce Processing, Email Bounce List.
2. If in the Details the bounce is marked as Transient, after you make any necessary changes to recover it, you can delete this record from the list to enable emails to this email address.
3. If in the Details the bounce is marked as Permanent, the email address will be added to the Email Blocked Report. See Blocked Emails

How to Manage Blocked Emails on the Website

1. To view the Email Blocked Report, click Reports, Email Blocked Report.
2. To have an email removed from this list, please contact support@contensive.com to provide the list of emails you would like removed from the blocked list.

References

Email Bounce Settings

Under Navigator > Settings > Email Bounce Settings

Allow AWS Email Bounce Processing 

(For Amazon AWS hosted sites only, requires Amazon SES Email) Use Amazon Notifications to automatically block bad email addresses from your database. When enabled, the site will check with Amazon AWS hourly and if bad email addresses where detected, the user's Allow Group Email will be disabled and the email address will be added to the site's blocked list.

AWS Transient Email Grace Period 

The period of time up to 30 days that email addresses with transient issues will be allowed. You must periodically review the transient email issues in the Email Block List. Transient issues older than this period will be blocked from receiving email.

AWS Access Key Id 

The access key associated with the identity you will use to communicate with the AWS Message system to retrieve bounce and complaint notifications. Use the AWS Identity and Access Management to create you credentials.

AWS Secret Access Key 

The secret access key associated with the identity you will use to communicate with the AWS Message system to retrieve bounce and complaint notifications. Use the AWS Identity and Access Management to create you credentials.

AWS SQS Bounce Email Queue Endpoint 

The URL for the AWS Message Queue you configured to store the bounce messages.

Under Navigator > Settings > Preferences > Email Tab

Change History

10/28/2016 

This build adds the AWS SES email handling, required if you send SES email. Instead of reading addresses from a pop3 account, it receives messages from the Amazon SQS message queue and marks records appropriately.