（3013期）Mailgun – 托管 OAuth 交易邮件全功能平台

托管 OAuth 交易邮件全功能平台 通过 Maton 代理访问 Mailgun 交易邮件服务，支持发送邮件、管理域名、路由、模板、邮件列表等完整功能，需配置 Maton API Key 进行 OAuth 认证。 使用说明 核心功能 该技能提供完整的 Mailgun API 代理服务，支持： 邮件发送：标准邮件、MIME 格式邮件、模板邮件 域名管理：创建、删除、查看域名及跟踪设置 路由配置：基于收件人、邮件头的自动路由规则 事件追踪：发送状态、打开、点击等事件查询 Webhook 管理：实时接收投递状态回调 模板系统：Handlebars 模板创建与管理 邮件列表：订阅列表管理与成员维护 退信管理：Bounces、Unsubscribes、Complaints 处理 统计分析：按事件类型统计邮件投递数据 显著优点 托管 OAuth 简化认证：无需直接管理 Mailgun API Key，通过 Maton 统一 OAuth 流程 完整功能覆盖：涵盖 Mailgun v3 API 绝大多数功能点 多连接支持：可同时管理多个 Mailgun 账户，通过 Maton-Connection 头切换 区域兼容：默认 US 区域，支持标准 Mailgun 功能 安全审批机制：所有写操作需用户显式确认 潜在局限 区域限制：默认仅代理 US 区域（api.mailgun.net），EU 区域需额外配置 表单编码要求：POST/PUT 需使用 application/x-www-form-urlencoded 而非 JSON，增加开发复杂度 沙箱域名限制：免费账户的沙箱域名只能发送给授权收件人 依赖 Maton 服务：API 可用性绑定 Maton 平台，非直连 Mailgun 事件存储期短：仅保留 3 天，需及时导出或配置 webhook 持久化 适合人群 需要程序化发送交易邮件的开发者/团队 已使用 Mailgun 且希望简化认证流程的企业 需统一管理多个邮件服务账户的技术运营团队 构建邮件自动化工作流的低代码/无代码平台用户 常规风险 | 风险类型 | 说明 | 缓解措施 ||---------|------|---------|| 凭证泄露 | MATONAPIKEY 泄露导致账户被滥用 | 使用环境变量，避免硬编码；定期轮换密钥 || 邮件滥用 | 被利用发送垃圾邮件导致域名声誉受损 | 启用 suppressions 管理；监控发送量和退信率 || 数据泄露 | 邮件内容或收件人列表通过日志暴露 | 避免在日志中记录敏感内容；使用密送(BCC) || 速率限制 | 高频调用触发限流影响业务 | 实现指数退避重试；合理规划发送批次 || OAuth 会话过期 | 长期运行的自动化任务因授权失效中断 | 监控连接状态；设置会话续期提醒 | 原始说明 Mailgun API integration with managed OAuth. Transactional email service for sending, receiving, and tracking emails. Use this skill when users want to send e...