Spam Filtering Playbook¶
Symptom: Emails landing in spam folders.
Hypotheses¶
| Hypothesis | Likely Cause | Evidence Tag |
|---|---|---|
| Missing DMARC | Lack of DMARC policy makes emails look suspicious to major providers | [Measured] |
| Content triggers | Subject lines or body text contain common spam keywords | [Inferred] |
| IP reputation | The ACS outbound IP address is on a blocklist | [Correlated] |
| Warm-up needed | Sudden high volume from a new domain triggers spam filters | [Observed] |
flowchart TD
S["Emails landing in spam"] --> H1{"DMARC published?"}
H1 -- no --> R1["Publish DMARC with aligned policy"]
H1 -- yes --> H2{"Content triggers filters?"}
H2 -- yes --> R2["Simplify content and avoid spam keywords"]
H2 -- no --> H3{"IP reputation or warm-up lacking?"}
H3 -- yes --> R3["Warm up sending volume gradually"]
H3 -- no --> EV["Collect evidence: delivery reports, mail-tester score"]
EV --> M["Apply mitigation and re-test inbox placement"] Evidence Collection¶
1. Delivery Reports¶
Filter ACSEmailStatusUpdateOperational for DeliveryStatus in ("FilteredSpam", "Quarantined") on recipient-level rows (isnotempty(RecipientId)) and inspect EnhancedSmtpStatusCode for the provider's reason. See the ACS Email Logs schema for documented status values.
2. External Tools¶
Use mxtoolbox.com to check if your domain or IP is on any major blocklists.
3. Mail-Tester¶
Send a test email to mail-tester.com to get a detailed spam score.
Validation¶
[Measured] Monitor DMARC Status¶
Verify that a DMARC TXT record exists (e.g., v=DMARC1; p=none;). Most major providers (Gmail, Outlook) now require DMARC for improved deliverability.
[Inferred] Check Content Keywords¶
Identify if the email subject or body contains phrases like "ACT NOW", "FREE", or multiple exclamation marks.
[Correlated] Review IP Reputation¶
If multiple clients are reporting spam from your domain, check if the outbound ACS IP range has been flagged.
Mitigation¶
- Implement DMARC: Add a DMARC policy to your DNS (start with
p=noneand move top=quarantine). - Improve Content: Avoid spammy language and use professional templates with a clear sender name.
- Warm-up Domain: Gradually increase sending volume over several weeks to build reputation.
- Use Subdomains: Use a separate subdomain (e.g.,
info.yourdomain.com) for marketing emails to protect your root domain's reputation. - Monitor Feedback Loops: Subscribe to feedback loops from major providers to identify and remove users who flag your emails as spam.
See Also¶
Sources¶
- Azure Communication Services Email Deliverability Best Practices
- Sender Policy Framework (SPF) and DomainKeys Identified Mail (DKIM)