SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场sales-mailgun

sales-mailgun

营销与增长

查看项目

更新于 10-16 02:42

技能介绍

Mailgun（Sinch）平台帮助技能，面向需要解答 Mailgun 平台问题的用户。Mailgun 是一个面向开发者的交易型邮件 API 服务，2010 年由 Ev Kontsevoy 和 Taylor Wakefield 创立，先后被 Rackspace（2012）、Thoma Bravo（2019）和 Sinch（2021）收购。Josh Odom 是 Sinch 开发者与邮件部门的 President。

用途 该技能用于协助用户处理 Mailgun 平台相关问题，覆盖从通过 REST API 和 SMTP 中继发送交易邮件，到入站邮件路由、模板、邮件列表、域名、路由、Webhook、指标以及 Mailgun Optimize 等模块。

主要能力

  • 邮件 API：通过 REST API（POST /v3/{domain}/messages）或 SMTP 中继发送交易邮件。
  • SMTP 中继：传统 SMTP 集成（端口 25/465/587）。
  • 入站邮件路由：接收并解析来信，支持自定义规则（正则/JSONPath），通过 Webhook 投递并携带附件。
  • 模板：账户级和域名级存储模板，使用类 Handlebars 变量。
  • 邮件列表：以编程方式管理列表及成员增删改查。
  • 域名 API：域名管理、DNS 验证、DKIM/SPF 设置。
  • 路由：将入站邮件转发到 HTTP 端点或邮箱地址，或存储 3 天。
  • Webhook：事件通知（accepted、delivered、opened、clicked、permanent_fail、temporary_fail、complained、unsubscribed）。
  • 指标 API：送达率、互动和发送健康度分析。
  • Mailgun Optimize：收件箱投放种子测试、邮箱验证（单个 + 批量 CSV）、发件人声誉监控、黑名单告警。
  • 标签：对发送进行分类和跟踪。
  • 账户/计费：计划、价格、API 密钥、自定义消息限额。

使用方式 技能首先收集上下文：询问用户需要 Mailgun 的哪个领域（邮件 API、SMTP 中继、入站路由、模板、邮件列表、域名 API、路由、Webhook、指标 API、Optimize、标签、账户/计费或其他）、用户的角色（开发者、DevOps、管理员、创始人、代理/自由职业者等）以及具体目标。若请求已提供足够上下文，则直接给出最佳答案并说明假设，最后只问 1-2 个关键澄清问题。若请求匹配专门技能，则路由到相应技能，例如送达率策略到 /sales-deliverability、跨平台邮件营销到 /sales-email-marketing、邮件打开/点击追踪到 /sales-email-tracking、SendGrid 到 /sales-sendgrid、Postmark 到 /sales-postmark、通过 Zapier 或中间件集成到 /sales-integration、漏斗策略到 /sales-funnel。否则基于平台知识直接回答。

