SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场postmark

postmark

通用与其它

查看项目

更新于 10-14 09:28

技能介绍

Postmark 是一个面向开发者构建的交易型邮件平台，资料称其拥有 15 年以上的送达率经验。本技能集的目标是教会 AI 智能体如何有效使用 Postmark API，并按任务路由到对应的子技能。

子技能与用途

资料列出以下子技能及其适用场景：

  1. postmark-send-email（发送邮件）：发送交易型或广播邮件，包括单封、批量（batch）、群发（bulk），或使用模板发送。
  2. postmark-inbound（入站处理）：通过 Webhook 处理收件邮件，用于构建邮件回复（reply-by-email）、邮件转工单（email-to-ticket）或文档提取等场景。
  3. postmark-templates（模板管理）：创建、编辑 Postmark 服务端 Handlebars 模板与布局，并使用模板发送邮件。
  4. postmark-webhooks（Webhook）：设置出站 Webhook，用于投递（delivery）、退信（bounce）、打开（open）、点击（click）、垃圾投诉（spam complaint）和订阅变更（subscription change）等事件，包括端点验证、每个 Webhook 的统计和重试行为。
  5. postmark-email-best-practices（最佳实践）：送达率设置、合规（CAN-SPAM/GDPR/CASL）、邮件设计、列表管理、测试与发送可靠性。

出站与入站 Webhook 的区别

资料特别强调，出站事件 Webhook 与入站邮件 Webhook 是两套不同的系统，运行在独立的基础设施上，重试计划也不同，不可混用：

  • 出站 Webhook（postmark-webhooks）：约 72 分钟内最多重试 9 次（3 次标准 + 6 次退避）。仅在 5xx、408、429 和网络超时时重试；其他 4xx 均为永久失败。
  • 入站 Webhook（postmark-inbound）：约 10.5 小时内最多重试 10 次。任何非 200 响应都会触发重试。

端点验证和每个 Webhook 的统计属于出站功能。

快速路由

  • “发送一封邮件” → 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 Token：

  • Server Token：请求头 X-Postmark-Server-Token，作用域为发送邮件、模板、退信、Webhook、消息流。
  • Account Token：请求头 X-Postmark-Account-Token，作用域为管理服务器、域名、发件人签名。

Server API Token 可从 Postmark 的 Servers 页面获取。

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

消息流（Message Streams）

Postmark 按意图将邮件分为消息流：

  • Transactional（值：outbound）：一对一触发的邮件（欢迎邮件、密码重置、收据），为默认消息流。
  • Broadcast（值：broadcast）：营销、通讯、公告。

资料提醒，切勿在同一消息流中混用交易型和广播邮件，否则会损害送达率。

资源

资料提及的资源包括：Postmark Developer Docs、API Reference、Postmark API for LLMs、Postmark Dashboard。

以上为资料中明确提供的内容；关于具体价格、收费方案、平台支持范围等未在资料中说明，暂未提供。