postmark-email-best-practices
メール到達率の改善、CAN-SPAM・GDPR・CASLなどのコンプライアンス対応、トランザクションメールの設計パターン、リスト管理、安全なテスト方法、または一般的なメールのベストプラクティスについて質問する際に使用します。プロバイダー非依存の知識をベースに、Postmark固有のガイダンスも提供します。
description の原文を見る
Use when asking about email deliverability, compliance (CAN-SPAM, GDPR, CASL), transactional email design patterns, list management, testing safely, or general email best practices — provider-agnostic knowledge with Postmark-specific guidance.
SKILL.md 本文
メール ベストプラクティス
Postmark は 15 年以上にわたり数十億通のトランザクショナルメールを配信してきました。このスキルは、信頼性が高く、コンプライアンスに対応した、配信性能の優れたメールシステムを構築するための実践的なガイドラインをまとめたものです。
クイックリファレンス
| トピック | 使用シーン |
|---|---|
| 配信性能 | SPF/DKIM/DMARC の設定、新しいドメインのウォームアップ、配信問題の診断 |
| コンプライアンス | 配信停止フローの構築、GDPR/CAN-SPAM/CASL 要件への対応 |
| トランザクショナルデザイン | ウェルカムメール、パスワードリセット、領収書、アラートの設計 |
| リスト管理 | バウンス、抑制、リストの衛生管理 |
| テスト | 送信者の評判を傷つけないよう安全にテスト |
| 送信の信頼性 | べき等性、リトライロジック、レート制限 |
配信性能の基礎
すべての送信ドメインが持つべき 3 つの認証レコード:
| レコード | 目的 | 優先度 |
|---|---|---|
| SPF | サーバーがあなたのドメインとして送信することを認可 | 必須 |
| DKIM | メールに暗号署名して真正性を証明 | 必須 |
| DMARC | SPF/DKIM の失敗に対するポリシー | 必須 |
Postmark では、送信者ドメインを検証する際に DKIM が自動的に設定されます。SPF と DMARC は DNS で設定する必要があります。
DNS セットアップ、評判要因、ドメインウォームアップ ガイダンスについては references/deliverability.md を参照してください。
トランザクショナルメール vs. ブロードキャストメール
トランザクショナルメールとブロードキャストメールを同じ送信ストリームで混在させないでください。 配信特性、コンプライアンス要件、評判プロファイルが異なります。
| タイプ | 例 | コンプライアンス | 配信停止が必須 |
|---|---|---|---|
| トランザクショナル | パスワードリセット、領収書、アラート、通知 | CAN-SPAM 免除の可能性あり | いいえ (ただ良い慣行) |
| ブロードキャスト | ニュースレター、プロモーション、お知らせ | CAN-SPAM、GDPR、CASL が適用 | はい — 法的要件 |
Postmark は Message Streams でこの分離を強制します — トランザクショナル用に outbound、マーケティング用に broadcast を使用してください。
CAN-SPAM、GDPR、CASL の要件については references/compliance.md を参照してください。
トランザクショナルメール設計
優れたトランザクショナルメールは以下の特性があります:
- 予期されている — 受信者がこのメールをトリガーした
- タイムリー — トリガーイベントの直後に送信
- アクション可能 — 1 つの明確な行動喚起
- シンプル — ミニマルなデザイン、装飾より内容
一般的なトランザクショナルメール タイプとその必須要素:
| メールタイプ | 必須項目 | 避けるべき項目 |
|---|---|---|
| ウェルカム | 製品名、次のステップ CTA、サポート連絡先 | 初日のマーケティング アップセル |
| パスワードリセット | 有効期限、不要な場合の通知、サポートリンク | 長いコピー |
| 領収書 / 請求書 | 明細項目、合計、請求先住所、サポート | プロモーションコンテンツ |
| 発送通知 | 追跡リンク、推定配送日、商品 | 無関連プロモーション |
| セキュリティアラート | 何が起きたか、いつ、必要なアクション、セキュア方法 | 不安を煽る言語 |
デザインパターン、コピーガイドライン、HTML メール ベストプラクティスについては references/transactional-design.md を参照してください。
リストの健全性
無効、非アクティブ、またはエンゲージメント低下のアドレスへの送信は、配信性能問題の主要因です。
主要ルール:
- ハードバウンス は即座に永続的に削除する
- スパム苦情 は即座に抑制する — 再度追加しない
- 12～18 ヶ月以上経過したリストは、メール送信前に再許可を取得する
- メールリストの購入またはレンタルは絶対しない
- 収集時点でアドレスを検証する
抑制戦略、リスト衛生管理スケジュール、再エンゲージメント ワークフローについては references/list-management.md を参照してください。
安全なテスト
コンシューマープロバイダーの実際のアドレスでテストしないでください (gmail.com、yahoo.com など) — 送信者の評判を傷つけます。
| 方法 | 方法 | 用途 |
|---|---|---|
| API テストトークン | サーバートークンとして POSTMARK_API_TEST を使用 | CI/開発での API 呼び出し検証 |
| ブラックホール | test@blackhole.postmarkapp.com に送信 | 機能テスト — アクティビティに表示される |
| サンドボックスサーバー | ダッシュボードで専用サンドボックスサーバーを作成 | 配信なしの完全な送信パイプライン |
| バウンステスト | hardbounce@bounce-testing.postmarkapp.com | バウンス webhook ハンドラーのテスト |
完全なテスト設定とドメイン ウォームアップ スケジュールについては references/testing.md を参照してください。
送信の信頼性
本番環境のメールシステムは、重複送信とサイレント失敗を避けるために、べき等性キー、リトライロジック、レート制限の処理が必要です。
べき等性パターン、リトライ戦略、レート制限の処理については references/sending-reliability.md を参照してください。
注記
- Postmark はトランザクショナルメール専用に設計されている — トリガーされた 1:1 メール、バルクマーケティングには向きません
- 配信性能は認証だけではなく、エンゲージメントの高い受信者に望まれるメールを送信することです
- 実際のユーザーからの 1 件のスパム苦情は、1,000 件のハードバウンスよりも大きなダメージになります
- バウンス率 (2% 以下に保つ) とスパム苦情率 (0.04% 以下に保つ) を監視してください
ライセンス: MIT(寛容ライセンスのため全文を引用しています) · 原本リポジトリ
詳細情報
- 作者
- activecampaign
- ライセンス
- MIT
- 最終更新
- 不明
Source: https://github.com/activecampaign/postmark-skills / ライセンス: MIT
関連スキル
nano-banana-2
inference.sh CLIを通じてGoogle Gemini 3.1 Flash Image Preview（Nano Banana 2）で画像を生成します。テキストから画像を生成する機能、画像編集、最大14枚の複数画像入力、Google Searchグラウンディング機能に対応しています。トリガーワード：「nano banana 2」「nanobanana 2」「gemini 3.1 flash image」「gemini 3 1 flash image preview」「google image generation」
octocode-slides
洗練されたマルチファイル形式のHTMLプレゼンテーションを生成します。6段階のフロー（概要 → リサーチ → アウトライン → デザイン → 実装 → レビュー）で構成されています。各スライドは独立したHTMLファイルとなり、iframeで読み込まれます。「スライドを作成してほしい」「プレゼンテーションを作ってほしい」「HTMLスライドを生成してほしい」「デックを構築してほしい」といった依頼や、ノート・ドキュメント・コードを洗練されたプレゼンテーションに変換する際に使用できます。
gpt-image2-ppt
OpenAIのgpt-image-2を使用して、視覚的に優れたPPTスライドを生成します。Spatial Glass、Tech Blue、Editorial Monoなど10種類のキュレーション済みスタイルに対応し、ユーザーが提供したPPTXファイルを模倣するテンプレートクローンモードも搭載しています。HTMLビューアと16:9形式のPPTXファイルを出力します。プレゼンテーション、スライド、ピッチデック、投資家向けPPT、雑誌風PPTの作成依頼などで活用してください。
nano-banana
Nano Banana PRO（Gemini 3 Pro Image）およびNano Banana（Gemini 2.5 Flash Image）を使用したAI画像生成機能です。以下の場合に活用できます：（1）テキストプロンプトからの画像生成、（2）既存画像の編集、（3）インフォグラフィックス、ロゴ、商品写真、ステッカーなどのプロフェッショナルなビジュアルアセット制作、（4）複数画像での人物キャラクターの一貫性保持、（5）正確なテキスト描画を含む画像生成、（6）AI生成ビジュアルが必要なあらゆるタスク。「画像を生成」「画像を作成」「写真を作る」「ロゴをデザイン」「インフォグラフィックスを作成」「AI画像」「nano banana」またはその他の画像生成リクエストをトリガーとして機能します。
oiloil-ui-ux-guide
モダンでクリーンなUI/UXガイダンス・レビュースキルです。新機能や既存システム（Webアプリ）に対して、実行可能なUI/UX改善提案、デザイン原則、デザインレビューチェックリストが必要な場合に活用できます。CRAP（コントラスト・反復・配置・近接）をベースに、タスクファーストなUX、情報設計、フィードバック・システムステータス、一貫性、affordances、エラー防止・復旧、認知負荷を重視します。モダンミニマルスタイル（クリーン・余白・タイポグラフィ主導）を強制し、不要なテキストを削減、アイコンとしての絵文字を禁止し、統一されたアイコンセットから直感的で洗練されたアイコンを推奨します。
axiom-hig-ref
Apple Human Interface Guidelines リファレンス — 色（セマンティックカラー、カスタムカラー、パターン）、背景（マテリアル階層、ダイナミック背景）、タイポグラフィ（標準スタイル、カスタムフォント、Dynamic Type）、SF Symbols（レンダリングモード、色、多言語対応）、ダークモード、アクセシビリティ、プラットフォーム固有の考慮事項を網羅したガイドラインです。