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

postmark-automation

办公与效率

查看项目

更新于 10-15 08:02

技能介绍

Postmark Automation 通过 Rube MCP（Composio）的 Postmark 工具包，自动化 Postmark 事务邮件的各项操作。

用途 该技能面向需要通过工具调用方式操作 Postmark 的用户，覆盖邮件发送、模板管理、投递统计监控、退信与投诉处理以及服务器配置等任务。

前置条件

  • 必须已连接 Rube MCP（RUBE_SEARCH_TOOLS 可用）。
  • 需通过 RUBE_MANAGE_CONNECTIONS 激活 Postmark 连接，工具包为 postmark。
  • 每次操作前应先调用 RUBE_SEARCH_TOOLS 获取当前工具结构。

设置方式

  1. 获取 Rube MCP：在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器，无需 API 密钥，添加端点即可使用。
  2. 确认 RUBE_SEARCH_TOOLS 有响应，以验证 Rube MCP 可用。
  3. 调用 RUBE_MANAGE_CONNECTIONS，工具包为 postmark。
  4. 若连接不是 ACTIVE，按返回的授权链接完成 Postmark 认证。
  5. 确认连接状态为 ACTIVE 后再运行工作流。

核心工作流

  1. 发送模板化批量邮件 适用场景：用户希望在一次调用中向多个收件人发送模板邮件。 工具顺序：POSTMARK_LIST_TEMPLATES（查找可用模板及其 ID，前置）、POSTMARK_VALIDATE_TEMPLATE（发送前用模型数据验证模板，可选）、POSTMARK_SEND_BATCH_WITH_TEMPLATES（使用模板发送批量邮件，必需）。 关键参数：TemplateId 或 TemplateAlias（模板标识）、Messages（包含 From、To、TemplateModel 的消息对象数组）、TemplateModel（与模板变量匹配的键值对）。 注意事项：每次批量调用最多 500 条消息；TemplateId 与 TemplateAlias 只能二选一；TemplateModel 键必须与模板变量名完全一致（区分大小写）；发件地址必须是已验证的 Sender Signature 或来自已验证域名。

  2. 管理邮件模板 适用场景：用户希望创建、编辑或查看邮件模板。 工具顺序：POSTMARK_LIST_TEMPLATES（列出所有模板及 ID 和名称，必需）、POSTMARK_GET_TEMPLATE（获取含 HTML/文本正文的完整模板详情，可选）、POSTMARK_EDIT_TEMPLATE（更新模板内容或设置，可选）、POSTMARK_VALIDATE_TEMPLATE（用示例数据测试模板渲染，可选）。 关键参数：TemplateId（GET/EDIT 用的数字模板 ID）、Name（模板显示名称）、Subject（邮件主题，支持模板变量）、HtmlBody（HTML 内容）、TextBody（纯文本回退内容）、TemplateType（'Standard' 或 'Layout'）。 注意事项：模板 ID 是数字整数而非字符串；编辑模板会替换全部内容，需包含所有要保留的字段；Layout 模板包裹 Standard 模板，修改布局会影响所有关联模板；发送前验证可提前发现缺失变量。

  3. 监控投递统计 适用场景：用户希望检查邮件投递健康度、打开/点击率或出站概览。 工具顺序：POSTMARK_GET_DELIVERY_STATS（按类型获取退信计数，必需）、POSTMARK_GET_OUTBOUND_OVERVIEW（获取发送/打开/点击/退信摘要，必需）、POSTMARK_GET_TRACKED_EMAIL_COUNTS（获取随时间变化的跟踪邮件量，可选）。 关键参数：fromdate（统计起始日期，YYYY-MM-DD）、todate（统计结束日期，YYYY-MM-DD）、tag（按消息标签过滤）、messagestreamid（按消息流过滤，如 'outbound'、'broadcast'）。 注意事项：日期参数使用 YYYY-MM-DD 格式，不含时间部分；统计为聚合数据，单条消息跟踪需单独 API 调用；未指定 messagestreamid 时默认所有流。

  4. 管理退信与投诉 适用场景：用户希望查看退信邮件或垃圾邮件投诉。 工具顺序：POSTMARK_GET_BOUNCES（列出退信消息及详情，必需）、POSTMARK_GET_SPAM_COMPLAINTS（列出垃圾邮件投诉记录，可选）、POSTMARK_GET_DELIVERY_STATS（获取退信摘要计数，可选）。 关键参数：count（每页返回记录数）、offset（分页偏移）、type（退信类型过滤，如 'HardBounce'、'SoftBounce'、'SpamNotification'）、fromdate/todate（日期范围过滤）、emailFilter（按收件人邮箱过滤）。 注意事项：退信类型包括 HardBounce、SoftBounce、SpamNotification、SpamComplaint、Transient 等；硬退信表示永久投递失败，应移除这些地址；垃圾邮件投诉影响发件人声誉，需定期监控；分页使用 count 和 offset，而非页令牌。

  5. 配置服务器设置 适用场景：用户希望查看或修改 Postmark 服务器配置。 工具顺序：POSTMARK_GET_SERVER（获取当前服务器设置，必需）、POSTMARK_EDIT_SERVER（更新服务器配置，可选）。 关键参数：Name（服务器显示名称）、SmtpApiActivated（启用/禁用 SMTP API 访问）、BounceHookUrl（退信通知 Webhook URL）、InboundHookUrl（入站邮件处理 Webhook URL）、TrackOpens（启用/禁用打开跟踪）、TrackLinks（链接跟踪模式：'None'、'HtmlAndText'、'HtmlOnly'、'TextOnly'）。 注意事项：服务器编辑影响通过该服务器发送的所有消息；Webhook URL 必须是可公开访问的 HTTPS 端点；更改 SmtpApiActivated 会立即影响 SMTP 中继访问；跟踪设置仅对后续消息生效，不追溯。

