mcpField

sales-transactional-email

github.com/sales-skills开发40 次安装
代码仓库

关于 sales-transactional-email

sales-transactional-email 是面向规划或排查触发式邮件的跨平台技能。它涵盖服务商选择、模板、API 或 SMTP 集成、送达率与监控,并提供多个指定邮件平台的相关指导。

主要功能

  1. 01事务性邮件服务商选择
  2. 02模板设计指导
  3. 03API 与 SMTP 集成建议
  4. 04送达率建议
  5. 05监控与故障排查

适用场景

  1. 01为收据邮件选择服务商
  2. 02集成密码重置邮件
  3. 03改善事务性邮件投递
  4. 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 存在,请先阅读,了解积累的知识。

询问用户:

  1. 你需要哪类事务性邮件方面的帮助?

    • A) 订单确认/收据/发货通知
    • B) 密码重置/账户验证/双重身份验证
    • C) 欢迎邮件/注册触发的引导序列
    • D) 账单/发票/订阅通知
    • E) 提醒/通知邮件(动态、提及、提醒)
    • F) 服务商选择——挑选合适的事务性邮件服务
    • G) 投递问题——邮件未送达、进入垃圾邮件或延迟
    • H) API/SMTP 集成——将应用连接到服务商
    • I) 模板设计——构建可复用的事务性邮件模板
    • J) 监控与分析——跟踪投递、打开和退信
    • K) 其他——请描述
  2. 你目前的配置是什么?

    • A) 还没有服务商——从头开始
    • B) 正在使用 SendGrid
    • C) 正在使用 Postmark
    • D) 正在使用 Mailgun
    • E) 正在使用 Brevo (Sendinblue)
    • F) 正在使用 Customer.io
    • G) 正在使用 Mailchimp / Mandrill
    • H) 正在使用 Amazon SES
    • I) 正在使用其他服务商
    • J) 正在使用自己的 SMTP 服务器
  3. 你的发送量是多少?

    • A) 低(每天 < 1K 封邮件)
    • B) 中(每天 1K-50K 封)
    • C) 高(每天 50K-500K 封)
    • D) 非常高(每天 500K+ 封)

如果用户的请求已经提供了大部分背景信息,请直接进入相关步骤。 基于合理假设(明确说明)先给出尽力而为的答复,然后只在最后询问最关键的 1-2 个澄清问题。

步骤 2 — 策略与方法

事务性邮件与营销邮件

事务性邮件由用户操作或系统事件触发——用户预期会收到,通常是一对一发送。它们不需要营销同意(CAN-SPAM 豁免),但必须确实属于事务性邮件。

事务性邮件营销邮件
订单确认促销活动
密码重置新闻简报
发货通知产品公告
账户验证重新互动活动
发票/收据折扣/促销通知

关键原则:将事务性邮件和营销邮件的发送基础设施分开(使用不同的 IP/域名),以免营销邮件的声誉问题影响事务性邮件的投递。

服务商选择框架
因素SendGridPostmarkMailgunBrevoCustomer.ioSES
最适合规模化发送 + 营销组合优先考虑投递率开发者灵活性一体化 + 营销行为触发大规模发送 + 低成本
投递率良好卓越(98.7%)良好良好良好良好(自行管理)
定价模式按邮件计费按邮件计费按邮件计费按发送量分级按档案计费按邮件计费(最便宜)
免费套餐60 天试用(每天 100 封)每月 100 封每月 1K 封(试用)每天 300 封无前 12 个月每月 3K 封
SMTP 中继是是是是否是
REST API是是是是是是
模板动态(Handlebars)HandlebarsHandlebarsUI 构建器 + APILiquid基础
入站解析是是是是否是
Webhook是(Event Webhook)是(7 种类型)是(8 种事件)是是SNS 通知
模板最佳实践
  1. 保持简洁——交易邮件应清晰明了,而非华而不实
  2. 在首屏展示必要信息——订单号、跟踪链接、操作按钮
  3. 使用动态参数——绝不要将用户专属数据硬编码
  4. 在不同客户端中测试——Outlook、Gmail、Apple Mail 的呈现效果各不相同
  5. 提供纯文本备用版本——部分收件人/客户端需要纯文本
  6. 保持品牌风格一致——使用 Logo、配色和页脚,但不要过度设计
交易邮件的送达率
  1. 使用专用发信域名——使用 mail.example.com 或 notify.example.com,而非主域名
  2. 完成所有身份验证——配置 SPF、DKIM、DMARC(p=quarantine 或 p=reject)
  3. 使用专用 IP——每月发送量达到 50K+ 时,申请专用 IP 并进行预热
  4. 分开发送流量——让交易邮件和营销邮件使用不同的 IP/子域名
  5. 监控退信——立即屏蔽永久退信,并跟踪临时退信模式
  6. 关注投诉率——交易邮件的投诉率应接近 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 步中的策略框架和参考指南中的服务商信息,提供有针对性的建议。

注意事项

  1. 不要让交易邮件和营销邮件共用同一 IP/域名——营销邮件的信誉问题会严重影响交易邮件的送达率。请使用不同的子域名,最好也使用不同的 IP。
  2. “交易邮件”有法律定义——CAN-SPAM 豁免交易邮件的退订要求,但邮件内容必须以交易信息为主。顶部附有 50% 优惠券的订单确认邮件属于营销邮件,而非交易邮件。
  3. SMTP 并非实时发送——SMTP 队列会增加延迟。对于有时效要求的邮件(例如 2FA 验证码、密码重置邮件),请使用 REST API 以加快投递。
  4. Webhook 可能无声失败——如果 Webhook 端点不可用,你将错过投递/退信事件。请实现 Webhook 日志记录和告警。
  5. 不同客户端的模板呈现效果各不相同——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 日志,查看投递失败记录。

评论

支持 Markdown