How to Use my Mail Server to Send and Receive Emails in Flectra

If you are a user of Flectra Online or Flectra.sh…

You have nothing to do! Flectra sets up its own mail servers for your database. Outgoing and incoming emails work out-of-the-box!

Unless you plan to send large batches of mass mailing that could require the use of an external mail server, simply enjoy your new Flectra database.

Scope of this documentation

This document is mainly dedicated to Flectra on-premise users who don’t benefit from an out-of-the-box solution to send and receive emails in Flectra, unlike Flectra Online & Flectra.sh.

Warning

If no one in your company is used to manage email servers, we strongly recommend that you opt for those Flectra hosting solutions. Their email system works instantly and is monitored by professionals. Nevertheless you can still use your own email servers if you want to manage your email server’s reputation yourself.

You will find here below some useful information on how to integrate your own email solution with Flectra.

Note

Office 365 email servers don’t easily allow to send external emails from hosts like Flectra. Refer to Microsoft’s documentation to make it work.

How to manage outbound messages

As a system admin, go to Settings ‣ General Settings and check External Email Servers. Then, click Outgoing Mail Servers to create one and reference the SMTP data of your email server. Once all the information has been filled out, click on Test Connection.

Here is a typical configuration for a G Suite server.

../../../../_images/outgoing_server.png

Then set your email domain name in the General Settings.

Note

If you get a [AUTHENTICATIONFAILED] Invalid credentials (Failure) warning when you Test Connection on a Gmail address, activate the Less secure app access option. A direct link can be accessed here.

In addition to that, enable the IMAP setting on your Gmail account.

Can I use an Office 365 server

You can use an Office 365 server if you run Flectra on-premise. Office 365 SMTP relays are not compatible with Flectra Online.

Please refer to Microsoft’s documentation to configure a SMTP relay for your Flectra’s IP address.

How to use a G Suite server

You can use an G Suite server for any Flectra hosting type. To do so you need to setup the SMTP relay service. The configuration steps are explained in Google documentation.

Be SPF-compliant

In case you use SPF (Sender Policy Framework) to increase the deliverability of your outgoing emails, don’t forget to authorize Flectra as a sending host in your domain name settings. Here is the configuration for Flectra Online:

  • If no TXT record is set for SPF, create one with following definition: v=spf1 include:_spf.flectrahq.com ~all

  • In case a SPF TXT record is already set, add “include:_spf.flectrahq.com”. e.g. for a domain name that sends emails via Flectra Online and via G Suite it could be: v=spf1 include:_spf.flectrahq.com include:_spf.google.com ~all

Find here the exact procedure to create or modify TXT records in your own domain registrar.

Your new SPF record can take up to 48 hours to go into effect, but this usually happens more quickly.

Note

Adding more than one SPF record for a domain can cause problems with mail delivery and spam classification. Instead, we recommend using only one SPF record by modifying it to authorize Flectra.

Allow DKIM

You should do the same thing if DKIM (Domain Keys Identified Mail) is enabled on your email server. In the case of Flectra Online & Flectra.sh, you should add a DNS “flectra._domainkey” CNAME record to “flectra._domainkey.flectrahq.com”. For example, for “foo.com” they should have a record “flectra._domainkey.foo.com” that is a CNAME with the value “flectra._domainkey.flectrahq.com”.

Restriction

Please note that the port 25 is blocked for security reasons. Try using 587, 465 or 2525.

How to manage inbound messages

Flectra relies on generic email aliases to fetch incoming messages.

  • Reply messages of messages sent from Flectra are routed to their original discussion thread (and to the inbox of all its followers) by the catchall alias (catchall@).

  • Bounced messages are routed to bounce@ in order to track them in Flectra. This is especially used in Flectra Email Marketing to opt-out invalid recipients.

  • Original messages: Several business objects have their own alias to create new records in Flectra from incoming emails:

Depending on your mail server, there might be several methods to fetch emails. The easiest and most recommended method is to manage one email address per Flectra alias in your mail server.

  • Create the corresponding email addresses in your mail server (catchall@, bounce@, sales@, etc.).

  • Set your domain name in the General Settings.

    ../../../../_images/alias_domain.png
  • If you use Flectra on-premise, create an Incoming Mail Server in Flectra for each alias. You can do it from the General Settings as well. Fill out the form according to your email provider’s settings. Leave the Actions to Perform on Incoming Mails blank. Once all the information has been filled out, click on TEST & CONFIRM.

../../../../_images/incoming_server.png
  • If you use Flectra Online, We do recommend to redirect incoming messages to Flectra’s domain name rather than exclusively use your own email server. That way you will receive incoming messages without delay. Indeed, Flectra Online is fetching incoming messages of external servers once per hour only. You should set redirections for all the email addresses to Flectra’s domain name in your email server (e.g. catchall@mydomain.ext to catchall@mycompany.flectrahq.com).