postmark-automation

通过 Rube MCP 自动化 Postmark

通过 Rube MCP 使用 Composio 的 Postmark 工具包，自动处理 Postmark 事务性邮件操作。

前提条件

• 必须已连接 Rube MCP（可使用 RUBE_SEARCH_TOOLS）
• 通过 RUBE_MANAGE_CONNECTIONS 建立有效的 Postmark 连接，工具包为 postmark
• 始终先调用 RUBE_SEARCH_TOOLS，获取当前工具架构

设置

获取 Rube MCP：在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务。MCP 端点仍需要提供方连接，以及已安装的 Rube 服务返回的授权流程；仅添加 URL 并不会授予账户访问权限。

1. 确认 RUBE_SEARCH_TOOLS 有响应，以验证 Rube MCP 可用
2. 调用 RUBE_MANAGE_CONNECTIONS，指定工具包 postmark
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 的键必须与模板变量名称完全匹配（区分大小写）
• 发件人地址必须是已验证的 Sender Signature，或来自已验证的域名

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 模板；更改布局会影响所有关联模板
• 发送前进行验证，以便及早发现缺失的变量

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 - 获取退信汇总计数 [可选]

关键参数：

• count：每页返回的记录数
• offset：结果的分页偏移量
• type：退信类型筛选（例如 'HardBounce'、'SoftBounce'、'SpamNotification'）
• fromdate/todate：日期范围筛选
• emailFilter：按收件人电子邮件地址筛选

陷阱：

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

5. 配置服务器设置

何时使用：用户想要查看或修改 Postmark 服务器配置

工具顺序：

1. POSTMARK_GET_SERVER - 获取当前服务器设置 [必需]
2. POSTMARK_EDIT_SERVER - 更新服务器配置 [可选]

关键参数：

• Name：服务器显示名称
• SmtpApiActivated：启用/禁用 SMTP API 访问
• BounceHookUrl：退信通知的 Webhook URL
• InboundHookUrl：入站电子邮件处理的 Webhook URL
• TrackOpens：启用/禁用打开跟踪
• TrackLinks：链接跟踪模式（'None'、'HtmlAndText'、'HtmlOnly'、'TextOnly'）

陷阱：

• 服务器编辑会影响通过该服务器发送的所有消息
• Webhook URL 必须是可公开访问的 HTTPS 端点
• 更改 SmtpApiActivated 会立即影响 SMTP 中继访问
• 跟踪设置仅适用于未来的消息，不会追溯应用

常见模式

模板变量解析

1. Call POSTMARK_GET_TEMPLATE with TemplateId
2. Inspect HtmlBody/TextBody for {{variable}} placeholders
3. Build TemplateModel dict with matching keys
4. Call POSTMARK_VALIDATE_TEMPLATE to verify rendering

分页

• 设置 count 以指定每页结果数（因端点而异）
• 使用 offset 跳过之前获取的结果
• 每页将 offset 增加 count，直到返回的结果数 < count
• 总记录数可能在响应元数据中返回

已知陷阱

身份验证：

• Postmark 使用服务器级 API 令牌，而非账户级
• 每个服务器有自己的令牌；确保使用正确的服务器上下文
• 发件人地址必须是已验证的发件人签名或来自已验证的域

速率限制：

• 批量发送每次调用限制为 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

何时使用

此技能适用于执行概述中描述的工作流或操作。

限制

• 仅当任务明确符合上述范围时，才使用此技能。
• 不要将输出视为替代特定环境验证、测试或专家审查的方案。
• 如果缺少必需的输入、权限、安全边界或成功标准，请停止并请求澄清。

发送前，请确认服务端／消息流、接收方和确切内容，包括批次中的每一项。检查每条消息的结果；HTTP 请求成功并不意味着每位接收方都已接受或收到消息。保留重试标识，并核对结果未知的操作。模板／服务端跟踪设置的变更会影响其他发送操作，因此需要明确变更范围；请对令牌和接收方的私人数据进行脱敏。