新しいガイド:評判を損なわずに専用IPをウォームアップする方法。 続きを読む →
MigoSMTP
Webhookとイベント

何が起きたか、その瞬間に把握

配信、バウンス、開封、クリック、苦情のすべてについて署名付きイベントを受信し、取りこぼした分は再送できます。

AIがイベントストリームを要約し、異常なバウンスのパターンを検出次第お知らせします。

エンドポイントを追加
URL
https://example.com/hook
シークレット
••••••••••
保存
エンドポイントを追加しました
HTTPSのみ
検証済み
HTTPSエンドポイントを追加POSTリクエストを受け付けられるURLを指定してください。実際のイベントを送信する前に、応答することを確認します。
購読するイベント
deliveredメッセージを受理
bouncedハードとソフト
complainedスパム報告
clickedリンクのアクティビティ
イベントごと
ストリームごと
必要なイベントを選択対応が必要なイベントだけを購読しましょう。delivered、bounced、complained、opened、clickedから選べます。
配信イベント
署名付きイベント
/hooks/mail
200 OK
分析
200 OK
CRM同期
200 OK
リアルタイム
複数のエンドポイント
イベントをリアルタイムで一斉配信各イベントは、購読しているすべてのエンドポイントにPOSTされるため、分析、CRM、アラートが常に同期します。
ペイロード
{ "event": "delivered" }
署名ヘッダー
sha256=9f2c41…
共有シークレット
タイムスタンプ付き
定数時間比較
検証に失敗したものはすべて拒否
HMAC-SHA256
リプレイ防止
すべてのリクエストを検証各リクエストにはお客様のシークレットで作成したHMAC署名が付いているため、当社からの送信であることを確認できます。
エンドポイントの状態 · /hooks/mail
AI
1時間前
現在
エラー増加中失敗の多くは、直前のデプロイ後に発生した502です。
推奨:イベントをキューに溜め、/hooks/mailの復旧後に再送
失敗をグループ化
一時停止または再送
AIがエンドポイントの障害を早期に検出再試行が尽きるのを待たず、AIがエンドポイントのエラー率の上昇を検知し、失敗を原因別にグループ化します。修正案を提示し、ノイズの多いイベントを一時停止することもできます。
webhookハンドラー
Node
Python
PHP
Go
PHP
app.post("/hook", (req, res) => {
verify(req, SECRET)
res.sendStatus(200)
})
200 OK
すぐに応答
べき等
数行で書けるハンドラー署名を検証し、すぐに応答を返し、処理は後で行います。信頼できるコンシューマーに必要なのはこれだけです。
エンドポイント
イベント
ファンアウト
署名
AIトリアージ
ハンドラー
SMTPリレーREST APIWebhook専用IPDKIM署名インバウンドパーステンプレート分析抑止リスト評判モニタリングメール検証チームロールと監査ログSMTPリレーREST APIWebhook専用IPDKIM署名インバウンドパーステンプレート分析抑止リスト評判モニタリングメール検証チームロールと監査ログ
機能

信頼できるイベント配信

あらゆる結果

配信済み、保留、バウンス、開封、クリック、苦情、配信停止。

署名付きペイロード

すべてのリクエストがMigoSMTPからのものであることを検証。

バックオフ付きの再試行

失敗した配信は自動で再試行されます。

再送

障害後に、ログからイベントを再送できます。

イベントフィルター

必要なイベントだけを購読できます。

配信ログ

すべての試行について、リクエスト、レスポンス、ステータスを確認できます。

仕組み

イベントが発生メッセージが配信、保留、バウンス、開封、クリック、またはスパム報告されます。
MigoSMTPが署名して送信イベントは署名付きJSONペイロードにまとめられ、HTTPSエンドポイントへ送信されます。
エンドポイントが検証ハンドラーが署名を確認し、2xxレスポンスで受信を通知します。
再試行と再送失敗した配信は再試行され、障害後にはログからイベントを再送できます。
ステップ1

エンドポイントを追加

HTTPSのURLを入力し、イベントを選択します。

ステップ2

署名を検証

各リクエストの署名ヘッダーを確認します。

ステップ3

処理して応答

2xxレスポンスを返して受信を通知します。

実際の動作を見る

最初の送信から受信トレイまで、1つのプラットフォームで

ステージを切り替えて、各段階でコントロールできる内容を確認できます。イメージ画面です。表示されている数値とアドレスはすべてサンプルデータです。

app.migosmtp.com / sendサンプルデータ
キュー済み
184,320
本日の送信数
6,418,905
レート
412/s
受理you@example.comへのメッセージ
受理team@example.comへのメッセージ
キュー済み受信者25,000件のバッチ
受理ops@example.comへのメッセージ
運用

システムをメールの状況と同期

