本文へスキップ

AI運用の判断と根拠を引く

トップへ戻る

トランザクションメールAPI × エージェント

用語・参照用語・参照公式仕様のみ公式仕様のみ現行現行として扱う

記事状態: 公開 · 最終確認: 2026-10-04

要点

Agentのdraftを送信操作へ変換する際は、全recipientと本文・添付の承認、domain認証、重複防止、配送イベント、suppressionを個別に追跡する。

現在の判断

Resendの重複実行を防ぐ性質 keyは24時間の窓で同一requestの再送を抑える。長期停滞後の重複防止には組織outboxの照合が必要である。[M2] SESのSENDは配送の試行開始を意味し、suppression(配信停止設定)により配達されない場合もある。Postmarkのdeliveryは受信側サーバーの受付を指しており、受信トレイへの到達を意味するものではない。[M5, M6] Resendの署名は加工せず中継するプロキシ(raw 本文)を検証する。リトライ/リプレイを重複排除し、SendGridのECDSA方式とは別のアダプターにする。配信停止(suppression)の範囲と解除条件は、プロバイダーごとに照合する。[M3, M4, M7, M8, M10] 現行DMARC RFC9989はauthor domainと認証identifierのalignmentを定義し、RFC7489/9091をobsoleteとする。domain認証は本文の正しさや業務承認の証拠ではない。[M9]

どこまで当てはまるか

トランザクションメールAPI × エージェント

詳しく理解する

分析と推論

To/Cc/Bcc、件名、本文、添付ファイルのハッシュ値および改訂版を承認プロセスに結び付け、変更後には再承認を行う記録を残すことは、組織としての提案である。プロバイダーによる有限なキー保持を、永続的かつ同じ要求の再送で処理を重複させない(exactly-once)保証へと移行させるものではない。

利用できる条件

実際のドメイン/DNS/From/Return-Path、受信者の権限、署名SDK、リージョン・割当(利用枠)、送信待ち(outbox)容量、プロバイダーキー/抑止範囲、費用とコールバックを確認する。[M1–M4,M7,M8]

セキュリティとプライバシー

キーと本文および添付ファイルを保護し、公開された記述・判断を送信権限としないでください。結果の照合が不明な場合は、プロバイダーIDとアウトボックスを照合し、新しいキーを用いて無限に再送を行わないようにしてください。署名の有効性のみを根拠として、業務操作を再実行しないでください。

出典

確認できていること

  • Resendの重複実行を防ぐ性質 keyは24時間の窓で同一requestの再送を抑える。長期停滞後の重複防止には組織outboxの照合が必要である。[M2] SESのSENDは配送の試行開始を意味し、suppression(配信停止設定)により配達されない場合もある。Postmarkのdeliveryは受信側サーバーの受付を指しており、受信トレイへの到達を意味するものではない。[M5, M6] Resendの署名は加工せず中継するプロキシ(raw 本文)を検証する。リトライ/リプレイを重複排除し、SendGridのECDSA方式とは別のアダプターにする。配信停止(suppression)の範囲と解除条件は、プロバイダーごとに照合する。[M3, M4, M7, M8, M10] 現行DMARC RFC9989はauthor domainと認証identifierのalignmentを定義し、RFC7489/9091をobsoleteとする。domain認証は本文の正しさや業務承認の証拠ではない。[M9]

よくある失敗・反証

  • 成功後処理待ち時間の上限、key TTL越え、未承認Bcc/添付、header injection、イベント重複・遅延・順序反転、bounce/complaint履歴消去、抑止先の自動解除を試験する。

  • SMTP/API、DNS、実際のwebhook、インボックスは未試験です。ネイティブのMIME/SQLiteと合成ゲートは、実際の配送の証拠にはなりません。SMTPのCRLFによるネイティブな期待値の差は保存し、正式な承認テキストとワイヤバイトを区別してください。

実務での使い方

  • To/Cc/Bcc、件名、本文、添付ファイルのハッシュ値および改訂版を承認プロセスに結び付け、変更後には再承認を行う記録を残すことは、組織としての提案である。プロバイダーによる有限なキー保持を、永続的かつ同じ要求の再送で処理を重複させない(exactly-once)保証へと移行させるものではない。

  • 実際のドメイン/DNS/From/Return-Path、受信者の権限、署名SDK、リージョン・割当(利用枠)、送信待ち(outbox)容量、プロバイダーキー/抑止範囲、費用とコールバックを確認する。[M1–M4,M7,M8]

  • キーと本文および添付ファイルを保護し、公開された記述・判断を送信権限としないでください。結果の照合が不明な場合は、プロバイダーIDとアウトボックスを照合し、新しいキーを用いて無限に再送を行わないようにしてください。署名の有効性のみを根拠として、業務操作を再実行しないでください。

