Outgoing Email Shared Parameters

Common email parameters enable Imagicle UCX On-prem/Cloud Suite to send email notifications through your company email server. Imagicle UCX Suite leverages this feature to forward voicemail messages, incoming faxes, scheduled reports, alarms, and to notify to the administrators about applications events.

This section describes those settings and their meaning. You can change them by clicking the System parameters link in the Admin menu, then pressing the Outgoing Email Parameters button.

SMTP Configuration

Typically, on-prem email servers like MS-Exchange or Lotus Domino leverage this protocol. In this case, you can select "SMTP" from Protocol Type pull-down menu. Please fill the resulting form based on your own email system:

Secure SMTP is also supported. The protocol to be used is auto-detected from the remote server choosing the safest first: TLS (we do support 1.2 - 1.0) or SSL (3.0 - 1.0) or plain.

Press the “Test” button to test the connection. Remember to press the “Update” button to save the changes before leaving.

Warning: even if the connection test succeeds, some email server might reject the "email from" address at the moment the email message is sent. Please check your email server configuration.

OAuth2 Configuration

If you are leveraging a Cloud-based email service, like Office365 or Google Mail, then likely you wish to enable email sending by leveraging OAuth2 modern authentication. In this case, you first need to create an App Registration (if not available yet), by following this KB article.

Then you need to create a DEDICATED email account in your Office365 Tenant, used by UCX Suite to populate the “From” field of the emails to be sent to users.

Please select "Office 365" from Protocol Type pull-down menu. Please fill the resulting form based on your own email system:

Companies leveraging a custom Office 365 URL

Some companies are leveraging a custom Office 365 URL to access their email service (like Office 365 Business service).

To change from default Office 365 URL to a custom URL, you must change two internal Windows system variables, by access Imagicle instance through a RDP session:

If you are leveraging an Imagicle UCX Cloud Suite, please contact Imagicle team to let them apply the change for you.

Email queuing for high reliability

Imagicle UCX Suite integrates an email messaging queue which prevents losing notifications when the connection with the email server fails.

If Outgoing Email Parameters has never been configured (especially the server IP address), connection is not attempted, outgoing emails are not generated, voicemail messages and incoming faxes may never reach their recipients.

If Outgoing Email Parameters are wrong, or if the email server cannot be reached at the moment, email messages are generated and stored in a local folder ("StonevoiceAS\Var\Spool\Pickup"). As soon as the connection is available, all the messages stored in queue are sent.

The queue service tries to reconnect to the email server every 30 seconds. The email messages are sent one by one in sequence.



Article ID: 18
Last updated: 28 Feb, 2024
Revision: 7
Imagicle UC Suite for Cisco UC -> Main Configuration -> System Parameters -> Outgoing Email Shared Parameters
https://kbp.imagicle.com/kb/entry/18/