送达率
在你的用户发现之前,先弄清你的邮件能否进入收件箱。
每封测试邮件都会按收件箱的视角进行检查。满分 10 分的垃圾邮件评分会列出加分项,收件箱会拦截的附件会被标记,邮件在到达前被退回的原因也会说明。“报告”和你的 CI 运行会统计这一切。
Free 套餐 · 垃圾邮件评分和附件检查位于 Labs · 仅为估计,不作保证
检查内容
收件箱会权衡的因素,每封测试邮件都查。
满分 10 分的垃圾邮件评分
由垃圾邮件过滤器权衡的各项特征累加而成,每项都标明分值。5 分及以上表示很可能被拒收或进入垃圾邮件;1.5 分及以上可能进入垃圾邮件。位于 Labs。
收件箱会拦截的附件
Gmail 会拦截的程序,或伪装成文档名称的程序,会判为失败。带宏的 Office 文件、HTML 页面和压缩包会收到警告。检查结果只写文件类型,从不写文件本身。位于 Labs。
被退回的邮件
当 Cloudflare 的邮件服务器在邮件到达我们之前拒收它时,比如因为 DMARC 检查失败,或地址无法识别,收件箱和“故障排查”会说明发生了什么以及原因。
SPF、DKIM 和 DMARC
发送服务器是否有权代表该域名发信、邮件是否已签名,以及是否通过发件人域名的 DMARC 策略。失败时会指出需要修复的域名。
便于阅读
有纯文本版本,大小低于 Gmail 截断邮件的 102 KB,不只是图片,并且布局适配手机。
在你查看的地方统计
“报告”会为每个项目统计很可能是垃圾邮件、可能是垃圾邮件、有害附件和被退回的邮件。运行报告的第一行会说明有多少封邮件很可能进入垃圾邮件。
工作原理
从“已发送”到“能送达”。
开启功能
垃圾邮件评分和附件检查目前处于 Labs 阶段。在 Account settings → Labs 中开启“垃圾邮件评分和附件检查”。
发送测试邮件
用测试地址注册、重置密码或触发优惠,可以手动操作、在测试中运行,或交给你的智能体。
查看评分及原因
收件箱会显示邮件的垃圾邮件评分、带来加分的特征、有风险的附件,以及 Cloudflare 自己的垃圾邮件判定。
在 CI 中发现问题
失败的 spam_risk 或 harmful_attachment 检查会出现在 failed 中,所以会让邮件进入垃圾邮件的模板改动会让你的测试和构建失败。
在你的测试中
邮件会进入垃圾邮件时,让构建失败。
checkEmail(Python check_email,智能体使用 check_email)返回判定结果,从不返回邮件正文。在 Labs 中开启“垃圾邮件评分和附件检查”后,其返回结果会包含带有评分和特征的 spam_risk。完整说明见开发者文档。
Playwright 配合 npm 包
const submitted = new Date();
await page.getByRole('button', { name: 'Create account' }).click();
await qa.waitForLink(address, { since: submitted });
const result = await qa.checkEmail(address, { since: submitted, expectHost: 'staging.acme.dev' });
const spam = result.checks.find((c) => c.check === 'spam_risk');
// Say what to fix: each marker with its points.
expect(result.failed, JSON.stringify(spam?.markers)).not.toContain('spam_risk');
expect(result.failed).not.toContain('harmful_attachment');pytest 配合 Python 辅助工具
from proxymail_qa import check_email, create_address, now, wait_for_link
def test_welcome_email_reaches_the_inbox(page):
address = create_address()["address"]
submitted = now()
page.goto("/sign-up")
page.get_by_label("Email").fill(address)
page.get_by_role("button", name="Create account").click()
wait_for_link(address, since=submitted)
result = check_email(address, since=submitted)
assert "spam_risk" not in result["failed"], result["checks"]
assert "dmarc" not in result["failed"]坦诚说明局限
这是谨慎的估计,我们也会如实说明。
-
基于邮件本身的估计
评分来自邮件所呈现的内容。收件箱还会权衡发件人的信誉和历史,这些只有它们能看到。
-
每项特征都有说明
你能看到每一项加分内容及其分值,例如没有 DKIM、使用了短链接,或主题全是大写,这样你就知道该修复什么。
-
为智能体提供判定结果
测试和智能体会获得检查结果、评分和特征,从不获得邮件正文。
-
不额外发送任何内容
Proxy Mail QA 只检查你的应用已发往测试地址的邮件。它从不转发邮件,也不会为了测试把邮件发往其他地方。
-
由你决定是否开启
垃圾邮件评分和附件检查位于 Labs,所以只有在你开启后,才会评判你的邮件和你的 CI。
-
仅限测试站点
用于你构建或可能测试的应用的开发、预发布、QA、预览和本地版本。
FAQ
常见问题
它能告诉我邮件在 Gmail 或 Outlook 是否会进入垃圾邮件吗?
它会给出估计。评分累加垃圾邮件过滤器权衡的特征,例如 DMARC 检查失败、没有 DKIM、Gmail 会拦截的附件,或营销邮件没有 List-Unsubscribe 邮件头。满分 10 分中得 5 分及以上表示很可能被拒收或进入垃圾邮件。真实的收件箱还会权衡发件人的信誉,这只有它们能看到,所以请把它当作发布前的检查,而不是保证。
为什么垃圾邮件评分位于 Labs?
这是新功能,可能会让之前通过的检查失败。Labs 让你自己选择何时开始用它评判你的邮件和 CI。在 Account settings → Labs 中开启“垃圾邮件评分和附件检查”;它也会作用于你的 API 密钥 和智能体。
“被退回”是什么意思?
负责接收我们域名邮件的 Cloudflare 邮件服务器在邮件到达 Proxy Mail QA 之前拒收了它,例如因为未通过发件域名的 DMARC 策略,或发往的地址格式无法识别。收件箱、“故障排查”和 check_delivery 会说明具体原因,“报告”会统计这些邮件。这不在 Labs 中。
它会检查附件内容吗?
不会。它只查看每个附件的名称和类型,结果中只写文件类型。文件本身从不保留。