具体操作指引包括：

  • 通过 API 发送交易邮件：注册账户并复制 API 密钥；添加并验证发送域名（MX、SPF TXT 含 include:mailgun.org、DKIM CNAME/TXT）；等待 DNS 传播并在 UI 或通过 GET /v3/domains/{domain} 验证；使用 Basic Auth（api:YOUR_API_KEY）POST /v3/{domain}/messages，传入 from、to、subject、text/html；可为生产创建 Domain Sending Key 限制密钥仅用于 /messages 端点；添加标签（o:tag）和自定义变量（v:my-var）；通过 Events API（GET /v3/{domain}/events）或 Webhook 监控投递。
  • 设置入站邮件路由：为接收域名添加指向 Mailgun 入站服务器的 MX 记录；在 UI 验证域名；通过 API（POST /v3/routes）或 UI 创建路由，定义匹配表达式和动作；匹配表达式如 match_recipient("support@yourdomain.com")、match_header("subject", ".order.")、catch_all()；动作如 forward("https://yourapp.com/webhook")、forward("team@company.com")、store(notify="https://yourapp.com/notify")；实现 Webhook 端点接收 multipart/form-data 解析后的邮件（发件人、主题、正文、附件）；使用正则或 JSONPath 自定义解析规则。
  • 设置域名级模板：POST /v3/{domain}/templates 创建模板，含名称、描述和初始版本内容；使用类 Handlebars 变量如 {{first_name}}、{{order_number}}、{{items}}；创建额外版本用于 A/B 测试或迭代；发送时包含 template 参数和 h:X-Mailgun-Variables JSON 数据对象；通过 Templates API 以编程方式管理模板。
  • 配置 Webhook 跟踪投递：POST /v3/domains/{domain}/webhooks 创建 Webhook，指定事件类型和端点 URL；实现端点接收 JSON 负载；使用 API 密钥验证 Webhook 签名；处理批量投递（单次 POST 可能包含多个事件）；快速返回 200 状态码，将重处理移至后台队列；为全部 8 种事件类型设置 Webhook 以获得完整可见性。
  • 使用 Mailgun Optimize 提升送达率：订阅 Optimize 附加计划（Pilot 49 美元/月或 Starter 99 美元/月），与 Send 计划分开；运行收件箱投放测试，向 Mailgun 种子列表发送测试邮件，查看各服务商收件箱与垃圾箱结果；发送前验证邮箱地址：GET /v4/address/validate?address=user@example.com，返回风险等级（deliverable、undeliverable、risky、unknown）；通过 CSV 上传批量验证以清理列表；在 Optimize 仪表板监控发件人声誉和黑名单状态；设置黑名单告警。

适用场景 适用于开发者、DevOps、管理员、创始人、代理/自由职业者等需要集成或运维 Mailgun 交易邮件、入站邮件处理、模板管理、Webhook 事件跟踪、送达率诊断与优化的场景。

限制与注意事项

  • 美国与欧盟区域需要正确的 base URL，域名创建后无法切换。美国域名使用 https://api.mailgun.net/v3/，欧盟域名使用 https://api.eu.mailgun.net/v3/。一旦在某个区域创建域名，就无法迁移到另一区域。如需 GDPR 合规的欧盟数据驻留，应从一开始就在欧盟区域创建域名。使用错误的 base URL 会返回令人困惑的认证错误。
  • Mailgun Optimize 是单独的付费附加项（49 美元+/月），不包含在任何 Send 计划中。收件箱投放种子测试、邮箱验证、发件人声誉监控和黑名单告警都需要在 Send 计划之上订阅 Optimize。Foundation 或 Scale 计划不包含这些功能。
  • Domain Sending Key 只能发送邮件，不能管理域名、路由或 Webhook。如果应用需要创建路由、管理域名或配置 Webhook，必须使用主 API 密钥。Domain Sending Key 出于安全隔离仅限 /messages 端点。将其用于其他 API 调用会返回 401 错误。
  • 专用 IP 每个 59 美元/月且需要预热，不默认包含。专用 IP 是 Scale 和 Enterprise 计划上的附加项。新专用 IP 没有声誉，必须逐步预热（从低量开始，2-4 周内增加）。在冷专用 IP 上高量发送会导致送达率差。对于较低量，Mailgun 的共享 IP 池通常效果更好。
  • 免费计划为每天 100 封邮件（不是每月），对测试非常有限。如果需要以任何有意义的规模测试批量发送、Webhook 处理或模板渲染，至少需要 Foundation 计划（35 美元/月，50,000 封/月）。每日限额在 UTC 午夜重置。
  • 技能内容为基于研究的最佳努力，涉及计划门控功能和集成陷阱的条目可能已过时，需自行复核。

相关技能 /sales-deliverability（跨平台邮件送达率 — SPF/DKIM/DMARC、预热、收件箱投放）、/sales-email-marketing（跨工具的选择加入邮件营销策略）、/sales-email-tracking（邮件互动追踪策略）、/sales-integration（通过 Webhook/Zapier 将 Mailgun 连接到 CRM、Slack 等）、/sales-sendgrid（SendGrid 平台帮助 — Mailgun 主要竞争对手）、/sales-postmark（Postmark 平台帮助 — Mailgun 主要竞争对手）、/sales-customerio（Customer.io 平台帮助 — 使用类似 Mailgun 的 API 处理交易邮件）、/sales-do（不确定使用哪个技能时的路由器，安装：npx skills add sales-skills/sales --skill sales-do）。