This document explains the lifecycle of a Secure Email record in Salesforce, including status updates, delivery outcomes, and batch processes.
Stages of Secure Email
-
Created
-
The Secure Email record is created in Salesforce.
-
This stage represents that the request has been logged but not yet processed.
-
-
Processing
-
An API call is made to Paubox to initiate email delivery.
-
A background process runs after 1 minute to check the delivery status of the email.
-
-
Partially Delivered
-
If the email is successfully delivered to few of the recipients:
-
Email Status = Partially Delivered
-
Delivery Status = Partially Delivered
-
-
Individual Delivery Status for all the recipients will be stored on the Email Recipients record related to the Secure Email Message record.
-
-
Delivered
-
If the email is successfully delivered:
-
Email Status = Delivered
-
Delivery Status = Delivered
-
-
If the recipient opens the email during this time:
-
Opened Status = Opened
-
Delivered Time and Opened Time fields are updated.
-
-
-
Failed
-
Email delivery failed due to an error or bounce.
-
Delivery Status contains the failure reason.
-
-
Failure reasons may include:
-
Soft bounce (temporary delivery issue).
-
Hard bounce (permanent issue such as invalid email).
-
Internal error.
-
-
Scheduled Batch Process
-
A batch job runs every N minutes to monitor Secure Email records. Default is 2 and is configurable.
-
It checks for:
-
Emails stuck in Processing.
-
Emails Delivered but not opened for the past N days.
-
-
The value of N is configurable through Custom Settings, allowing organizations to fine-tune monitoring intervals.
Click here to find more details on the Batch.
Delivery Status Values
Secure Email can return one of the following delivery statuses:
|
Status |
Meaning |
|---|---|
|
processing |
Email is in progress and being handled by the system. |
|
TLS not offered, sending via Secure Portal |
Recipient’s mail server does not support TLS; email sent via secure portal. |
|
soft bounced |
Temporary delivery failure (e.g., server unavailable). |
|
soft bounced – mailbox full |
Recipient’s mailbox is full; delivery could not be completed. |
|
hard bounced |
Permanent delivery failure (invalid email or domain issue). |
|
Internal error. Please check back later. |
Paubox encountered an internal issue; retry later. |
|
delivered |
Email successfully delivered to the recipient. |
|
delivered via secure portal |
Delivered securely via Paubox secure portal. |
Summary
-
Secure Email follows a clear Created → Processing → Delivered/Failed lifecycle.
-
Statuses are auto-updated via background jobs and batch monitoring.
-
Delivery outcomes (Delivered, Bounced, Secure Portal) are tracked for compliance and auditing.
-
Organizations can configure retry/monitoring intervals using Custom Settings.
For assistance or troubleshooting, please contact:
📧 solutions@cloudmaveninc.com