postmark-automation

通过 Rube MCP 自动化 Postmark

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

工具包文档：composio.dev/toolkits/postmark

前置条件

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

设置

获取 Rube MCP：在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务。无需 API 密钥——只需添加端点即可使用。

1. 确认 RUBE_SEARCH_TOOLS 能够响应，以验证 Rube MCP 是否可用
2. 使用工具包 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 的键必须与模板变量名称完全匹配（区分大小写）
• 发件人地址必须是已验证的 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 跳过之前已获取的结果
• 每页将偏移量增加 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

---

由 Composio 提供支持