---

name: postmark-automation description: "通过 Rube MCP (Composio) 自动化 Postmark 邮件投递任务：发送模板邮件、管理模板、监控投递统计和退信。始终先搜索工具以获取当前模式。" risk: critical source: community date_added: "2026-02-27"

通过 Rube MCP 实现 Postmark 自动化

通过 Composio 的 Postmark 工具包经由 Rube MCP 自动化 Postmark 事务性邮件操作。

前提条件

• Rube MCP 必须已连接（RUBE_SEARCH_TOOLS 可用）
• 通过 RUBE_MANAGE_CONNECTIONS 使用 toolkit postmark 建立活跃的 Postmark 连接
• 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具模式

设置

获取 Rube MCP：在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥。

1. 通过确认 RUBE_SEARCH_TOOLS 响应来验证 Rube MCP 可用
2. 使用 toolkit postmark 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接不是 ACTIVE 状态，按照返回的认证链接完成 Postmark 认证
4. 在运行任何工作流之前确认连接状态显示 ACTIVE

核心工作流

1. 发送模板批量邮件

何时使用：用户想在一次调用中向多个收件人发送模板邮件

工具序列：

1. POSTMARK_LIST_TEMPLATES - 查找可用模板及其 ID [前提]
2. POSTMARK_VALIDATE_TEMPLATE - 发送前用模型数据验证模板 [可选]
3. POSTMARK_SEND_BATCH_WITH_TEMPLATES - 使用模板发送批量邮件 [必需]

关键参数：

• TemplateId 或 TemplateAlias：要使用的模板标识符
• Messages：包含 From、To、TemplateModel 的消息对象数组
• TemplateModel：匹配模板变量的键值对

注意事项：

• 每次批量调用最多 500 条消息
• 需要 TemplateId 或 TemplateAlias 之一，不能同时使用
• TemplateModel 键必须与模板变量名完全匹配（区分大小写）
• 发件人地址必须是已验证的发件人签名或来自已验证的域

2. 管理邮件模板

何时使用：用户想创建、编辑或检查邮件模板

工具序列：

1. POSTMARK_LIST_TEMPLATES - 列出所有模板及其 ID 和名称 [必需]
2. POSTMARK_GET_TEMPLATE - 获取完整模板详情包括 HTML/文本正文 [可选]
3. POSTMARK_EDIT_TEMPLATE - 更新模板内容或设置 [可选]
4. POSTMARK_VALIDATE_TEMPLATE - 用示例数据测试模板渲染 [可选]

关键参数：

• TemplateId：用于 GET/EDIT 操作的数字模板 ID
• Name：模板显示名称
• Subject：邮件主题行（支持模板变量）
• HtmlBody：模板的 HTML 内容
• TextBody：纯文本回退内容
• TemplateType：Standard 或 Layout

注意事项：

• 模板 ID 是数字整数，不是字符串
• 编辑模板会替换全部内容；包含所有你想保留的字段
• Layout 模板包裹 Standard 模板；更改 layout 会影响所有关联模板
• 发送前验证以尽早发现缺失变量

3. 监控投递统计

何时使用：用户想检查邮件投递健康状况、打开/点击率或出站概览

工具序列：

1. POSTMARK_GET_DELIVERY_STATS - 按类型获取退信计数 [必需]
2. POSTMARK_GET_OUTBOUND_OVERVIEW - 获取已发送/已打开/已点击/已退信摘要 [必需]
3. POSTMARK_GET_TRACKED_EMAIL_COUNTS - 获取跟踪邮件量随时间变化 [可选]

关键参数：

• fromdate：过滤统计的开始日期 (YYYY-MM-DD)
• todate：过滤统计的结束日期 (YYYY-MM-DD)
• tag：按消息标签过滤统计
• messagestreamid：按消息流过滤（例如 outbound, broadcast）

注意事项：

• 日期参数使用 YYYY-MM-DD 格式，不含时间部分
• 统计是聚合的；单个消息跟踪需要单独的 API 调用
• 未指定时 messagestreamid 默认为所有流

4. 管理退信和投诉

何时使用：用户想查看退信邮件或垃圾邮件投诉

工具序列：

1. POSTMARK_GET_BOUNCES - 列出退信消息及详情 [必需]
2. POSTMARK_GET_SPAM_COMPLAINTS - 列出垃圾邮件投诉记录 [可选]
3. POSTMARK_GET_DELIVERY_STATS - 获取退信摘要计数 [可选]

注意事项：

• 退信类型包括：HardBounce、SoftBounce、SpamNotification、SpamComplaint、Transient 等
• 硬退信表示永久投递失败；这些地址应被移除
• 垃圾邮件投诉影响发件人信誉；定期监控
• 分页使用 count 和 offset，不是页面令牌

限制

• 仅在任务明确匹配上述范围时使用此技能。
• 不要将输出视为环境特定验证、测试或专家审查的替代品。