---
Title: Troubleshoot received
URL Source: https://company-skill.com/p/alimail/alimail-troubleshoot-received
Language: en
Description: You or someone else sent an email, but it never appeared in the recipient’s inbox. You need to determine whether the issue stems from local mailbox settings, external delivery failures (like DNS…
---

# Troubleshoot received

Part of **Alibaba Mail**. Route queries via `POST https://company-skill.com/api/route`.

## What You Want to Do

You or someone else sent an email, but it never appeared in the recipient’s inbox. You need to determine whether the issue stems from local mailbox settings, external delivery failures (like DNS misconfiguration), or security filtering (e.g., anti-spam systems).

**Typical User Questions**:
- Why didn't I receive an email that was sent to me?
- Email shows as sent but never arrived — how to debug?

## Decision Tree

Pick the best path for your situation:

- **If** you can log in to WebMail but the email is missing from all folders → Use **** (go to *alimail/alimail-email*)
- **If** the sender received a bounce message with error codes like **550 failed to meet SPF requirements** or **554 Reject by behaviour spam** → Use **MX/SPF/** (go to *alimail/alimail-email-delivery*)
- **If** you suspect the email was marked as spam or see an **ESO_LOCAL_SPAM** error → Use **** (go to *alimail/alimail-security*)
- **Otherwise (default)** → Start with ****, as most user-reported "missing email" cases involve local settings like **Deletion by Receiving Software**, **Receiving Rules**, or hitting the **10GB capacity limit**.

## Path Comparison

| Path | Best For | Complexity | Code Required | Automation | Key Fact | Detail Skill |
|------|----------|------------|---------------|------------|----------|-------------|
| Console / Dashboard | low | No | No | Free accounts have a hard **10GB capacity limit**; exceeding it blocks new mail | `alimail/troubleshooting/alimail-email` |
| MX/SPF/ | medium | No | No | **MX records** must be exactly `mx1.imm.aliyun.com` (priority 10) and `mx2.imm.aliyun.com` (priority 20) | `alimail/troubleshooting/alimail-email-delivery` |
| Console / Dashboard | low | No | No | Interception with **ESO_LOCAL_SPAM** requires submitting a **.eml file** for manual review | `alimail/troubleshooting/alimail-security` |

## Path Details

### Path 1: Console / Dashboard
**Brief Description**: This path diagnoses issues within the user’s own mailbox, such as emails removed by **Deletion by Receiving Software** (common with POP3), missing **Save to Sent Email** visibility in WebMail, automatic sorting via **Receiving Rules**, or hitting the **10GB capacity limit**. Key settings are found under **Email Settings** > **POP Settings** and monitored via the **Storage indicator**.

**Key technical facts**:  
*(All fields null in fact_card — no runtime, billing, or scaling data applicable)*

**When NOT to Use**:
- alimail-email-delivery
- alimail-security

### Path 2: MX/SPF/

**Brief Description**: This path addresses delivery failures caused by incorrect DNS configuration or policy restrictions. It involves verifying **MX records**, ensuring a valid **SPF TXT record** that includes `include:aliyun-inc.com`, checking **Send to External Domains** permissions in **Employee Account Management**, and using **Check Domain Name Resolution** tools. Common errors include **550 failed to meet SPF requirements** and **554 Reject by behaviour spam** due to weak passwords.

**Key technical facts**:  
*(All fields null in fact_card — no runtime, billing, or scaling data applicable)*

**When NOT to Use**:
- alimail-email
- alimail-security

**Known Limitations**:
- SPFinclude:aliyun-inc.comSPF
- MXmx1.imm.aliyun.com(10)mx2.imm.aliyun.com(20)

### Path 3: Console / Dashboard
**Brief Description**: This path focuses on anti-spam filtering. If a message triggers the **ESO_LOCAL_SPAM** error, it’s blocked by Alibaba Mail’s security layer. Users can review **Account and Security** settings, manage **Whitelist**/**Blacklist**, and respond to **Unusual logon notifications**. Legitimate emails require submission of the original **.eml file** for appeal, as automated release isn’t possible.

**Key technical facts**:  
*(All fields null in fact_card — no runtime, billing, or scaling data applicable)*

**When NOT to Use**:
- alimail-email-delivery
- alimail-email
- MXSPF DNS

## FAQ

Q: Which path should I start with?  
A: Start with **** if you can log in and don’t see bounce messages — most missing-email reports stem from **Receiving Rules**, **POP Settings**, or the **10GB capacity limit**.

Q: What if my mailbox hit the **10GB capacity limit** but I used the **** path? 
A: You’ll waste time checking **MX records** and **SPF TXT record** when the real issue is local storage — new emails are rejected silently once the **Storage indicator** hits 10GB.

Q: What if I received an **ESO_LOCAL_SPAM** error but chose the **** path? 
A: You won’t find the email anywhere in your folders because it was never delivered — the **alimail-email** path can’t recover messages blocked by the anti-spam system.

Q: Can I fix a **550 failed to meet SPF requirements** error using the security path?  
A: No — **550 SPF errors** originate from missing or invalid **SPF TXT record** in DNS, which is handled only in the **alimail-email-delivery** path via **Check Domain Name Resolution**.

Q: Why do I need a **.eml file** to appeal a spam block?  
A: Alibaba Mail’s anti-spam system requires the full original message headers and content (in **.eml file** format) to verify legitimacy — this is mandatory for **ESO_LOCAL_SPAM** cases.

Q: Does enabling **Save to Sent Email** prevent missing sent messages?  
A: Yes — by default, emails sent via clients aren’t saved to WebMail’s sent folder; enabling this in **Email Settings** ensures visibility across devices.

## Related queries

email not received, didn't get email, missing email, email disappeared, where is my email, mail not showing up, no email in inbox, email delivery failed, email bounced, spam folder empty, check spam filter, email blocked, mailbox full, email deleted by client, POP3 delete email, sent email not saved

---
Part of [Alibaba Mail](https://company-skill.com/p/alimail.md) · https://company-skill.com/llms.txt
