72 lines
3.3 KiB
Markdown
72 lines
3.3 KiB
Markdown
# Postmark 邮件技能集
|
||
|
||
`邮件发送` `AI编程助手` `Postmark` `邮件模板` `Webhook`
|
||
|
||
# Postmark Skills
|
||
|
||
[Agent Skills](https://github.com/anthropics/skills)，适用于 [Postmark](https://postmarkapp.com) 邮件平台。教 AI 编程助手如何使用 Postmark API 发送事务性邮件、处理入站消息、管理模板及配置 Webhook。
|
||
|
||
## 可用技能
|
||
|
||
| 技能 | 描述 |
|
||
|-------|-------------|
|
||
| [`postmark-send-email`](./postmark-send-email/) | 通过 Postmark API 发送邮件——支持单封、批量、大批量及模板发送，兼容事务性和广播消息流。 |
|
||
| [`postmark-inbound`](./postmark-inbound/) | 通过 Postmark 入站 Webhook 处理收到的邮件，构建邮件回复、邮件转工单、文档提取等工作流。 |
|
||
| [`postmark-templates`](./postmark-templates/) | 使用 Handlebars 语法创建和管理服务端邮件模板，支持布局继承、模板验证及跨服务器推送。 |
|
||
| [`postmark-webhooks`](./postmark-webhooks/) | 配置投递、退信、打开、点击、垃圾投诉及订阅变更等事件的 Webhook。 |
|
||
| [`postmark-email-best-practices`](./postmark-email-best-practices/) | 涵盖送达率优化、合规要求（CAN-SPAM、GDPR、CASL）、事务性邮件设计、列表管理、安全测试及发送可靠性。 |
|
||
|
||
## 安装
|
||
|
||
```bash
|
||
npx skills add ActiveCampaign/postmark-skills
|
||
```
|
||
|
||
安装指定技能：
|
||
|
||
```bash
|
||
npx skills add ActiveCampaign/postmark-skills --skill postmark-send-email
|
||
```
|
||
|
||
## 使用方法
|
||
|
||
安装后，AI 编程助手会在相关场景中自动调用这些技能。示例提示语：
|
||
|
||
- "用 Postmark 发送一封欢迎邮件"
|
||
- "为支持工单系统搭建入站邮件处理流程"
|
||
- "创建一个订单确认邮件的 Postmark 模板"
|
||
- "添加退信和投递 Webhook 以跟踪邮件状态"
|
||
- "通过 Postmark 批量发送 200 封通知邮件"
|
||
- "如何为 Postmark 配置 SPF、DKIM 和 DMARC？"
|
||
- "CAN-SPAM 和 GDPR 对我的邮件列表有哪些要求？"
|
||
- "帮我设计一封密码重置邮件"
|
||
|
||
## Postmark 官方及社区 SDK
|
||
|
||
- **Node.js / TypeScript** — [`postmark`](https://www.npmjs.com/package/postmark)
|
||
- **Python** — [`postmarker`](https://pypi.org/project/postmarker/)*
|
||
- **Ruby** — [`postmark`](https://rubygems.org/gems/postmark)
|
||
- **PHP** — [`wildbit/postmark-php`](https://packagist.org/packages/wildbit/postmark-php)
|
||
- **.NET** — [`Postmark`](https://www.nuget.org/packages/Postmark)
|
||
|
||
<small>* 免责声明：第三方 SDK 按"原样"提供，不附带任何形式的保证。Postmark 对其使用所产生的任何损失或问题不承担责任。</small>
|
||
|
||
## 前置条件
|
||
|
||
1. 一个 [Postmark 账户](https://account.postmarkapp.com/sign_up)
|
||
2. 已验证的发件域名或发件人签名
|
||
3. 你的 Server API Token（可在 [Postmark Servers](https://account.postmarkapp.com/servers) 获取）
|
||
4. 将 Token 设置为环境变量：`POSTMARK_SERVER_TOKEN`
|
||
|
||
## 为什么选择 Postmark？
|
||
|
||
- **消息流** — 将事务性邮件与广播邮件分离，提升送达率
|
||
- **每批次 500 封** — 是同类产品的 5 倍
|
||
- **批量附件** — 批量发送时支持附加文件
|
||
- **服务端模板** — 支持布局继承的 Handlebars 模板，无需客户端渲染
|
||
- **完整的入站处理** — 通过 Webhook 解析并路由收到的邮件
|
||
- **15 年以上送达率专业经验** — 受到全球 10 万余名开发者信赖
|
||
|
||
## 许可证
|
||
|
||
MIT |