LUCY

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
======= Introduction =======

LUCY comes with different mail delivery options:

  - Delivery via (built-in) internal mail server (Internal Postfix Server)
  - Delivery via an external mail relay (External SMTP Server)
  - Delivery via pre-paid external mail relay (HTTP Proxy)

===== Delivery via external mail relay (SMTP) using the general settings =====

This chapter concerns the general mail settings which can be set globally for all campaigns. If you might have different delivery methods in campaigns, please define the individual message delivery method within the campaign itself.

In LUCY the default delivery method for mails is using the built-in Postfix mail server. As many SPAM filters will block emails coming from a new IP address that has no reputation, the administrator can decide to configure an external mail relay. In LUCY this is done under **Settings/Mail settings** & **Settings/SMTP servers**:


{{ mailrelaysettings.png?600 }}


To use an external SMTP server you will first need to add your mail server by clicking the **"Add mail server"** button:

{{ addmailserver.png?600 }}

In the second step you need to enter the **mail server** details:

{{ addmailserver3.png?600 }}

After saving the configuration, you can test the connection with the external SMTP server using the tool presented on the same page: enter the Sender and Recipient addresses and press the **"Test"** button.
If it is OK, you will see the message //"Success, please see the output"//.
If something wrong, you will see the message //"Error, please see the output"//. In the Console Output you will see a short description of the issue and log of the SMTP session:

{{ smtp_test.png?600 }}

More information regarding the SMTP errors codes you сan find [[smtp_status_codes|here]].
===== Delivery via external mail relay (SMTP) within a campaign =====

**Please Note:** You can define the mail delivery method on a **globally** within the settings menu. If you do so, it will **overwrite all individual settings** in a campaign. The second possibility is to configure the delivery methods within a campaign:

{{ message_campaign.png?600 }}


===== Configuration of using a pre-paid, external mail server (via HTTP) =====

In LUCY you can use a pre-paid, external mail server with an excellent reputation as your default communication method. In this model, we use an API to Sendgrid (https://sendgrid.com/) that allows us to communicate via HTTP to an external mail server to initiate the mail delivery. There are few advantages to this model especially if all other methods of mail delivery fail due to SPAM filtering. You can configure LUCY to use a pre-paid external mail server in two ways:

  - Generic settings for all campaigns: select the HTTP method within **"Settings/mail settings"**. 

{{ :mail_settings_http.png?400 |}}

You will then be presented the option to define the mails sender domain or mail sender name. This setting will overwrite the individual setting within a campaign and ensure that all emails in LUCY are sent using this method:

{{ external_mail_relay.png?600 }}

- Campaign specific delivery method: if you did not specify any generic mail delivery method in **"Settings/mail settings"** you can configure the mail delivery as well in every single campaign under the scenario settings in **"Mail settings"**:

{{ external_mail_relay_ii.png?600 }}

If you pick **"HTTP"** as your delivery method then you will have only a limited number of domains you can choose as a sender address:

{{ external_mail_relay_iii.png?600 }}

On the recipient side the email might look as follows (depending on the domain you picked):

{{ external_mail_relay_iv.png?600 }}

The list of external mail domains will continuously be expanded with each LUCY release. 

**Please note**: if a recipient of such an e-mail will press reply, the reply address will be something like "do-not-reply@example-domain.com". If he still answers to the mail he will get an error with a non-delivery report. So you won't be able to catch answers to those pre-defined e-mail domains.


**Pricing:**: sending up to 100 emails using the external HTTP mail server is free. Every extra mail will cost 0.1 cents.   Please make sure you have enough credits before starting the campaign.

**Mail Sender Domains for HTTP Proxy**: the following mail sender domains are pre-configured

  *  sendgrid.net
  *  security-information.xyz
  *  cloudservice24.xyz
  *  delivery365.website
  *  web-contest.host
  *  file-sharing.host
  *  mail-access.site
  *  onlineservices.space
  *  report365.us
  *  cloudaccess.space
  *  online-survey.site
  *  printservices.press
  *  webmail-access.space
  *  vpn-access.host
  *  online-statistics.site
  *  cloud-encryption.host
  *  web-login.site
  *  secure-login.host

===== Delivery via internal Postfix Server =====

The most frequent email delivery method is using an internal Postfix Server.
Servername should match with the FQDN of the LUCY instance.
We recommend having a subdomain for mail purposes, as it is shown on the screenshot below.

{{ :internal_postfix.png?400 |}}

===== Troubleshooting =====

  * [[mail_communication_issues:e-mails_do_not_arrive|Emails do not arrive]]
  * [[mail_communication_issues:mails_may_arrive_delayed|Emails arrive delayed]]
  * [[mail_communication_issues_-_mails_do_not_get_send_at_all|Emails are not send]]
  * [[not_all_mails_are_send_after_a_campaign_is_started|Not all mails are send]]