postmark

Postmark スキル

Postmark は、開発者向けに構築されたトランザクションメールプラットフォームであり、15 年以上にわたるメール到達性の専門知識を備えています。これらのスキルでは、AI エージェントが 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 と受信 Webhook は異なるシステムです

postmark-webhooks は送信イベント Webhook を扱い、postmark-inbound は受信メール Webhook を扱います。これらは別々のインフラストラクチャで動作し、再試行スケジュールも異なるため、互いの設定を適用しないでください。

	送信 Webhook（postmark-webhooks）	受信 Webhook（postmark-inbound）
再試行	約72 分間に最大 9 回（標準 3 回＋バックオフ 6 回）	約10.5 時間に最大 10 回
再試行の条件	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 では、2 種類の API トークンを使用します。

トークン	ヘッダー	スコープ
サーバートークン	X-Postmark-Server-Token	メール送信、テンプレート、バウンス、Webhook、メッセージストリーム
アカウントトークン	X-Postmark-Account-Token	サーバー、ドメイン、送信者署名の管理

Postmark Servers からサーバー 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	1 対 1 のトリガー送信メール（ウェルカムメール、パスワードリセット、領収書など）— デフォルト
一斉配信	broadcast	マーケティング、ニュースレター、お知らせ

トランザクションメールと一斉配信メールを同じストリームで送信しないでください。配信性能が低下します。

リソース

• Postmark 開発者向けドキュメント
• API リファレンス
• LLM 向け Postmark API
• Postmark ダッシュボード