Amazon Simple Email Service (SES), a cloud-based email service provider, allows you to deliver high-volume email campaigns and manage incoming emails at scale.

📘

Important Update

The new Amazon SES configuration will use HTTP as the default protocol for integration, offering faster and more efficient performance compared to SMTP. If you are an existing customer with email campaigns running on SMTP, you can switch to HTTP by entering their Access Key ID, Secret Access Key, and Server Name (HTTP) on the Settings page of the CleverTap dashboard. For more information about this, refer to Migrate Existing Amazon SES Provider Setup to HTTP .

This is currently released in Private Beta.

Integrate Amazon SES with CleverTap

To integrate Amazon SES with CleverTap:

1. From the CleverTap dashboard, go to Settings and click Integrate Email.

2. Select Amazon SES as a provider.

   

3. Enter the endpoint in the Server Name field. To identify the endpoint, refer to Service API Endpoints.

4. Enter the Access Key ID and Secret Access Key. To obtain this:

   1. Select the user name in the navigation bar on your AWS dashboard.

   2. Select Security credentials from the list.

      

   3. Scroll down to the Access Key section under the AWS IAM credentials tab and click Create access key.

      

   4. Select Third-party service and click Next.

      

   5. Enter Description tag value and click Create access key. You can copy Access Key ID and Secret Access Key or download the .csv file.

      

5. Copy the Access Key ID and Secret Access Key from the newly created access key and paste them into the corresponding fields on the CleverTap dashboard.

6. Enter the From Address. You can enter your preferred email address from Verified email addresses listed under Configuration > Identities on the Amazon SES dashboard.

7. Click Save to save the settings.
8. Click Send a test email and fill in your details to test the configuration details you entered. If you encounter any issues, refer to Troubleshooting.

Switch Existing Amazon SES Provider Setup to HTTP

If you already have set up Amazon SES configuration under Settings > Channels> Email earlier using SMTP credentials, you can switch to HTTP to send subsequent email campaigns from the Settings page on the CleverTap dashboard. To do so, you must edit the current Amazon SES provider setup:

1. From the CleverTap dashboard, go to Settings > Channels> Email.
2. Click the existing Amazon SES Provider from the Providers tab.
3. Repeat Step 4, 6, and 7 of Integrate Amazon SES with CleverTap.

📘

Note

You must add Access Key ID, Secret Access Key and update the server name to the HTTP server name.

Enabling Bounce and Complaint Processing

When an email is classified as bounced, CleverTap needs to be notified so that no further deliveries to that mailbox are attempted. This is considered a good practice and helps improve your sender reputation.

To enable support for bounce processing, follow the steps below:

1. Navigate to Amazon SNS.
2. Create a Topic.
3. Select the Topic and navigate to Actions > Subscribe to Topic.
4. Select HTTPS as the Protocol.
5. As the Endpoint value, add the Callback URL as shown in your CleverTap Email page.

6. Save your settings by clicking on Create Subscription.
7. Navigate to Amazon SES.
8. Select the Email Address you had previously added to the CleverTap Dashboard.
9. Click on View Details.
10. Click on Notifications > Edit Configuration.

11. Under SNS Topic Configuration, select the topics you created earlier such as Bounces, Complaints, and Deliveries by clicking on the Include original headers checkboxes.

12. Save the configuration.

Handling Unsubscribe Requests

To handle unsubscribed user requests, refer to the steps listed under Handling Unsubscribes.

Troubleshooting

This section outlines some troubleshooting scenarios and their solutions:

• Sandbox mode: If you are getting an Invalid Credentials message when saving your settings, it could be that your Amazon SES account is a sandboxed one. You need a valid production-ready Amazon SES account to save your credentials.
• Spam: Check your Spam folder to see if the message has been classified as Spam by your email provider.
• Email rendering: If your email does not render properly, check the subject line for new line characters or too many additional spaces. Amazon SES email converts data from UTF-8 format to a 7-bit ASCII format before sending it out. The new line characters or additional spaces may interfere with this conversion.