Introduction

Amazon Simple Email Service (SES) is a cost-effective, flexible, and scalable email service that enables developers to send mail from within any application. You can configure Amazon SES quickly to support several email use cases, including transactional, marketing, or mass email communications.

Integration

Configure Email connector 

You can create an Amazon Web Services account at http://aws.amazon.com/. After account creation, go to AWS Console -> SES and verify your domain by adding the specified TXT Records in your domain's DNS settings.

Your new Amazon SES account might be a sandbox account. In that case, you need to request for a production account from Amazon SES without which your SMTP settings will not be configured. More details are mentioned here. Your request can also cite a limit increase for Daily Sending Quota and Maximum Sending Rate. Amazon usually takes 4 hours to confirm access to production account. 

Bounces & Complaints in SES are tracked through Amazon SNS which is described in detail later in this article.

Configure SMTP settings

You can find the SMTP connector configurations in your AWS Account -> SES -> SMTP Settings

• SMTP Host name, Port and Protocol type can be filled from the above details. Avoid using port 25 as it has a higher rate of emails getting throttled. 
• SMTP Username and Password can be obtained by clicking on the button "Create My SMTP Credentials". Since, there is limited generation of SMTP credentials, you need to mandatorily save the credentials in your records. Read more about generating credentials here.
• Maximum send rate is mentioned in "Sending Statistics" tab

 

Configure Unsubscribes

• "MoEngage Tracking" will add your unsubscribe page url as the email footer - “If you'd like to unsubscribe and stop receiving these emails click here”.

  • Depending on the Data Center your dashboard was configured in please input the call back URL for Unsubscribe Page URL

     https://api-01.moengage.com/v1/emailresubscribe - Datacenter 1

    https://api-02.moengage.com/v1/emailresubscribe - Datacenter 2

    https://api-03.moengage.com/v1/emailresubscribe - Datacenter 3

• Selecting "None" for promotional email campaigns will lead to higher chances of being classified as spam.

Configure Bounce and Complaints

This tracking is implemented through Amazon SNS notifications which is also described in detail as follows:

Once your domain is verified on SES, select the domain name and click on "Edit Configuration" button under Notifications. You can then create a new SNS topic, select this topic for Bounces and Complaints under SNS Topic Configuration and click on "Save Config".
Next step is to go to AWS Console -> SNS -> Topics and click on the recently created topic

Now, copy the url from Moengage App Settings -> Email Settings -> Connector Configurations -> Amazon SES -> Callback URL 

Go back to SNS Topic Details, click on "Create Subscription" and paste the url in Endpoint as shown below in the snapshot

Configure Delivery Tracking

Delivery tracking is implemented through Amazon SNS notifications . The steps to configure it are described below:

Once your domain is verified on SES, select the domain name and click on "Edit Configuration" button under Notifications. 

1. Create a new SNS topic and select this topic for Delivery Tracking under the SNS Topic Configuration as shown below.
2. Click on "Save Config".
3. Navigate to the AWS Console -> SNS -> Topics and click on the recently created topic.
4. Click on Create Subscription and fill in the following details in the screen that pops up.
   
   • Topic: This field is autopopulated with the details of the Topic for which the Subscription is being created.
   • Protocol: HTTPS
   • Endpoint: Copy the endpoint url from Moengage App Settings -> Email Settings -> Connector Configurations -> Amazon SES -> Callback URL as shown below.
5. Copy the url from Moengage App Settings -> Email Settings -> Connector Configurations -> Amazon SES -> Callback URL as shown below:
6.  Uncheck the ‘Enable raw message delivery’ checkbox.
7. Click on Create Subscription. You should be able to see this subscription under the Subscriptions menu as shown below.
8. If the status is Pending confirmation after some time (1-2 hours), select the subscription and click on Request confirmation.
   

The Delivery Tracking settings should now be set up.

You are all set up with connector configurations. You can now click on "Save" button which will test these settings (including credentials etc.) and save them. You can then select Amazon SES as the default connector in General Settings.