postmark

Postmark 技能

Postmark 是一个面向开发者打造的事务性邮件平台，拥有 15 年以上的邮件送达专业经验。这些技能可教会 AI Agent 如何有效使用 Postmark API。

子技能

功能	技能	适用场景
发送邮件	postmark-send-email	发送事务性邮件或广播邮件——单封、批量、海量发送，或使用模板发送
入站处理	postmark-inbound	通过 Webhook 处理收到的邮件，构建邮件回复、邮件转工单或文档提取功能
模板管理	postmark-templates	创建、编辑模板，或使用 Postmark 服务端 Handlebars 模板和布局发送邮件
Webhook	postmark-webhooks	为送达、退信、打开、点击、垃圾邮件投诉和订阅变更事件设置出站 Webhook——包括端点验证、每个 Webhook 的统计信息和重试行为
最佳实践	postmark-email-best-practices	邮件送达设置、合规性（CAN-SPAM/GDPR/CASL）、邮件设计、列表管理、测试和发送可靠性

出站和入站 Webhook 是不同的系统

postmark-webhooks 涵盖出站事件 Webhook；postmark-inbound 涵盖入站邮件 Webhook。它们运行在独立的基础设施上，并且重试计划不同——请勿混用：

	出站 Webhook（postmark-webhooks）	入站 Webhook（postmark-inbound）
重试次数	最多重试 9 次，耗时约 72 分钟（3 次标准重试 + 6 次退避重试）	最多重试 10 次，耗时约 10.5 小时
重试条件	仅针对 5xx、408、429 和网络超时——其他所有 4xx 错误均为永久错误	任何非 200 响应

端点验证和每个 Webhook 的统计信息属于出站功能——请参阅 postmark-webhooks。

快速路由

• “发送邮件” → postmark-send-email
• “批量发送邮件” → postmark-send-email
• “使用模板发送” → postmark-send-email（模板部分）或 postmark-templates（创建/管理模板）
• “处理收到的邮件” → postmark-inbound
• “处理入站 Webhook” → postmark-inbound
• “创建邮件模板” → postmark-templates
• “跟踪送达/退信/打开” → postmark-webhooks
• “设置退信处理” → postmark-webhooks
• “验证 Webhook 端点”/“我的 Webhook 未通过验证” → postmark-webhooks
• “Webhook 统计信息/失败率/为什么我的 Webhook 已暂停” → postmark-webhooks
• “Webhook 重试” → postmark-webhooks（出站事件）或 postmark-inbound（入站邮件）
• “设置 SPF/DKIM/DMARC” → postmark-email-best-practices
• “邮件合规性/GDPR/CAN-SPAM” → postmark-email-best-practices
• “域名预热” → postmark-email-best-practices
• “列表卫生/抑制管理” → postmark-email-best-practices
• “设计事务性邮件” → postmark-email-best-practices
• “安全测试邮件” → postmark-email-best-practices

常见设置

身份验证

Postmark 使用两种类型的 API 令牌：

令牌	请求头	范围
服务器令牌	X-Postmark-Server-Token	发送邮件、模板、退信、Webhook、消息流
账户令牌	X-Postmark-Account-Token	管理服务器、域名、发件人签名

从 Postmark 服务器 获取服务器 API 令牌。

SDK 安装

检测项目语言并安装相应的 SDK：

文件	语言	安装命令
package.json	Node.js / TypeScript	npm install postmark
requirements.txt / pyproject.toml	Python	pip install postmarker
Gemfile	Ruby	gem install postmark
composer.json	PHP	composer require wildbit/postmark-php
*.csproj / *.sln	.NET	dotnet add package Postmark

消息流

Postmark 按用途将电子邮件划分为不同的消息流：

消息流	值	用途
事务性	outbound	由事件触发的一对一电子邮件（欢迎邮件、密码重置邮件、收据）——默认
广播	broadcast	营销、新闻简报、公告

切勿在同一消息流中混用事务性和广播电子邮件——这会损害送达率。

资源

• Postmark 开发者文档
• API 参考
• 适用于大模型的 Postmark API
• Postmark 控制面板