Production Configuration

<p class="graf graf--p">Chaskiq works with Amazon SES for email delivery, you could use any SMTP service, but with Amazon, SES gives Chaskiq's messaging superpowers.</p><p class="graf graf--p"></p><p class="graf graf--p">To start using Amazon SES you need to enter to your Amazon console &amp; configure your domain. Amazon SES requires that you verify your email address or domain to confirm that you own it and to prevent others from using it.</p><p class="graf graf--p"><a target="_blank" rel="noopener noreferrer nofollow" href="https://docs.aws.amazon.com/ses/latest/DeveloperGuide/verify-domains.html">https://docs.aws.amazon.com/ses/latest/DeveloperGuide/verify-domains.html</a></p><h2 class="graf graf--h">Configure notifications for your Verified Domain:</h2><p class="graf graf--p">Once the domain is verified, you can edit the configuration of the domain and attach a SNS topic, So; you’d go to the notification settings for identity and select Include original headers next to the bounce notification configuration:</p><p class="graf graf--p"></p><image-block src="/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcVlVIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--a557d36dfe774b199d7efae5b359424ea7f4aaf0/image.png" width="743" height="534" loading="true" loading_progress="0" caption="type a caption (optional)" direction="center" aspect_ratio="{&quot;width&quot;:743,&quot;height&quot;:534,&quot;ratio&quot;:71.8707940780619}"></image-block><h2 class="graf graf--h">Create SNS Topics</h2><p class="graf graf--p">You have to create your own SNS topic and add topic subscriptions. Just make sure you uncheck send raw messages , the URL schema to subscribe on your app is https://YOURDOMAIN/api/v1/hooks , it should be automatically verified. if you are using a local dev server, make sure the URL is public, you can use services like Ngrok to tunnel your dev machine and expose the URL.</p><h2 class="graf graf--h">Attach your SNS to SES configuration set</h2><p class="graf graf--p">Go to SES -&gt; configuration sets and create one and then create an SNS destination where you could add the events you want to notify. (Bounce, Click, Complaint, Delivery, Open, Reject, Send) </p><p class="graf graf--p"></p><image-block src="/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBZkU9IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--7fbfc990bdd8f3765eb6ad0c45e223216b91d108/image.png" width="778" height="414" loading="true" loading_progress="0" caption="type a caption (optional)" direction="center" aspect_ratio="{&quot;width&quot;:778,&quot;height&quot;:414,&quot;ratio&quot;:53.213367609254504}"></image-block><p class="graf graf--p">Finally in your app environment variables you may want to set the SNS_CONFIGURATION_SET variable with the name of your already created set, if you set this, you will need to restart the app in order for changes to have an effect.</p><p class="graf graf--p"></p><h2 class="graf graf--h">Email Receving</h2><p class="graf graf--p">in order to receive emails from AWS to Chaskiq you will need to add a valid rule set:</p><image-block src="/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcWNVIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--efc0afefc8b10d53eef0a121be76ffbc5e8c549d/image.png" width="400" height="487" loading="true" loading_progress="0" caption="type a caption (optional)" direction="center" aspect_ratio="{&quot;width&quot;:400,&quot;height&quot;:487,&quot;ratio&quot;:121.75}"></image-block><h2 class="graf graf--h"></h2><p class="graf graf--p">When adding the rule set you will need to create 2 rules one for inbound@YOUR_EMAIL_DOMAIN and messages@YOUR_EMAIL_DOMAIN</p><image-block src="/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcWdVIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--546f7d0440f7fb5726d1e6d4847319cbd86d3b31/image.png" width="547" height="382" loading="true" loading_progress="0" caption="type a caption (optional)" direction="center" aspect_ratio="{&quot;width&quot;:547,&quot;height&quot;:382,&quot;ratio&quot;:69.83546617915904}"></image-block><p class="graf graf--p">Then, in the actions tab add a deliver to S3 Bucket:</p><image-block src="/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcWtVIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--0089748023b2133c5eb424d53f5de8aac169de2b/image.png" width="868" height="500" loading="true" loading_progress="0" caption="type a caption (optional)" direction="center" aspect_ratio="{&quot;width&quot;:868,&quot;height&quot;:500,&quot;ratio&quot;:57.6036866359447}"></image-block><p class="graf graf--p">and point the event to the right bucket and the right SNS topic.</p><h2 class="graf graf--h">Create a Special S3 Bucket to store emails and send them to chaskiq:</h2><p class="graf graf--p">First, you will need to create a bucket with the following bucket policy, if the bucket is created from the ruleset page itself it will create the proper bucket policy:</p><p class="graf graf--p"></p><image-block src="/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBcW9VIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--2ada2193ae2f6cf1d90ba7b099ecdcb110461549/image.png" width="510" height="530" loading="true" loading_progress="0" caption="type a caption (optional)" direction="center" aspect_ratio="{&quot;width&quot;:510,&quot;height&quot;:530,&quot;ratio&quot;:103.921568627451}"></image-block><p class="graf graf--p"></p><p class="graf graf--p"><strong>reference: </strong><a target="_blank" rel="noopener noreferrer nofollow" href="https://aws.amazon.com/es/premiumsupport/knowledge-center/ses-receive-inbound-emails/">https://aws.amazon.com/es/premiumsupport/knowledge-center/ses-receive-inbound-emails/</a></p><p class="graf graf--p"></p><p class="graf graf--p">That's all, have a happy Mailin.</p><p class="graf graf--p"></p>

Chaskiq works with Amazon SES for email delivery, you could use any SMTP service, but with Amazon, SES gives Chaskiq's messaging superpowers.

To start using Amazon SES you need to enter to your Amazon console & configure your domain. Amazon SES requires that you verify your email address or domain to confirm that you own it and to prevent others from using it.

https://docs.aws.amazon.com/ses/latest/DeveloperGuide/verify-domains.html

Configure notifications for your Verified Domain:

Once the domain is verified, you can edit the configuration of the domain and attach a SNS topic, So; you’d go to the notification settings for identity and select Include original headers next to the bounce notification configuration:

You have to create your own SNS topic and add topic subscriptions. Just make sure you uncheck send raw messages , the URL schema to subscribe on your app is https://YOURDOMAIN/api/v1/hooks , it should be automatically verified. if you are using a local dev server, make sure the URL is public, you can use services like Ngrok to tunnel your dev machine and expose the URL.

Go to SES -> configuration sets and create one and then create an SNS destination where you could add the events you want to notify. (Bounce, Click, Complaint, Delivery, Open, Reject, Send) 

for our production app we just Checked Send, Reject, Delivery, Bounce, Complaint, Click & Open

Finally in your app environment variables you may want to set the SNS_CONFIGURATION_SET variable with the name of your already created set, if you set this, you will need to restart the app in order for changes to have an effect.

in order to receive emails from AWS to Chaskiq you will need to add a valid rule set:

When adding the rule set you will need to create 2 rules one for inbound@YOUR_EMAIL_DOMAIN and messages@YOUR_EMAIL_DOMAIN

Then, in the actions tab add a deliver to S3 Bucket:

and point the event to the right bucket and the right SNS topic.

Create a Special S3 Bucket to store emails and send them to chaskiq:

First, you will need to create a bucket with the following bucket policy, if the bucket is created from the ruleset page itself it will create the proper bucket policy:

https://aws.amazon.com/es/premiumsupport/knowledge-center/ses-receive-inbound-emails/

Learn how to configure the Amazon SES account to receive events and handle incoming email 