UiPath Orchestrator

The UiPath Orchestrator Guide

Setting Up Email Alerts

To enable email alerts, you have to configure multiple settings on the Mail tab, in the Settings page.

Example of Setting Up Email Alerts with Google SMTP Server

  1. Navigate to https://security.google.com/settings/security/apppasswords.
  2. Sign in using the e-mail address which is to send mail messages from Orchestrator.
  3. From the Select App drop-down list, select Mail.
  4. From the Select Device drop-down list, select Windows Computer.
  5. Click Generate. The Generated App Password window containing an app password is displayed.
  6. Copy the generated app password to the Clipboard.
  1. In Orchestrator, in the Settings page, on the Mail tab, configure the settings as follows:
    a. Select the Enable Alerts Email check box.
    b. Select the Enable SSL check box.
    c. Clear the Use Default Credentials check box.
    d. SMTP Host - smtp.gmail.com (Google SMTP server).
    e. SMTP Port - 587 (default Google SMTP port). Note that Implicit SSL is not supported.
    f. SMTP Username - the email address to send mail messages from (the same used at step 2). In this case, documentation@uipath.com.
    g. SMTP Password - the app password of the email address you want to use. It has to be the password of the account that was specified in the Default From Address field.
    h. Default From Address - the email address to send mail messages from. It has to be the same one used at step 5, in our case documentation@uipath.com.
    i. Default From Display Name - a display name for the email address.

🚧

Important!

The Enable SSL option for email settings is disregarded if the SMTP server has SSL/TLS capabilities. Disabling SSL in Orchestrator when using an SSL/TLS-enabled SMTP server can cause an error to be thrown, hence emails cannot be sent. This occurs if the SSL certificates are not properly set up on both the Orchestrator machine and the SMTP server.

This usually occurs for self-signed certificates. Ensure that the Certificate Authority used to sign the certificates is installed in the Trusted Root Certificates Authorities Store on the Orchestrator host machine and SMTP server.

  1. Click Save. You will be asked if you want to proceed without testing the settings:

Click Yes to proceed anyway, or click No and see here to first test your settings.

Once saved, all users that have an e-mail address configured in the Users page and an assigned role that grants them View permissions on the Alerts page receive email alerts every time a Fatal or Error alert is encountered, and a daily detailed report of all alerts.

Testing Mail Settings

After entering your settings in the Mail tab as detailed above, you can ensure alert emails are functioning properly using the Test Mail Settings feature:

  1. Click Test Mail Settings. The Test Mail Settings window appears:
  1. In the Send To field, enter the address where the test email should be sent. This field is automatically populated with the email address of the current user, if available, in this case documentation@uipath.com.
  2. Click Send. A window will appear indicating if the email was sent successfully or an error occurred.
  3. Check the test email inbox to verify the message was received as expected.

📘

Note:

Testing does not save your settings, you must still click Save to apply these settings to your setup.

Now all users that have an e-mail address configured in the Users page and an assigned role that grants them View permissions on the Alerts page receive email alerts every time a Fatal or Error alert is encountered, and a daily detailed report of all alerts.

Updated 3 months ago



Setting Up Email Alerts


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.