Email account is the set of options that is responsible for the configuration of the email processing. It can be a pre-configured account on SMTP server (for sending emails), POP3 server (for receiving emails) and IMAP server (for receiving emails).
To configure an email account, please complete the following steps:
- Navigate to the System Mailboxes → Email Accounts.
- Click New and fill in the fields.
- Click Save or Save and Exit to apply changes.
Email accounts form fields
| Field | Mandatory | Description |
|---|---|---|
| Name | Y | Displayed account name. |
| Type | Y | Account type, based on the protocol. Available choice options:
|
| Server | Y | The hostname of the server used for the mail processing. |
| User Name | Y | Server user login. |
| Password | Y | Server user password. |
| Email User Label | N | Descriptive user label. |
| Active | N | Select this checkbox to activate the account. |
| Enable Debug | N | Select this checkbox to have more extended logs. This will help to indicate issues while configuring email settings. |
| From | Y | Sender address (will be displayed in the From field of the message). |
| Port | Y | Specify the port that the server will be running on. |
| Enable SSL | N | Select this checkbox to enable SSL encryption. |
| Enable TLS | N | Select this checkbox to enable TLS encryption. |
When you finish configuring the email account, you can test the created account after saving by pressing the Test Connection button in the Related Links area.
If connection fails, a warning message appears:
In this case, check logs to find the error cause. To perform this, navigate to System Logs → Main Log and make a log selection based on the criteria below:
- Source = Email Logger
AND
- Level = Error
Use Condition Builder to build an appropriate filter. An example of the error record is given below.
Default email accounts
If you have configured email accounts in your system, but they are not used for email processing, you will not be able to send or receive emails. To prevent these collisions, set your email accounts as default ones, so they will be inserted automatically into every letter, incoming or outgoing.
To do this, please complete the steps below:
- Navigate to the System Properties → System Properties.
- Find the system properties listed in the table below using the search box and edit them specifying the values relevant to you.
Default email account properties field description
| Field | Mandatory | Description |
|---|---|---|
| Name | Y | System property name. Use default.email.account.send for the SMTP account. |
| Value | N | Email account ID. You can know it in the way listed below. |
| Description | N | Property description. |
| Property Category | N | Specify a property category (entity that groups some properties connoted with a common feature). This field references to the Property Category (sys_property_category) dictionary. |
To know the email account ID, please complete the steps below:
- Navigate to the System Mailboxes → Email Accounts.
- Click on the account name.
- Find the email account ID in the address bar (it is a long number sequence), and copy it to the clipboard. See the screenshot below:
