Cloudflare Skills Email Service在Workers中发送与路由事务性邮件的实战指南【免费下载链接】skillsSkills for teaching agents how to build on Cloudflare.项目地址: https://gitcode.com/gh_mirrors/skills14/skillsCloudflare Skills Email Service是 Cloudflare Skills 仓库中专为 AI Agent 提供的邮件能力技能包帮助你在 Cloudflare Workers 中快速实现事务性邮件发送Email Sending与邮件路由Email Routing——无需自建 SMTP、无需管理 API 密钥一条wrangler命令即可接入。为什么选 Cloudflare Email Service2025 年推出的 Cloudflare Email Service 把邮件基础设施直接搬进了 Cloudflare 平台。它由两大能力组成能力作用典型场景Email Sending从 Worker 发送事务性邮件注册通知、密码重置、订单确认Email Routing接收并程序化处理入站邮件支持邮箱、自动回复、AI 收件箱对新手而言最大的好处是域名接入时 Cloudflare 会自动配置 SPF 与 DKIM 记录软性失败自动重试、硬性退信自动加入抑制列表你几乎不用操心反垃圾邮件认证的事。⚠️ 注意Email Service 只支持事务性邮件由用户行为触发不允许营销群发。第一步域名接入最快方法写任何邮件代码前先确认域名已接入。两种方式任选其一方式一CLI推荐npx wrangler email sending list # 查看已接入域名 npx wrangler email sending enable yourdomain.com npx wrangler email sending dns get yourdomain.com # 核对 SPF/DKIM 记录方式二Dashboard进入Compute AI Email Service Email Sending选择Onboard Domain平台会自动添加 SPFTXT与 DKIMCNAME/TXT记录DNS 通常在 5–15 分钟内生效。完整的命令清单与 MCP 管理方式见 cli-and-mcp.md。Workers 中发送邮件Binding 优先仓库技能的核心建议是在 Worker 中优先使用原生send_emailbinding而不是 REST API——binding 不需要 API 密钥只需在wrangler.jsonc中声明{ send_email: [{ name: EMAIL }] }随后在代码里通过env.EMAIL.send(...)发送支持多收件人、CC/BCC、附件与自定义头。发送响应会即时返回投递反馈delivered/permanent_bounces/queued方便记录送达指标。你的场景推荐路径参考资料Worker 中发送邮件send_emailbindingsending.md外部应用Node/Go/Python发送REST API Bearer tokenrest-api.md命令行 / 编码 Agent 发送wrangler email sending sendcli-and-mcp.md本地开发小技巧在 binding 配置中加remote: truewrangler dev时就会真实发信记得用你自己可控的测试地址部署前移除该配置。路由入站邮件email() 处理器接收邮件则完全相反——不需要任何 binding只需在 Worker 中导出一个email()函数再用路由规则把收件地址连到你的 Workermessage.forward()— 转发到已验证的地址message.setReject()— 以永久 SMTP 错误拒信message.reply()— 直接回复message.raw— 原始 MIME 流只能读一次先 buffer 再解析一个非常实用的进阶模式是存储后回复Human-in-the-Loopemail()处理器解析邮件后存入 Durable ObjectSQLite并立即返回由人工或 AI Agent 稍后审阅、再通过send_emailbinding 回复——每个邮箱地址对应一个 DO 实例天然隔离。该架构与 [postal-mime] 解析流程的详细实现见 routing.md。如果你在用 Cloudflare Agents SDK。提升送达率让邮件远离垃圾箱Cloudflare 已托管了大部分认证工作SPF、DKIM、IP 信誉、软退重试、抑制列表、反馈回路你只需做好三件事内容规范同时提供 HTML 与纯文本版本使用可识别的发件人名标题诚实避免全大写列表质量发送前校验地址、订阅采用双重确认、及时响应退订补一条 DMARC 记录如还没有vDMARC1; pquarantine; ruamailto:dmarc-reportsyourdomain.com监控方面每次发送都会返回即时投递结果账号级分析、抑制列表查询与 GraphQL 分析 API 的完整用法都整理在 deliverability.md。核心指标建议值指标目标不达标时送达率 95%检查无效地址与 DNS 记录硬退信率 2%清洗邮件列表投诉率 0.1%简化退订、停止非预期邮件新手最常见的 5 个坑技能文档总结的 Common Mistakes 里最值得提前记住的是这几条坑后果修复忘记在 wrangler 配置中声明send_emailbinding发送直接报错加send_email: [{ name: EMAIL }]从未接入的域名发信发送被拒先运行wrangler email sending enable两次读取message.raw第二次读到空先new Response(message.raw).arrayBuffer()缓存转发到未验证地址静默失败先用wrangler email routing addresses create验证用假地址测试退信伤害发件人信誉开发期只用自己可控的真实地址完整避坑表见技能主文件 SKILL.md。参考资料导航技能遵循检索优先于预训练原则遇到不确定时以官方文档为准。仓库内相关路径一览技能入口与任务导航SKILL.mdWorkers binding 与 Agents SDK 发送sending.mdREST API 集成rest-api.md入站路由与解析routing.md域名接入、CLI 与 MCPcli-and-mcp.md送达率与反垃圾实践deliverability.mdAI Agent 邮件处理email.md想给项目安装整个 Cloudflare Skills 技能集含本邮件技能安装方式见仓库根目录 README.md。小结Cloudflare Skills Email Service 让邮件能力在 Workers 里变得像调用 KV 一样简单——发送用 binding、接收用email()、送达率靠平台托管。按本文顺序走一遍域名接入 → 发送 → 路由 → 送达率半天内即可上线一个可靠的事务性邮件系统。【免费下载链接】skillsSkills for teaching agents how to build on Cloudflare.项目地址: https://gitcode.com/gh_mirrors/skills14/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考