常见模式 模板变量解析：调用 POSTMARK_GET_TEMPLATE 并传入 TemplateId；检查 HtmlBody/TextBody 中的 {{variable}} 占位符；构建键匹配的 TemplateModel 字典；调用 POSTMARK_VALIDATE_TEMPLATE 验证渲染。 分页：设置 count 为每页结果数（因端点而异）；使用 offset 跳过已获取结果；每页将 offset 增加 count，直到返回结果少于 count；总记录数可能在响应元数据中返回。

已知注意事项 认证：Postmark 使用服务器级 API 令牌而非账户级；每个服务器有自己的令牌，需确保正确的服务器上下文；发件地址必须是已验证的 Sender Signature 或来自已验证域名。 速率限制：批量发送每次调用最多 500 条消息；API 速率限制因端点而异，遇到 429 响应应实现退避。 响应解析：响应数据可能嵌套在 data 或 data.data 下，需用回退模式防御性解析；模板 ID 始终是数字整数。

快速参考

  • 发送批量模板邮件：POSTMARK_SEND_BATCH_WITH_TEMPLATES，关键参数 Messages、TemplateId/TemplateAlias。
  • 列出模板：POSTMARK_LIST_TEMPLATES，关键参数 Count、Offset、TemplateType。
  • 获取模板详情：POSTMARK_GET_TEMPLATE，关键参数 TemplateId。
  • 编辑模板：POSTMARK_EDIT_TEMPLATE，关键参数 TemplateId、Name、Subject、HtmlBody。
  • 验证模板：POSTMARK_VALIDATE_TEMPLATE，关键参数 TemplateId、TemplateModel。
  • 投递统计：POSTMARK_GET_DELIVERY_STATS，关键参数无或日期过滤。
  • 出站概览：POSTMARK_GET_OUTBOUND_OVERVIEW，关键参数 fromdate、todate、tag。
  • 获取退信：POSTMARK_GET_BOUNCES，关键参数 count、offset、type、emailFilter。
  • 获取垃圾邮件投诉：POSTMARK_GET_SPAM_COMPLAINTS，关键参数 count、offset、fromdate、todate。
  • 跟踪邮件计数：POSTMARK_GET_TRACKED_EMAIL_COUNTS，关键参数 fromdate、todate、tag。
  • 获取服务器配置：POSTMARK_GET_SERVER，关键参数无。
  • 编辑服务器配置：POSTMARK_EDIT_SERVER，关键参数 Name、TrackOpens、TrackLinks。