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 MoEngage's unsubscribe page URL as the email footer - “If you'd like to unsubscribe and stop receiving these emails click here”.
• By default, MoEngage redirects your customers to a standard landing page. The only option available there is to re-subscribe. If you want to navigate your customer to a custom landing page e.g. to capture the reason for their unsubscription etc, they can put a link to their own landing page in Unsubscribe Page URL. 
• Depending on the Data Center your dashboard is configured, input the unsubscribe URL for the Unsubscribe Page.

  Unsubscribe URL	Data Center
  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
  https://api-04.moengage.com/v1/emailresubscribe	Datacenter 4

  
  

  

  • Selecting None means MoEngage will not include unsubscribe links in your email campaigns. You are now responsible for including an unsubscribe link while creating the email content. If you don't do it in promotional campaigns, the chances of being identified as spam are high.

Configure List Unsubscribe Email

Under List unsubscribe email,

• If you select MoEngage Managed option, MoEngage will include its own mail-to and https URL  in email's headers, in all non-transactional emails.
• If you select Self Managed option, enter the One-click unsubscribe URL and List unsubscribe email, so that MoEngage will include this in your mail-to and https URL in emails' headers, in all non-transactional emails.
  

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 Dashboard > Settings > Sender Configuration > Amazon SES > Bounces & Complaint Tracking (Callback URL)

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

Amazon SES passes along both Hard Bounce and Soft Bounce information to MoEngage. This is available as part of the Email events in MoEngage: Email Bounced and Email Soft Bounced. 

Refer to this document to see the different Bounce Types and Sub Types from Amazon SES. 

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.

Note: All the email events - Bounces, Complaints, and Delivered - will be tracked uniquely for every user at the MoEngage User ID level.