Postmark公式は、入信Webhookの端点を確認するためのテスト用リクエスト例を公開しています（公式の入信Webhook設定とテスト例）。症状：サンプル要求は成功したのに、実メールが届くか分からない。最短の確認方法は、隔離したテスト環境で模擬リクエストと実メールを別々に検証することです。 模擬リクエストは端点とアプリ処理の一部を確かめるものです。実メールの入信から業務処理までを証明するには、テスト用入信アドレスへ送信し、Webhookとアプリの結果を照合します。
この記事は、Postmarkの受信メール処理を実装する開発者、検収を担当するQA、テスト環境を維持する個人開発者向けです。
模擬リクエスト、実際のメール到着、本文や添付の解析を、混同せずに確認する手順を扱います。
最初に分けるべき検証の証拠
「Webhookが成功した」という記録だけでは、どこまで確認できたのか分かりません。最低限、次の段階に分けて記録します。
- 端点への到達：自社のWebhookエンドポイントが要求を受け付けた。
- 模擬データの処理：サンプルのJSONを解析し、アプリ内の想定処理を実行できた。
- 実メールの入信とWebhook送信：テストメールがPostmarkの入信アドレスに届き、設定したWebhookへデータが送られた。
- 業務処理の完了：アプリがメールを読み取り、期待する保存や通知などを行った。
Postmarkは入信メールを処理し、設定済みWebhookへJSONとして送ります。公式のサンプル要求はWebhook端点の確認用であり、実メールの到着を示すものではありません（入信Webhookの設定とテスト用リクエスト）。この違いをテスト報告にも残してください。
送信前の環境分離と記録準備
まず、実運用のメール処理へテストデータが混ざらないようにします。テスト用のサーバー、入信フロー、Webhookエンドポイントを用意し、どの環境の入信アドレスに送るのかを確認してください。設定場所とアドレスはPostmarkの公式手順で照合し、実運用の受信先を誤って使わないようにします。
テストごとの識別子は、件名や本文に含めると追跡に役立ちます。同じ識別子をアプリ側のログにも記録し、Postmarkの入信記録、Webhook受信ログ、業務処理の結果を関連付けます。公開ログや共有画面には、テストトークンや実在する個人のメール本文を載せないでください。テスト用データも、実在人物の個人情報を避けて作成します。テストデータに含める情報の扱いは、プライバシー保護の考え方も確認し、必要な情報だけを使うようにします。
模擬要求で確かめるJSON処理
次に、公式のテスト用リクエストを自社のテスト用エンドポイントへ送ります。これは「Postmarkから実メールを受け取る試験」ではなく、「想定するJSONを端点とアプリが処理できるか」の確認です。要求の送信方法や例は、Postmarkの入信Webhook資料に従ってください。
応答のステータスと本文を記録し、サーバー側のログも同時に確認します。受信者、送信者、件名、テキスト本文、HTML本文など、アプリが利用する項目が適切に読み取られるかを照合します。サンプル要求が成功しても、入信アドレスの設定、実メールの受信、実際の添付ファイル処理を確認したことにはなりません。
実メールを送り、入信からアプリまで追跡
模擬データを処理できたら、管理下にあるテスト送信元から、自社テスト環境のPostmark入信アドレスへメールを送ります。件名や本文に実行識別子を入れ、Postmark側の入信記録とWebhookログ、アプリログを同じテストとして突き合わせます。入信状態やエラーの意味は、Postmarkの入信メッセージ状態の説明と入信エラーメッセージの説明で確認できます。
テストメールは、自社が対応対象とする内容を分けて送ります。テキスト本文、HTML本文、添付ファイルを一度に詰め込まず、どの内容を検証したか分かるようにします。一つの形式で処理できても、別形式まで動作したとは限りません。
解析結果と業務処理の突き合わせ
Postmarkから届いたWebhookデータを、送ったテストメールと比較します。宛先、件名、本文、添付ファイルについて、自社コードが受け取った値と期待値が一致するか確認します。メールの解析仕様と添付関連の項目は、Postmarkのメール解析ガイドを基準にします。
添付が画面上に見えない場合も、すぐに「添付が受信されていない」と結論づけないでください。Activity上で添付内容がどう表示されるかは、添付内容がActivityに表示されない場合の公式説明も確認し、Webhookデータとアプリ側の保存結果を別々に見ます。
失敗時は、入信記録があるか、Webhook要求が自社端点へ到達したか、端点がどう応答したか、アプリが何を処理したかの順に切り分けます。再試行の回数や間隔を決めつけず、Postmarkの最新資料と自社の実装を確認してください。再試行が発生した場合に備え、同じメールの重複処理をどう扱うかも自社側で検証します。
中盤のFAQ：模擬と実メールの境界
Webhook用のテスト要求を送る手順
Postmark公式資料のテスト用要求を使い、自社が管理する検証用エンドポイントへ送ります。HTTP応答に加え、受信したJSON、アプリログ、アプリ上の処理結果を照合します。これで確認できるのは模擬データの処理経路です。メールの入信アドレスへ実際に届くことは、別途メールを送って確かめます。
サンプル要求の成功が示す範囲
成功が示すのは、その要求を端点が受け付け、アプリが処理できた範囲です。実メールの到着、Postmarkでの入信処理、Webhookの実配送までを自動的に証明するわけではありません。各段階のログと結果を別々に保存し、テスト報告では確認できた範囲を限定して記載します。
本文と添付の解析を確かめる方法
送信メールの原文とWebhookデータを照合し、対象にした本文形式や添付がアプリで想定どおり扱われたか確認します。テキスト、HTML、添付を別の試験ケースに分けると、失敗箇所を特定しやすくなります。添付の表示場所とペイロード上の解析仕様は、Postmarkの公式メール解析資料も参照してください。
入信後にアプリの処理を確認する方法
入信記録、Webhook受信ログ、アプリの業務ログを、件名などに付けた識別子で結び付けます。そのうえで、アプリが作成するデータや実行する処理が期待どおりかを確認します。Webhookが届いたという記録だけで、後続の保存や通知まで成功したと判断しないことが重要です。
検証結果を残す比較表
各試験の結果を分けて記録すると、「何が通ったか」を過大に報告するリスクを抑えられます。
| 検証方法 | 主に確認できること | 確認できないこと | 記録する証拠 |
|---|---|---|---|
| 公式の模擬リクエスト | テストJSONの受信、端点の応答、アプリ内の解析処理 | 実メールが入信アドレスに届くこと | HTTP応答、要求内容、アプリログ |
| テストアドレスへの実メール | 実際の入信、Webhookデータ、メール内容の解析 | アプリの後続処理が完了したこと | 入信記録、Webhookログ、原文との照合 |
| 業務処理の確認 | 保存や通知など、自社アプリの期待動作 | 未実施の形式や別環境での動作 | 生成データ、処理ログ、試験結果 |
実測記録と受け取り方法の確認
実メールの試験結果には、実際に使った送信元、到着までの時間、拒否の有無を記録します。ここでは特定環境での実測値を提示していません。実行した環境と結果をそのまま記入し、未計測の時間や未検証の形式を推定で埋めないでください。
| 記録項目 | テストごとに残す内容 |
|---|---|
| 送信元・環境 | 自社で管理するテスト送信元と対象環境 |
| 到着時間 | 送信時刻と入信を確認した時刻。実測した場合のみ記録 |
| 拒否・エラー | 入信状態、エラー記録、端点の応答 |
| メール内容 | 件名、本文形式、添付の有無と照合結果 |
| アプリ結果 | 期待した保存や通知が行われたか |
短期のメール受信先をテスト補助に使う場合は、まずTempcatの受信方法で実際に表示される受信方法と利用上の制限を確認してください。受信先を分けることで、テスト用メールに個人の主アドレスを使わずに済む場合があります。Tempcatの一時受信は補助的な選択肢であり、Postmarkの入信アドレス設定、Webhook検証、アプリの端から端までの受け入れ確認を置き換えるものではありません。
よくある質問
PostmarkのWebhook用テストリクエストは、どこを確認すればよいですか？
Postmarkの公式Webhook資料にあるテスト用リクエストを、自社で管理するテスト用エンドポイントへ送ります。HTTP応答だけで終わらせず、アプリのログと処理結果も確認してください。サンプルJSONの解析を確かめる手順であり、メールが入信アドレスへ届いた証拠にはなりません。
模擬リクエストが成功したら、実メールも受信できたと判断できますか？
判断できません。模擬リクエストの成功が示すのは、そのリクエストをエンドポイントが受け取り、アプリ側で処理できたことです。実メールの受信確認には、テスト用の入信アドレスへメールを送り、Postmark側の入信記録、Webhookの記録、アプリの処理結果を別々に照合します。
受信メールの本文や添付ファイルは、どのように検証しますか？
テスト用のメールに識別しやすい件名と本文を設定し、対応対象に含めるテキスト、HTML、添付ファイルを個別に試します。WebhookのJSONと送信した原文を照らし、本文の取り込み、宛先、添付の名前や内容が自社の想定どおりか確認してください。Activity画面に添付内容が表示されない場合は、公式説明も参照します。
実メールが入信した後、アプリ側の処理完了はどう確かめますか？
テストごとに固有の件名や識別子を付け、入信記録、Webhook受信ログ、アプリの業務ログを同じ実行として追えるようにします。最後に、メールから作成されるレコードや通知など、自社で期待する結果を確認します。Webhookが届いたことと業務処理が完了したことは、別の証拠として記録してください。
関連記事
- 2026年、Appleアカウント作成時に認証メールが届かないときは？ · 認証コード · 2026-10-28
- Brave Email Aliasesと一時メールの選び方：2026年、受信シーン別に判断 · プライバシー · 2026-10-27
- 2026年、越境セラーのChatGPT Business招待メールが届かないとき、最初に確認することは？ · 使い方 · 2026-10-26