Drive O&M: Troubleshooting Delivery Problems for Salesforce Emails

Last Modified on 2024-11-19 22:34:24 +0100

This article provides guidance on troubleshooting issues where some or all users fail to receive emails sent from the Salesforce application.

Depending on the situation, resolution may require assistance from Salesforce support, your internal IT department, or your Salesforce administrator.

Note

While these steps do resolve most issues, there’s no way to guarantee that all emails show up in your clients' inbox. This could be because of a change to IT policies, or the criteria used to filter emails could block emails sent from Salesforce.

Troubleshooting Guide

Note

Always begin troubleshooting with Step 1

  1. Submit a support ticket to Power Factors FSM requesting an email log from your instance.

  2. On your log file, review the 'Delivery Stage' column for any errors incurred during the attempted delivery of the emails to the user's Mail Transfer Agent (MTA).

    1. Successful delivery is noted by a D in the Mail Event column.

    2. Failures are noted by a P (permanent: mail is bounced to the sender immediately) or T (transient in the Mail Event column. For more details see: Email Log Reference

Considerations

  • Mail delivery to the recipient is attempted for up to 24 hours before it bounces back to the sender.

  • For a single email, you might see multiple line items with a D in the Mail Event column. This occurs because some emails pass through multiple Salesforce MTAs before reaching the final recipient.

  • Mail that is CC'd to a recipient has its own line item in the logs.

  • A common error seen in the email logs is "No MXs for this domain could be reached at this time." This error indicates that the Salesforce MTA can’t resolve the recipient’s domain correctly, or more commonly, mail attempted to be delivered to the recipients MTA is being blocked on the recipient's end of the connection.

Resolution

Allowlisting

Most companies monitor incoming mail and traffic from the internet by filtering untrusted network addresses.

If a single User is not receiving emails from Salesforce, it's less likely to be an issue with the IP allowlisting. If IP addresses are blocked or filtered, then several Users will have a problem receiving emails from the Salesforce application.

For IP range information please see Ensure you can receive email from the Salesforce application .

Email Configuration Settings

All email configuration settings require collaboration with your IT team, as they need to provide details about your domain or updates to your email server. Be prepared to schedule a call with Power Factors support to share this information and implement the necessary email configuration settings.

Sender Policy Framework (SPF)

Salesforce recommends using DKIM and SPF instead of allowlisting as they’re reliable mechanisms that remove the need for allowlisting and the associated challenges:

SPF is a simple email validation system designed to detect email spoofing by providing a process to verify which providers are permitted to send emails on your behalf. It also aims to reduce spam and fraud by making it harder for anyone to hide their identity. For more details, review Sender Policy Framework and Salesforce SPF Records.

DKIM

When you create a DKIM key, Salesforce publishes the TXT record containing your public key to DNS. Salesforce also automatically rotates keys to reduce the risk of your keys becoming compromised by a third party. For more details, review Create a DKIM Keyand Best practices to setup DKIM.

Configure Email Relay

When you have Enabled Email Relayand Set Up Email Relay, the Salesforce email server delivers all outbound emails to your email server, which then delivers them to the final recipients. Since your server is doing the final delivery, there’s no question as to the legitimacy of the communications.

After our Salesforce MTA connects and authenticates with your MTA (mail server) the communication is secure. It also has the added advantage that you can filter for content, add footers, and retain a copy of all outbound emails.

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article