常駐型AIチャットエージェントの「Webhook再送・順序保証なし」対応設計

常駐型AIチャットエージェントにおけるWebhookの再送や順序保証なしへの対応設計。イベント駆動で動作するAIエージェントが、プラットフォーム側の再送やネットワーク遅延による順序入れ替わりに対応するための構造的な問題点を整理。

• Webhookは再送されたり順序が入れ替わったりするため、「1回だけ・順番どおり」という前提で設計してはならない。
• 重複配信対策として、イベントIDでの冪等化を「処理前に記録する」ことで実装上の事故を防ぐ。
• 更新系イベントは受信順ではなく、イベントが持つ「更新時刻」で新旧を判定する。
• 結果が順序に依存する処理は、スレッド単位で直列化キューに詰め直してから実行する。