Skip to main content


         This documentation site is for previous versions. Visit our new documentation site for current releases.      
 

Message processing status and error categories

Updated on April 6, 2022

The status of an email changes multiple times as the message progresses through various processing stages. Learn about each status type to understand the email life cycle and troubleshoot potential issues with your email integration.

Message status

The following table provides the status types that a message can acquire during processing:

pyProcessingStatusDescription
initialThe email listener picks an unread message for processing.
parsingThe email listener starts parsing the message.
mapping-requestThe email listener attempts to extract the message contents.
processingThe email listener processes the message.
service-activity-startThe email listener invokes the configured service activity. For example, the email listener creates a case that is based on the email contents.
service-activity-endThe email listener successfully completes the service activity.
mapping-responseThe email listener completes processing the message and attempts to prepare the headers and the contents of the reply message.
marking-seenThe email listener completes processing the message and attempts to mark the message as seen.
marking-deleteThe email listener marks a message for deletion.
processing-completeThe email listener successfully processes the message.
errorThe email listener fails to process the message because of an issue.

Error categories

Email processing might fail because of such issues as faulty email listener configuration, a loss of connection to the email provider, or the lack of storage space in the mailbox. When an email listener encounters a processing error, the system records that error in the Log-Service-Email table in the pyErrorCategory category to simplify tracking and troubleshooting.

The following table lists the common error categories and the corresponding troubleshooting tips:

pyErrorCategoryDescriptionNotes
marking-seen-failedThis error occurs when the email listener fails to set the message status as marked-seen for a message whose processing is already completed.No action required. The message was manually opened, or there was an issue with the email provider that prevented the email listener from marking the message as seen.
marking-delete-failedThis error occurs when the email listener fails to mark a message for deletion whose processing was already completed.No action required. The message was manually deleted, or there was an issue with the email provider that prevented the email listener from marking the message for deletion.
marking-delete-expunge-failedThis error occurs when the email listener does not delete a message from the mailbox due to a failed expunge operation.The most common root cause of this error is the lack of storage space in the mailbox, for example, the full Deleted items folder.

This error can cause the PEGA0141 alert. For more information, see PEGA0141: Email expunge failed during message post-processing.

max-retries-processing-failedThe email listener exceeds the maximum number of failed attempts to process a message.Investigate the pyErrorReason column of the Log-Service-Email table for the possible root cause of the issue.
service-activity-failedThe email listener fails to complete its service activity.Debug the service activity that is configured for the email listener.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us