まだ確認できていないこと

  • EA-221-UNKNOWN-01

    SMTP/API、DNS、実際のwebhook、インボックスは未試験です。ネイティブのMIME/SQLiteと合成ゲートは、実際の配送の証拠にはなりません。SMTPのCRLFによるネイティブな期待値の差は保存し、正式な承認テキストとワイヤバイトを区別してください。

根拠資料

  • 研究資料研究資料

    M1

    原資料を開く

    確認上の限界

    元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。

  • 研究資料研究資料

    M2

    原資料を開く

    確認上の限界

    元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。

  • 研究資料研究資料

    M3

    原資料を開く

    確認上の限界

    元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。

  • 研究資料研究資料

    M4

    原資料を開く

    確認上の限界

    元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。

  • 研究資料研究資料

    M5

    原資料を開く

    確認上の限界

    元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。

  • 研究資料研究資料

    M6

    原資料を開く

    確認上の限界

    元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。

  • 研究資料研究資料

    M7

    原資料を開く

    確認上の限界

    元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。

  • 研究資料研究資料

    M8

    原資料を開く

    確認上の限界

    元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。

  • 研究資料研究資料

    M9

    原資料を開く

    確認上の限界

    元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。

  • 研究資料研究資料

    M10

    原資料を開く

    確認上の限界

    元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。

更新履歴

  1. EA-221-GAP-FIRST-20261004: 正式な 監査/publication 対応付け

出典ID・検証情報・機械可読データ

根拠の種類と情報の鮮度は、ラベルとアイコンで確認できます。

記事ID
EA-221
最終確認日
2026-10-04
提供元・モデル・プラン・利用環境
—
対象地域
—
元資料の全文と収録照合記録
PUBLIC_CLAIM

Agentのdraftを送信操作へ変換する際は、全recipientと本文・添付の承認、domain認証、重複防止、配送event、suppressionを個別に追跡する。

ESTABLISHED

Resendのidempotency keyは24時間の窓で同一requestの再送を抑える。長期停滞後の重複防止には組織outboxの照合が必要である。[M2] SESのSENDは配送の試行開始で、suppressionにより配達しない場合もある。Postmarkのdeliveryはrecipient serverの受付であり、inbox到達ではない。[M5, M6] Resend署名はraw bodyを検証する。retry/replayをdedupし、SendGridのECDSA方式とは別adapterにする。suppressionのscopeと解除条件はproviderごとに照合する。[M3, M4, M7, M8, M10] 現行DMARC RFC9989はauthor domainと認証identifierのalignmentを定義し、RFC7489/9091をobsoleteとする。domain認証は本文の正しさや業務承認の証拠ではない。[M9]

INFERENCE

To/Cc/Bcc、subject、body、添付hashとrevisionを承認に結び付け、変更後は再承認する記録は組織提案である。providerの有限key保持を永続exactly-once保証へ移さない。

FAILURE_ENVELOPE

成功後timeout、key TTL越え、未承認Bcc/添付、header injection、event重複・遅延・順序反転、bounce/complaint履歴消去、抑止先の自動解除を試験する。

AVAILABILITY_GATES

実domain/DNS/From/Return-Path、recipient権限、署名SDK、region・quota、outbox容量、provider key/抑止scope、費用とcallbackを確認する。[M1–M4,M7,M8]

SECURITY_PRIVACY_AUDIT_OPERABILITY

keyと本文/添付を保護し、公開claimを送信権限としない。outcome不明ならprovider IDとoutboxを照合し、新しいkeyで無限再送しない。signature有効性だけで業務操作を再実行しない。

UNKNOWN_AND_STOP_CONDITION

SMTP/API・DNS・実webhook・inboxは未試験。native MIME/SQLiteと合成gateは実配送の証拠ではない。SMTPのCRLFによるnative期待差は保存し、canonical approval textとwire bytesを分ける。

