Skip to main content

Failed outgoing emails

There are two ways of sending emails:

  • Asynchronous: The email is saved to the database and then send. This behavior applies to manual emails sent from the Web Client and automatic emails created in scripts using methods of the class mailService.
  • Synchronous: The email is sent directly, usually from a script. If the sending fails, there is an error.

Asynchronous emails are retried several times. If the send operation fails after the defined retries, see Configuring asynchronous email handling, the email is displayed on the Failed outgoing emails page in the Web Admin Suite. In addition, the sender and administrator are notified. For emails sent from the Web Client a red failure note is shown in the respective case history entry.

The sending of a failed email can be retried either by clicking the Retry option in the Web Client, or by clicking Retry sending in the Web Admin Suite.

Available settings for failed outgoing emails​

The following information is available for failed outgoing emails:

  • Subject: The subject of the email.
  • From: The email address of the sender of the email.
  • To: The email address of the recipient of the email.
  • Sending date: The date when the email was sent.

Basic tasks​

Finding an email​

The list of emails is displayed directly after accessing the Failed outgoing emails page of the Web Admin Suite. You can filter the list to locate an email more easily:

  • Text search: Enter a text in the Search field to filter by subject, sender or recipient.

Managing failed outgoing emails​

You can perform the following actions on failed outgoing emails:

  • Retry an email: Click the Retry sending icon to send it again. The email is removed from the table while it is processed. If sending fails, the email will appear again.
  • Delete an email: Click the Delete icon to remove the email from the database.

Advanced tasks​

Configuring asynchronous email handling​

You can configure asynchronous emails using the following system properties:

  • cmas-core-server, mailSender.maxAttempts: Define the maximum number of attempts to send the emails. The default value is 3.
  • cmas-core-server, mailSender.retryInterval.seconds: Define the period in seconds before another attempt to send an email is made, if the previous attempt failed. The default is 60.
  • cmas-core-server, mailSender.failedMailsArchiveLimit: Define maximum number of failed asynchronous emails kept in the database. The default value is 150.