ポーリングなしで、データベースの更新、ワークフローの起動、チームへの通知ができます。

  • エンドポイントごとのイベント選択
  • 自動再試行と手動再送
  • リクエストとレスポンスの完全なログ
  • ローテーション可能なシークレット
概要
トランスポートHTTPS POST
形式JSON
セキュリティ署名ヘッダー
リトライ自動(バックオフ付き)
概要

webhookとイベントとは?

メールのwebhookは、送信したメッセージに何かが起きたときにアプリケーションへ通知するHTTPコールバックです。MigoSMTPは、配信済み、保留、バウンス、開封、クリック、苦情、配信停止などのイベントについて、署名付きJSONペイロードをHTTPSエンドポイントにPOSTします。システムはAPIに繰り返しステータスを問い合わせる代わりに、即座に反応できます。ペイロードには、メッセージID、受信者、イベントタイプ、タイムスタンプ、失敗の場合は受信サーバーが返した理由が含まれます。これらのフィールドにより、追加の問い合わせや推測なしで、イベントを自社のレコードと突き合わせられます。

エンドポイントを登録し、受信するイベントを選び、各リクエストの署名ヘッダーを検証します。受信を確認するには2xxレスポンスを返してください。エンドポイントが失敗した場合、配信はバックオフ付きで再試行され、障害後にはログからイベントを再送できます。すべての試行のリクエストとレスポンスの詳細が保存されるため、すばやくデバッグできます。シークレットはローテーションでき、イベントフィルターで各エンドポイントの用途を絞り込めます。失敗した試行にはリクエスト、レスポンス、時刻が表示されるので、ハンドラーのデバッグを根拠に基づいて手早く行えます。

イベントデータは、送信システムが学習するための材料です。抑止リストの更新、苦情の急増時のキャンペーン停止、領収書メールのバウンスのサポートへの通知は、いずれもタイムリーなイベントに依存します。当社のAIレイヤーは大量のストリームを要約して異常なパターンを検出できるため、お客様から連絡が来てからではなく、数分以内に問題に気づけます。再送機能とログがあるので、自社システムで生じた抜け漏れがデータの欠落になることはありません。

ユースケース

webhookとイベントの主なユースケース

データベースを同期した状態に保つ

配信されたら注文を通知済みにし、ハードバウンスが届いたらコンタクトにフラグを立てます。webhookならポーリングジョブが不要になり、アプリケーションの状態を正確に保てます。

抑止の自動処理

バウンスまたは苦情のイベントを受けたら、そのアドレスを自社の送信禁止テーブルにすぐ追加すれば、同じ相手にメールを送る他のシステムも送信を停止します。

サポートチームへのアラート

パスワードリセットのメールがバウンスしたら、SlackやチケットでアラートをPOSTします。お客様が諦める前に、サポートが別の手段で連絡できます。手作業にかかる何時間もの手間を省けます。

ダウンタイム後のリカバリー

デプロイ中にエンドポイントがオフラインだった場合は、ログから未受信のイベントを再送し、レコードを正しい状態に戻せます。その間に失われるものはありません。

注文とチケットのステータスを更新

配信イベントが届いたらすぐに、注文を通知済み、サポートチケットを回答済みにできます。

データウェアハウスにデータを供給

イベントを自社の分析基盤にストリーミングし、メールの成果をプロダクトや売上のデータと並べて確認できます。

方法の選択

webhookかAPIのポーリングか?

どちらもイベントデータを取得できます。適した状況が異なります。

WebhookAPIのポーリング
仕組み当社がエンドポイントにイベントをプッシュお客様のコードが定期的に問い合わせ
速度ほぼリアルタイムポーリング間隔による
負荷何かが起きたときのみ常時リクエストが発生し、ほとんどが空
信頼性再試行と再送で障害をカバー読み取り済みの範囲を自分で管理する必要がある
最適な用途リアルタイムのステータス確認と自動化過去分の補完と定期レポート

webhookでリアルタイムに更新を受け取り、取りこぼした分はAPIで補完しているチームが多くあります。

AI機能

AI支援のwebhookとイベント

コパイロット

イベントストリームの要約

コパイロットが数千件のイベントを短いダイジェストにまとめます。どのプロバイダーが保留しているか、どのキャンペーンが苦情を招いているかなどを、それぞれの根拠となるメッセージへのリンク付きで示します。

予測型

イベントの異常検知

モデルが通常のバウンス率、苦情率、保留率を学習し、ストリームが通常から外れるとアラートを出します。通知先や自動化の実行有無は、お客様が設定します。

アシスト

ペイロードのデバッグアシスタント

失敗した配信ログを貼り付けると、署名の不一致やタイムアウトなど考えられる原因をアシスタントが説明し、試すべき修正案を提示します。変更を行うのはお客様です。

エージェント対応

エージェント対応のイベントアクセス

