SMTP Settings are configured in Setup / Extensibility / SMTP Settings / SMTP Settings
Overview
From this screen you can configure outgoing email settings which enables the ability to send emails to system users and account contacts. Emails can be sent for multiple purposes, such as resetting user passwords or emailing invoices to billing contacts.
Prerequisites
SMTP settings can be setup immediately, there are no prerequisite configuration steps.
SMTP Settings Panel
The SMTP Settings panel on the left of this screen allows you to select existing SMTP settings to view and edit on the Edit SMTP Settings panel to the right. Actions are also available in this panel which are shown as icons above the Filter text box. The available actions are described below.
Actions
Icon | Description |
---|---|
Sends a test email to the AdminPortal user's email address using the SMTP Settings selected | |
Deletes the selected SMTP Settings | |
Adds new SMTP Settings |
Edit SMTP Settings Panel
The information in this panel reflects the currently selected SMTP settings. From here you can change the settings (fields will display a red left border if a value is required and purple text if the field is read-only and cannot be modified).
SMTP Settings Fields:
Name: a unique name for the smtp settings (e.g. the smtp mail server name)
Use STARTTLS Only: enable this to ensure that the STARTTLS email protocol is used
Server Host Name: the outgoing mail server host name (e.g. smtp.xxxxx.com)
Port: the outgoing mail server port number
Name: the name that will appear in the 'From' address field when the system sends a message. If the email being sent uses an email template then the 'From' name configured on the template will override this setting
Email Address: the email address that will appear as the sender's address. The from address configured on an email template will override this value if an email template is used
Username: a valid username/email address used to authenticate with the smtp server
Password: the password associated with the username/email account supplied above
Max Size: the maximum size email attachments on a system generated email can be (this should match or be less than the smtp server's attachments size limit). The max size is not per file attachment but the total size of all attachments on the email
Notify User: the user that will be notified in the event an attempt is made to send an email with attachments that exceed the Max Size value specified above
Guides
Adding SMTP Settings
Under the SMTP Settings heading on the left click the icon
Under the Add SMTP Settings heading on the right specify the SMTP settings
Click Save
Editing SMTP Settings
Under the SMTP Settings heading on the left click the SMTP settings you wish to edit
Under the Edit SMTP Settings heading on the right modify the settings
Click Save when you have finished making changes
Deleting SMTP Settings
Under the SMTP Settings heading on the left select the SMTP settings you wish to delete
Under the same SMTP Settings heading click the icon
On the confirmation dialog that appears select Yes
How to Handle Email Delivery Failures
When the Maximum Attachment Size is Exceeded:
If email Invoice delivery fails due to the invoice pdf attachment exceeding the Max Size value or the invoice pdf plus other attachments exceeding the Max Size value, then:
The system user set in the Notify User field will be emailed to alert that user of the failure sending the email message
The invoice will be listed as delivered on the account
To deliver the invoice to the user manually:
Access the account containing the invoice
From the account, on the Overview menu select Billing and then Invoices
View and then download the invoice (see the Account Invoices Screen help for instructions on how to view and download invoices)
Outside of the LogiSense billing system send an email to the account’s billing contact with the invoice pdf attached