关于 sales-transactional-email
sales-transactional-email 是面向规划或排查触发式邮件的跨平台技能。它涵盖服务商选择、模板、API 或 SMTP 集成、送达率与监控,并提供多个指定邮件平台的相关指导。
主要功能
- 01事务性邮件服务商选择
- 02模板设计指导
- 03API 与 SMTP 集成建议
- 04送达率建议
- 05监控与故障排查
适用场景
- 01为收据邮件选择服务商
- 02集成密码重置邮件
- 03改善事务性邮件投递
- 04监控退信与投递事件
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ sales-skills/ sales --skill sales-transactional-email安装后在 Claude Code 中输入/sales-transactional-email确认已加载。
附带文件references/learnings.mdreferences/platform-guide.md
详细介绍
事务性邮件投递
帮助用户处理事务性/触发式邮件相关问题——从服务商选择和模板设计,到 API 集成、SMTP 中继、送达率和监控。本技能不依赖特定工具,但包含针对 SendGrid、Postmark、Mailgun、Brevo、Customer.io、Mailchimp/Mandrill 和 Amazon SES 的平台专属指南。
步骤 1 — 收集背景信息
如果 references/learnings.md 存在,请先阅读,了解积累的知识。
询问用户:
-
你需要哪类事务性邮件方面的帮助?
- A) 订单确认/收据/发货通知
- B) 密码重置/账户验证/双重身份验证
- C) 欢迎邮件/注册触发的引导序列
- D) 账单/发票/订阅通知
- E) 提醒/通知邮件(动态、提及、提醒)
- F) 服务商选择——挑选合适的事务性邮件服务
- G) 投递问题——邮件未送达、进入垃圾邮件或延迟
- H) API/SMTP 集成——将应用连接到服务商
- I) 模板设计——构建可复用的事务性邮件模板
- J) 监控与分析——跟踪投递、打开和退信
- K) 其他——请描述
-
你目前的配置是什么?
- A) 还没有服务商——从头开始
- B) 正在使用 SendGrid
- C) 正在使用 Postmark
- D) 正在使用 Mailgun
- E) 正在使用 Brevo (Sendinblue)
- F) 正在使用 Customer.io
- G) 正在使用 Mailchimp / Mandrill
- H) 正在使用 Amazon SES
- I) 正在使用其他服务商
- J) 正在使用自己的 SMTP 服务器
-
你的发送量是多少?
- A) 低(每天 < 1K 封邮件)
- B) 中(每天 1K-50K 封)
- C) 高(每天 50K-500K 封)
- D) 非常高(每天 500K+ 封)
如果用户的请求已经提供了大部分背景信息,请直接进入相关步骤。 基于合理假设(明确说明)先给出尽力而为的答复,然后只在最后询问最关键的 1-2 个澄清问题。
步骤 2 — 策略与方法
事务性邮件与营销邮件
事务性邮件由用户操作或系统事件触发——用户预期会收到,通常是一对一发送。它们不需要营销同意(CAN-SPAM 豁免),但必须确实属于事务性邮件。
| 事务性邮件 | 营销邮件 |
|---|---|
| 订单确认 | 促销活动 |
| 密码重置 | 新闻简报 |
| 发货通知 | 产品公告 |
| 账户验证 | 重新互动活动 |
| 发票/收据 | 折扣/促销通知 |
关键原则:将事务性邮件和营销邮件的发送基础设施分开(使用不同的 IP/域名),以免营销邮件的声誉问题影响事务性邮件的投递。
服务商选择框架
| 因素 | SendGrid | Postmark | Mailgun | Brevo | Customer.io | SES |
|---|---|---|---|---|---|---|
| 最适合 | 规模化发送 + 营销组合 | 优先考虑投递率 | 开发者灵活性 | 一体化 + 营销 | 行为触发 | 大规模发送 + 低成本 |
| 投递率 | 良好 | 卓越(98.7%) | 良好 | 良好 | 良好 | 良好(自行管理) |
| 定价模式 | 按邮件计费 | 按邮件计费 | 按邮件计费 | 按发送量分级 | 按档案计费 | 按邮件计费(最便宜) |
| 免费套餐 | 60 天试用(每天 100 封) | 每月 100 封 | 每月 1K 封(试用) | 每天 300 封 | 无 | 前 12 个月每月 3K 封 |
| SMTP 中继 | 是 | 是 | 是 | 是 | 否 | 是 |
| REST API | 是 | 是 | 是 | 是 | 是 | 是 |
| 模板 | 动态(Handlebars) | Handlebars | Handlebars | UI 构建器 + API | Liquid | 基础 |
| 入站解析 | 是 | 是 | 是 | 是 | 否 | 是 |
| Webhook | 是(Event Webhook) | 是(7 种类型) | 是(8 种事件) | 是 | 是 | SNS 通知 |
模板最佳实践
- 保持简洁——交易邮件应清晰明了,而非华而不实
- 在首屏展示必要信息——订单号、跟踪链接、操作按钮
- 使用动态参数——绝不要将用户专属数据硬编码
- 在不同客户端中测试——Outlook、Gmail、Apple Mail 的呈现效果各不相同
- 提供纯文本备用版本——部分收件人/客户端需要纯文本
- 保持品牌风格一致——使用 Logo、配色和页脚,但不要过度设计
交易邮件的送达率
- 使用专用发信域名——使用
mail.example.com或notify.example.com,而非主域名 - 完成所有身份验证——配置 SPF、DKIM、DMARC(p=quarantine 或 p=reject)
- 使用专用 IP——每月发送量达到 50K+ 时,申请专用 IP 并进行预热
- 分开发送流量——让交易邮件和营销邮件使用不同的 IP/子域名
- 监控退信——立即屏蔽永久退信,并跟踪临时退信模式
- 关注投诉率——交易邮件的投诉率应接近 0%
第 3 步——平台专属指南
阅读 references/platform-guide.md,了解详细的服务商对比、API 参考、集成检查清单和关键指标。
使用 MailerLite
MailerLite 将交易邮件作为独立于营销活动的功能提供:
- API 触发:交易邮件通过 MailerLite API 发送,而非使用营销活动构建器。适用于订单确认、密码重置和发货通知。
- 独立基础设施:交易邮件发送量不计入营销邮件限额,并使用独立的投递基础设施。
- 模板:在 MailerLite 控制面板中创建可复用模板,并在 API 调用中通过 ID 引用。
- 限制:与 SendGrid、Postmark 或 Mailgun 相比,MailerLite 的交易邮件功能较为基础。不支持入站解析,也没有高级分析功能;交易邮件不提供专用 IP(仅限 Enterprise)。适合希望在一个平台中处理所有事务的 MailerLite 用户。对于大批量或对延迟敏感的交易邮件,请使用专用服务商。
- API:使用
POST /api/subscribers管理联系人,使用 Webhook 跟踪投递情况。完整 API 参考请参阅/sales-mailerlite。
你无需再了解平台指南的详细内容——请专注于用户的具体情况。
第 4 步——可操作的指导
根据用户的具体问题,结合第 2 步中的策略框架和参考指南中的服务商信息,提供有针对性的建议。
注意事项
- 不要让交易邮件和营销邮件共用同一 IP/域名——营销邮件的信誉问题会严重影响交易邮件的送达率。请使用不同的子域名,最好也使用不同的 IP。
- “交易邮件”有法律定义——CAN-SPAM 豁免交易邮件的退订要求,但邮件内容必须以交易信息为主。顶部附有 50% 优惠券的订单确认邮件属于营销邮件,而非交易邮件。
- SMTP 并非实时发送——SMTP 队列会增加延迟。对于有时效要求的邮件(例如 2FA 验证码、密码重置邮件),请使用 REST API 以加快投递。
- Webhook 可能无声失败——如果 Webhook 端点不可用,你将错过投递/退信事件。请实现 Webhook 日志记录和告警。
- 不同客户端的模板呈现效果各不相同——Outlook 使用 Word 的呈现引擎。请务必在 Litmus 或 Email on Acid 中测试模板,尤其是布局复杂的设计。
- 持续改进:如果发现此处未涵盖的内容,请将其附上当天日期,追加到
references/learnings.md中。
推荐特定平台技能之前
此技能涵盖多个平台的策略领域。在向用户推荐任何特定平台技能之前(即 ## Related skills 中列出的任何 /sales-{platform},例如 /sales-mailshake、/sales-klaviyo、/sales-apollo),请先阅读该平台技能的实际 SKILL.md。## Related skills 中的 1 行描述足以识别候选项,但不足以确定推荐或编写能有效调用该技能的提示词。
如何阅读:
- 如果本地存在
~/.claude/skills/{skill-name}/SKILL.md,请使用Read阅读。 - 对于
sales-*技能,请直接从此仓库使用WebFetch获取:https://raw.githubusercontent.com/sales-skills/sales/main/skills/{skill-name}/SKILL.md— 例如,对于sales-mailshake:https://raw.githubusercontent.com/sales-skills/sales/main/skills/sales-mailshake/SKILL.md。 - 对于非
sales-*技能(第三方技能),如果已安装,请在~/.claude/skills/sales-do/references/skill-sources.md中查找{org}/{repo},并从该仓库下相同的skills/{skill-name}/SKILL.md路径获取文件。
**阅读之后,**请依据 SKILL.md 中的具体内容(其范围、子流程、argument-hint 格式或“Do NOT use for...”负面触发条件)来支撑你的推荐。生成的调用内容应符合平台技能的 argument-hint。如果平台技能不适合用户的情况,请改用其他技能,或直接在此处处理问题,而不是推荐不合适的技能。
相关技能
/sales-iterable— Iterable 平台帮助(事务性邮件的触发式营销活动、Studio journeys、跨渠道)/sales-braze— Braze 平台帮助(事务性邮件 API、Canvas Flow、跨渠道编排)/sales-brevo— Brevo 平台帮助(事务性邮件、营销、CRM)/sales-sendgrid— SendGrid 平台帮助/sales-postmark— Postmark 平台帮助/sales-mailgun— Mailgun 平台帮助/sales-customerio— Customer.io 平台帮助/sales-mailchimp— Mailchimp/Mandrill 平台帮助/sales-getresponse— GetResponse 平台帮助(MAX 方案中的事务性邮件、营销自动化、网络研讨会)/sales-sendpulse— SendPulse 平台帮助(SMTP 事务性邮件、营销自动化、聊天机器人)/sales-deliverability— 跨平台邮件送达率(SPF/DKIM/DMARC、预热、信誉)/sales-mailerlite— MailerLite 平台帮助(邮件营销活动、自动化、事务性邮件、API)/sales-email-marketing— 许可式营销邮件策略(非事务性邮件)/sales-integration— 将邮件工具与 CRM 和其他系统连接/sales-do— 不确定该使用哪项技能?该路由器会将任何销售目标匹配到合适的技能。安装:npx skills add sales-skills/sales --skill sales-do
示例
示例 1:选择事务性邮件服务提供商
用户说:“我们是一家 SaaS 初创公司,每天发送约 5K 封事务性邮件——订单确认、密码重置和活动通知。应该使用哪家服务提供商?” 技能执行:评估发送量(中等)、使用场景(标准事务性邮件)和可能的需求(可靠性、高送达率、合理的成本)。推荐送达率最佳的 Postmark,或灵活性更高的 SendGrid。比较月发送量为 150K 时的价格。 结果:给出明确的推荐及理由、成本比较和后续设置步骤
示例 2:排查送达延迟
用户说:“我们通过 Mailgun 使用 SMTP 发送的密码重置邮件需要 30 多秒才能送达。” 技能执行:判断 SMTP 排队可能是原因。建议将时效性要求高的邮件切换到 REST API。展示用于密码重置的 Mailgun API 示例。建议通过 Webhook 进行监控。 结果:确定根本原因,提供 API 迁移代码和监控设置
示例 3:在 Brevo 中设置事务性邮件
用户说:“如何通过 Brevo API 使用动态订单数据发送订单确认邮件?” 技能的操作:演示如何在 Brevo UI 中创建模板 → 调用 POST /smtp/email,并传入 templateId 和 params → 设置投递 Webhook → 处理错误并实现重试逻辑 结果:实现了包含模板、API 集成和监控的事务性邮件流程
故障排查
事务性邮件被归入垃圾邮件
症状:订单确认邮件或账户邮件被归入垃圾邮件
原因:通常是域名身份验证问题、共享 IP 的信誉不佳,或内容触发了垃圾邮件过滤机制
解决方案:1)确认 SPF/DKIM/DMARC 配置正确。2)检查是否使用信誉不佳的共享 IP,并考虑使用专用 IP。3)检查邮件内容中是否包含触发垃圾邮件过滤的词语。4)确保事务性邮件中未混入营销内容。请参阅 /sales-deliverability。
事务性邮件的退信率过高
症状:事务性邮件的退信率超过 2% 原因:邮件发送至无效地址,例如用户注册时输入了虚假邮箱或拼写错误,或账户已弃用 解决方案:1)在注册时实时验证邮箱地址(使用 ZeroBounce、Kickbox 或服务提供商内置的功能)。2)创建账户时使用双重确认订阅。3)立即屏蔽硬退信地址。4)每季度清理联系人列表。
未收到 Webhook 事件
症状:发送邮件后未收到 Webhook 回调 原因:Webhook 端点配置错误、防火墙阻止了服务提供商的 IP,或 SSL 证书存在问题 解决方案:1)确认 Webhook URL 可从公网访问(不是 localhost)。2)检查端点是否在 5 秒内返回 200。3)如果处于防火墙后方,将服务提供商的 IP 范围加入允许列表。4)检查服务提供商的 Webhook 日志,查看投递失败记录。