Hey there! Welcome to Soapbox Engage’s Actions app. This guide will lead you step by step to preparing to utilize Amazon Simple Email Service for the Actions app.
The advantage of creating your own Amazon SES account over using the Soapbox Engage Email Service is that with your own account, you can set the From Email Address to Targets parameter to an email address using your own domain.
Otherwise, the email address that is used for messages to targets will use the soapboxengage.net domain.
If you decide the soapboxengage.net domain is sufficient for your use, then you only need to set Actions > Configuration > Send Messages Through option to "Soapbox Engage Email Service"
-
Create and enter your Amazon Simple Email Service (“Amazon SES”) API information
-
If you don’t have an Amazon Web Services account, go to Amazon Web Services - http://aws.amazon.com. If you already have an account, skip this step.
- Click the Sign Up button at the top-right of the screen
- On the “Sign In or Create an AWS Account” screen, type in the main email address you’d like associated with your AWS account. Also, choose the “I am a new user.” option. Click the Sign In Using our Secure Server button.
- On the “Login Credentials” page, enter the required information, and click the Continue button
- On the “Contact Information” screen, enter the required information, and click the Create Account and Continue button.
- On the “Payment Method” screen, enter your credit card information. Note, in using Amazon’s services, you’ll only be billed for services you use, and at the time of this writing, there are no monthly fees. Click the Continue button.
- On the “Identity Verification” screen, follow the instructions as shown on the screen.
- On the “Confirmation” screen, follow the instructions as shown on the screen.
-
Create an Amazon Web Services user dedicated to the Soapbox Engage Actions app
- Within the Amazon Web Services console, go to the Identity and Access Management
- In the left navigation, click on Users
- On the Users screen, click the Create User button
- On the User Details page, create a User Name, and click the Next button
- On the Set permissions page, in the Permissions options section, select "Attach policies directly", and in the Permissions policies section, type "AmazonSESFullAccess" into the search bar and check the box next to the AmazonSESFullAccess policy, and click the Next button
- On the Review and create page, click the Create user button
- On the Users page, click the name of the newly created user
- On the User page, click the Security credentials tab, and in the Access keys section click the Create access key button
- On the Access key best practices & alternatives page, select Third-party service, and check the confirmation box, and click the Next button
- On the Set description tag, just click the Create access key button
- On the Retrieve access keys page, save the Access key and Secret access key in a safe place for use by Soapbox Engage in a future step
-
Sign Up for the Amazon Simple Email Services (SES) account
- Go to https://aws-portal.amazon.com/gp/aws/developer/registration and follow the on-screen instructions for signing-up for an SES account (NOTE: It may be possible that Amazon has already automatically provided you access to SES, in which case you’ll see “You already have access to Amazon Web Services” at the top of your screen after clicking the link above).
- Completing this simple process gives you access to a test account, which allows you to send email ONLY to the verified email addresses below. You’ll need to request production access to use Soapbox Engage’s Actions app to send email normally (see below).
-
Configure your SES account’s email addresses
- Verify your sending address(es) or domain(s) by first going to the Amazon Console for SES: https://console.aws.amazon.com/ses/home
- In the upper-right of the Amazon SES console, to the left of the “Help” link, take note of the region code. If this says anything other than “N. Virginia”, click on the words displayed, and then choose “US East (N. Virginia)” from the dropdown.
- On the left side of the Amazon SES console, under the Verified Senders section, click the “Email Addresses” link.
- To add an address that you’ll be able to send email from in Soapbox Engage’s Actions app, in the top of the screen click the Verify a New Email Address button.
- In the Verify a New Email Address popup window, enter the email address you’d like to be able to send email from, and click the Verify This Email Address button.
- Check the email account of the address you supplied in the popup window to find a confirmation email from Amazon. Click on the appropriate link to confirm the verification process.
- Repeat this process to add more verified sending email addresses
-
Request Production Access to Simple Email Service
- Log into the AWS Management Console.
- Go to SES Sending Limits Increase.
- In the form, provide the following information:
- Region: Select “US East (Northern Virginia)
- Limit: Select “Desired Daily Sending Quota”
- New Limit Value: We recommend starting with 10,000, but recommend as much as you need. This is the number of emails you can send in a 24-hour period. Be sure to only request the amount you think you'll need. Keep in mind that you are not guaranteed to receive the amount you request, and the higher the limit you request, the more justification you will need to be considered for that amount.
- Click the Add Another Request button
- Region: Select “US East (Northern Virginia)"
- Limit: Select “Desired Maximum Send Rate”
- New limit value: 20
- Fill out the rest of the form
- Click the Submit button at the bottom of the screen once you have filled out the entire form
- It normally takes a few days for Amazon to process your request to move to their production services, but you can still keep moving forward on testing in the sandbox environment.
-
Add Amazon AWS Information in Soapbox Engage's Actions app configuration
- Login to your Soapbox Engage administrator
- Go to Actions > Configuration
- Enter AWS values, including the following
- Send Messages Through: Amazon Simple Email Service
- AWS Host URL: one of the following Amazon SES API endpoints listed below depending on the AWS region used for the organization
-
US East (Ohio) - https://email.us-east-2.amazonaws.com
-
US East (N. Virginia) - https://email.us-east-1.amazonaws.com
-
US West (N. California)- https://email.us-west-1.amazonaws.com
-
US West (Oregon) - https://email.us-west-2.amazonaws.com
-
- AWS Port: 443
- AWS Key | Username: the AWS Key for the AWS user previously created
- AWS Secret | Password: the AWS Secret for the AWS user previously created
-
If you don’t have an Amazon Web Services account, go to Amazon Web Services - http://aws.amazon.com. If you already have an account, skip this step.
* Done *