MCPサーバー経由で、AIエージェントは読み取り専用スコープでイベント履歴と配信ログを参照できます。書き込み操作には明示的なスコープが必要で、ご希望なら人による承認も必須にできます。

AI機能はあくまで支援です。要約とアラートを行い、自動アクションはチームが設定・承認したものに限られます。

ベストプラクティス

webhookとイベントのベストプラクティス

毎回署名を検証する

署名ヘッダーが一致しないリクエストは拒否しましょう。シークレットは定期的にローテーションし、漏洩の可能性がある場合はただちに変更してください。

素早く応答し、処理は非同期で行う

ペイロードを安全に保存できたらすぐに2xxで応答し、処理はキューから行います。ハンドラーが遅いと、タイムアウトや重複した再試行の原因になります。

重複と順序の乱れを想定して設計する

配信は重複したり、順序が前後したりすることがあります。メッセージIDとタイムスタンプを使って重複を排除し、古い状態変更は無視しましょう。

利用するものだけを購読する

エンドポイントごとにイベントをフィルターしましょう。無関係なリクエストが減れば、サーバーの負荷が下がり、監視もシンプルになります。連携をスリムに保てば、デバッグも素早く行えます。

自社のエンドポイントを監視する

配信ログで失敗が繰り返されたらアラートを出しましょう。無音の障害は、誰かが欠落分を再送するまで、データのずれが気づかれないまま進むことを意味します。

すぐ応答し、処理は後で

2xxレスポンスをすばやく返し、重い処理はキューに移して、ハンドラーが遅くても再試行が発生しないようにしましょう。

よくある質問

webhookとイベント:よくある質問

エンドポイントの接続でお困りですか?公開前に、私たちのチームが一緒に確認します。

メールのwebhookとは?

メールのwebhookとは、メッセージの配信やバウンスなどのイベントが発生したときに、メールプロバイダーがお客様のサーバーへ送るHTTPリクエストです。APIを繰り返し確認しなくても、アプリケーションがリアルタイムで反応できます。ポーリングジョブが不要になり、レコードを常に最新に保てます。

webhookの署名はどう検証しますか?

各リクエストには、エンドポイントのシークレットで生成された署名ヘッダーが含まれます。受信側で生のリクエストボディから署名を再計算して比較し、一致しなければリクエストを拒否してください。ドキュメントにコードサンプルがあります。

どのイベントを受信できますか?

配信済み、保留、バウンス、開封、クリック、苦情、配信停止です。エンドポイントごとに一部のイベントだけを購読できるため、あるサービスにはバウンス、別のサービスにはエンゲージメントイベントを送れます。抑止にはバウンス、分析にはクリックなど、システムが対応するものだけを選べば、エンドポイントへのトラフィックを少なく、必要なものに絞れます。

エンドポイントがダウンしているとどうなりますか?

失敗した配信はバックオフ付きで再試行され、復旧後にログからイベントを再送できます。リクエストとレスポンスを含むすべての試行が記録されるため、何が失敗したかを確認できます。ハンドラーがすばやく応答を返し、失敗をログに記録していることを確認してください。

webhookイベントは順番どおりに配信されますか?

厳密な順序には依存しないでください。メッセージIDとタイムスタンプを使い、重複や順序の乱れに耐えるハンドラーを作りましょう。イベントの順序はプロバイダーや再試行によって前後することがあり、1通のメッセージから複数のイベントが生じる場合もあります。

ボットによる開封とは?

一部のメールシステムは画像を自動的に取得するため、誰もメッセージを読んでいなくても開封として記録されます。可能な範囲で人による開封と区別していますが、開封トラッキングはあくまで推定値です。開封は大まかな指標として扱い、クリックや返信をエンゲージメントのより強いシグナルとして数えてください。

webhookエンドポイントはどうテストしますか?

ダッシュボードからサンプルイベントをURLに送信し、ハンドラーが署名を検証して2xxを返すことを確認します。配信ログでリクエストと自社のレスポンスを確認してください。本番の前に、テスト用シークレットを使ったステージングのエンドポイントで試しましょう。エンドポイントを本番に向ける前に必ず実行してください。

AIはwebhookとイベントでどう機能しますか?

AIは、イベントストリームの要約、異常なバウンスや苦情のパターンの検出、失敗した配信のデバッグを支援できます。アクションを推奨しますが、ルールを設定しない限り、お客様の設定を変更することはありません。新しいエンドポイントを接続する前に、最近のログを確認してください。

エンドポイントはどうテストしますか?

ダッシュボードからサンプルイベントを送信します。

順序は保証されますか?

重複や順序の乱れに耐えるハンドラーを作り、メッセージIDとタイムスタンプで重複を排除してください。

数分で送信を始めましょう。

アカウントを作成し、ドメインを追加して、最初のメールを送信します。