Outgoing (SMTP) emails default set up:
When you create a site , by default the new site will have a subdomain url like sitename.raaspi.com and will be ready in a few minutes for access by visitors and also be ssl ready ie can be accessed as https:// sitename.raaspi.com, which is recommended as all the data will pass through internet as encrypted.
By default, a site's outgoing emails will be sent via what is called mail relay. It can be used for both low volume transaction type (confirmation of orders etc) as well as high volume emails for marketing. Advantage is that no set up is needed and ready to use. But mail relay disadvantage is that some email clients may reject the emails coming via relay and the received email 'from' will show as your sitename and details will show as sitename via [email protected]. Reply To will still have the email address of the actual sender.
What you put as contact email address for your site, is not related to outgoing emails and can be any valid address you control.
Other Options, which need setup:
Even though you have your site as a subdomain ie mysitename.raaspi.com, you can set up outgoing emails as [email protected] or as [email protected].
In many cases, the requirement will be to have your own site name like mysite.com or mysite.org etc. and is called custom domain name. This certainly can be done but needs some extra steps and cost, as described in blog custom domain for a site
In both cases, outgoing email set up will be the same, as described now.
Outgoing emails are sent via what is called SMTP server.
Step 1: Login to access back office menu.
Step 2: Goto Setups/Client/Edit record/version 01/configur/setup.
Step 3: Enter values for SMTP setup as shown below.
Step 4: Follow additional steps shown below, where applicable.
Step 5: Update to save and click on the open new tab button on the top right side and go to Mailings/emails
SMTP values (Step 3)
Vendor |
Port |
Authentication |
Mail Relay Off |
TSL |
SSL |
Server |
User |
Password |
Notes |
Help Links |
Zoho |
587 |
yes |
yes |
yes |
Not Supported |
smtp.zoho.com |
[email protected] |
****** |
Make sure sender email matches with the email id used in smtp setup. |
Zoho |
Gmail |
587 |
yes |
yes |
yes |
Not Supported |
smtp.gmail.com |
[email protected] |
****** |
see notes below(g) |
GMail |
HostPapa |
587 |
yes |
yes |
No |
Not Supported |
mail.yourdomain.com |
[email protected] |
****** |
|
HostPapa |
Namecheap |
587 |
yes |
yes |
yes |
Not Supported |
mail.privateemail.com |
[email protected] |
****** |
|
Namecheap |
Godaddy and others |
|
|
|
|
Not Supported |
|
|
|
copy values from mail client being used |
Godaddy
|
(g)In case of using Gmail smtp server, an additional step is needed ie set up Oauth token. This is done by creating record 07 reserved for GMail setup.
Once record 07 gets created, use the link Allow Raaspi to set up GMail smtp. RAASPI has logic to get new tokens using refresh Token.
But, If needed, a new refresh token can be created using Manage RAASPI API tokens. Record 01 is still used to hold SMTP setup info except for
SMTP password which is now token values kept in record 07.
Tip: If you have multiple GMail ids, you need to make sure that the smtp user name is the same id which grants access to third party App Raaspi, otherwise you will get auth error 334.
Sender Policy Framework (SPF) and DomainKeys Identified Mail (DKIM) records for your domain.
If the smtp server domain name does not match with your site domain name, then you need to add SPF and DKIM DNS records to your domain. Otherwise the emails sent will be marked as SPAM by most email clients.
Some smtp relay servers like sendgrid has an autometed security option where they will manage the SPF and DKIM records for you but you need to have CNAME record in your DNS which points to a sendgrid domain. We use this feature of sendgrid by putting an entry in 3rcomputer.com DNS. The manual process of adding these entries is explained below:
If your site is 3rcomputer.com and smtp server is mail.3rcomputer.com then no need for SPF and DKIM records, But if your site is mysite.com and your SMTP server is smtp.zoho.com then you need to add extra DNS TXT records to mysite.com.
for zoho the SPF record is v=spf1 include:zoho.com ~all
use Zoho Mail's control panel to generate DKIM record and then copy and paste the value into mydomain.com DNS
the DKIM will look like v=DKIM1; k=rsa; p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNA........
Your domain DNS records will look something like
mysite.com. |
14400 |
IN |
TXT |
v=spf1 ....
|
zoho._domainkey.mysite.com |
14400 |
IN |
TXT |
v=DKIM1; k=rsa; p=MIG....
|
There will be a verification step initiated by the SMTP service to verify with the domain DNS server, before the changes will take effect
You should refer to the detail instructions (Links provided on this page) by your DNS provider and by the SMTP service provider.