用途:在 Cloudflare 平台上发送事务性邮件并路由接收邮件,覆盖 Workers 绑定、REST API、Agents SDK 与 CLI/MCP 等场景。资料强调该产品 2025 年推出且快速演进,应优先检索官方来源而非依赖预训练知识;若与本技能有出入,以 Cloudflare 文档、REST API 规范、@cloudflare/workers-types 和 Agents SDK 仓库为准。
主要能力:从 Worker 通过 send_email 绑定发送邮件(无需 API 密钥);从 Agents SDK 智能体用 onEmail() 与 replyToEmail() 发送;从外部应用用带 Bearer token 的 REST API 发送;用 Workers email() 处理器接收并处理来信(Email Routing);通过 wrangler 或 Dashboard 启用 Email Sending / Email Routing;改善送达率。
使用方式:先检查前置条件——用 npx wrangler email sending list 查看已启用域名,未列出则运行 npx wrangler email sending enable userdomain.com;在 wrangler.jsonc 配置 send_email 绑定;接收/解析邮件需安装 postal-mime。Workers 绑定示例:在 wrangler.jsonc 写入 { "send_email": [{ "name": "EMAIL" }] },再调用 env.EMAIL.send(),from 域名须已启用。REST API 端点为 POST https://api.cloudflare.com/client/v4/accounts/{account_id}/email/sending/send,from 用 address 字段,replyTo 写作 reply_to,响应返回 delivered、permanent_bounces、queued。
适用场景:Worker 或 Agents SDK 中的事务性邮件、外部应用发信、接收与转发来信、首次配置与送达率优化。
限制与注意:仅用于事务性邮件,营销/批量发送需另用平台;from 域名必须先在 Email Sending 启用;message.raw 只能读取一次,需先缓冲;应同时提供 html 与 text;message.forward() 仅支持已验证地址;开发时勿用虚假地址;勿硬编码 API token;REST API 与 Workers 绑定字段命名不同。具体价格、限额等细节资料未提供,需查阅官方文档。