SOURCES
  • EVD-EA-221-URL-5057CA91CAA3研究資料研究資料根拠の出所: SOURCE_PACKET_REFERENCE

    M1

    裏付ける内容
    —
    確認日
    —
    出典・実験ID
    SRC-EA-221-URL-5057CA91CAA3
    検証箇所
    SOURCES · - M1 https://resend.com/docs/dashboard/domains/introduction
    適用範囲
    SOURCES
    出典・来歴
    SOURCE_PACKET_REFERENCE_PROJECTED
    限界
    元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。
  • EVD-EA-221-URL-FE61B8992345研究資料研究資料根拠の出所: SOURCE_PACKET_REFERENCE

    M2

    裏付ける内容
    —
    確認日
    —
    出典・実験ID
    SRC-EA-221-URL-FE61B8992345
    検証箇所
    SOURCES · - M2 https://resend.com/docs/dashboard/emails/idempotency-keys
    適用範囲
    SOURCES
    出典・来歴
    SOURCE_PACKET_REFERENCE_PROJECTED
    限界
    元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。
  • EVD-EA-221-URL-80250F6E9B30研究資料研究資料根拠の出所: SOURCE_PACKET_REFERENCE

    M3

    裏付ける内容
    —
    確認日
    —
    出典・実験ID
    SRC-EA-221-URL-80250F6E9B30
    検証箇所
    SOURCES · - M3 https://resend.com/docs/webhooks/verify-webhooks-requests
    適用範囲
    SOURCES
    出典・来歴
    SOURCE_PACKET_REFERENCE_PROJECTED
    限界
    元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。
  • EVD-EA-221-URL-64B5D04F5802研究資料研究資料根拠の出所: SOURCE_PACKET_REFERENCE

    M4

    裏付ける内容
    —
    確認日
    —
    出典・実験ID
    SRC-EA-221-URL-64B5D04F5802
    検証箇所
    SOURCES · - M4 https://resend.com/docs/webhooks/retries-and-replays
    適用範囲
    SOURCES
    出典・来歴
    SOURCE_PACKET_REFERENCE_PROJECTED
    限界
    元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。
  • EVD-EA-221-URL-5CE7F040BCDC研究資料研究資料根拠の出所: SOURCE_PACKET_REFERENCE

    M5

    裏付ける内容
    —
    確認日
    —
    出典・実験ID
    SRC-EA-221-URL-5CE7F040BCDC
    検証箇所
    SOURCES · - M5 https://postmarkapp.com/developer/webhooks/delivery-webhook
    適用範囲
    SOURCES
    出典・来歴
    SOURCE_PACKET_REFERENCE_PROJECTED
    限界
    元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。
  • EVD-EA-221-URL-3375B9931229研究資料研究資料根拠の出所: SOURCE_PACKET_REFERENCE

    M6

    裏付ける内容
    —
    確認日
    —
    出典・実験ID
    SRC-EA-221-URL-3375B9931229
    検証箇所
    SOURCES · - M6 https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_EventDestination.html
    適用範囲
    SOURCES
    出典・来歴
    SOURCE_PACKET_REFERENCE_PROJECTED
    限界
    元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。
  • EVD-EA-221-URL-052B4CFC3701研究資料研究資料根拠の出所: SOURCE_PACKET_REFERENCE

    M7

    裏付ける内容
    —
    確認日
    —
    出典・実験ID
    SRC-EA-221-URL-052B4CFC3701
    検証箇所
    SOURCES · - M7 https://postmarkapp.com/developer/api/suppressions-api
    適用範囲
    SOURCES
    出典・来歴
    SOURCE_PACKET_REFERENCE_PROJECTED
    限界
    元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。
  • EVD-EA-221-URL-83C9975D716F研究資料研究資料根拠の出所: SOURCE_PACKET_REFERENCE

    M8

    裏付ける内容
    —
    確認日
    —
    出典・実験ID
    SRC-EA-221-URL-83C9975D716F
    検証箇所
    SOURCES · - M8 https://resend.com/changelog/suppression-list-support
    適用範囲
    SOURCES
    出典・来歴
    SOURCE_PACKET_REFERENCE_PROJECTED
    限界
    元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。
  • EVD-EA-221-URL-5DA292FF1B92研究資料研究資料根拠の出所: SOURCE_PACKET_REFERENCE

    M9

    裏付ける内容
    —
    確認日
    —
    出典・実験ID
    SRC-EA-221-URL-5DA292FF1B92
    検証箇所
    SOURCES · - M9 https://www.rfc-editor.org/rfc/rfc9989.html
    適用範囲
    SOURCES
    出典・来歴
    SOURCE_PACKET_REFERENCE_PROJECTED
    限界
    元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。
  • EVD-EA-221-URL-9B1CC81C37C9研究資料研究資料根拠の出所: SOURCE_PACKET_REFERENCE

    M10

    裏付ける内容
    —
    確認日
    —
    出典・実験ID
    SRC-EA-221-URL-9B1CC81C37C9
    検証箇所
    SOURCES · - M10 https://www.twilio.com/docs/sendgrid/for-developers/tracking-events/getting-started-event-webhook-security-features
    適用範囲
    SOURCES
    出典・来歴
    SOURCE_PACKET_REFERENCE_PROJECTED
    限界
    元の監査済み資料に記載された参照先です。URLの復元は、資料の最新性や全主張の支持を新たに検証したことを意味しません。
  • EA-221-R11-RESEARCH研究資料研究資料根拠の出所: AUDITED_CANONICAL_RESEARCH_PACKET

    EA-221 監査済みresearch / canonical revision binding

    裏付ける内容
    Resendのidempotency keyは24時間の窓で同一requestの再送を抑える。長期停滞後の重複防止には組織outboxの照合が必要である。[M2] SESのSENDは配送の試行開始で、suppressionにより配達しない場合もある。Postmarkのdeliveryはrecipient serverの受付であり、inbox到達ではない。[M5, M6] Resend署名はraw bodyを検証する。retry/replayをdedupし、SendGridのECDSA方式とは別adapterにする。suppressionのscopeと解除条件はproviderごとに照合する。[M3, M4, M7, M8, M10] 現行DMARC RFC9989はauthor domainと認証identifierのalignmentを定義し、RFC7489/9091をobsoleteとする。domain認証は本文の正しさや業務承認の証拠ではない。[M9]
    確認日
    2026-10-04
    出典・実験ID
    EA-221-GAP-FIRST-20261004
    検証箇所
    EA-221-GAP-FIRST-20261004 · content/staging/EA-221.md
    適用範囲
    監査済みEA本文・canonical revision・既存Source Graph relationの範囲。欠損currentnessは推測で閉じない。
    出典・来歴
    AUDIT_PASS_CANONICAL_BINDING
    限界
    canonical監査・revision bindingの存在を示す。外部ソースcurrentnessが本文またはcontrol-planeで確定していない場合は、currentnessをUNKNOWNのまま保持する。
  • EA-221-R11-WEB-READBACK実装資料実装資料根拠の出所: IMPLEMENTATION_READBACK

    EA-221 Web body identity / canonical readback

    裏付ける内容
    canonical staging bodyのSHA-256一致とR9 canonical ledger readbackをProduction projectionの入力として検証する。
    確認日
    2026-10-04
    出典・実験ID
    WEBBODY-EA0221-R8-7489C82B
    検証箇所
    WEBBODY-EA0221-R8-7489C82B · content/staging/EA-221.md · EA-221-GAP-FIRST-20261004
    適用範囲
    R9/R10 canonical readback後のProduction生成時body identity。
    出典・来歴
    CANONICAL_READBACK_BODY_HASH_MATCH
    限界
    body identity/readbackは本文claim自体の真偽や外部ソースの最新性を追加保証しない。
出典ID
EA-221-GAP-FIRST-20261004, SRC-EA-221-URL-5057CA91CAA3, SRC-EA-221-URL-FE61B8992345, SRC-EA-221-URL-80250F6E9B30, SRC-EA-221-URL-64B5D04F5802, SRC-EA-221-URL-5CE7F040BCDC, SRC-EA-221-URL-3375B9931229, SRC-EA-221-URL-052B4CFC3701, SRC-EA-221-URL-83C9975D716F, SRC-EA-221-URL-5DA292FF1B92, SRC-EA-221-URL-9B1CC81C37C9, WEBBODY-EA0221-R8-7489C82B
追跡中のUNKNOWN ID
EA-221-UNKNOWN-01
再確認のきっかけ
正式な 改訂版/publication 状態 change · 本文 成果物 hash change · 出典 現行性 change · new contradiction or 実装 結果の照合

機械検査: 通過 — 機械検査の結果です。情報の正確性や実行の承認を保証するものではありません。

    同じ記事IDの機械可読データです。