Webhook イベントスキーマとデバッグテンプレート

テンプレートの証拠パス

Webhook debugging template: 実装から決定まで

プロンプトを実装の概要として扱います。有用な成果物は、コピーされたコードだけではなく、信頼できる答えを生成するレビューされたイベントコントラクトです。

1
境界を設定する
Instrument the point where webhook_received becomes final.
2
契約書を作成する
Start with webhook_received, webhook_processed, webhook_failed and keep every field typed, bounded, and privacy-reviewed.
3
フィクスチャを実行する
集計結果に依存する前に、既知の成功、失敗、再試行、および空の結果のケースを実行してください。
4
質問に答えてください
どのプロバイダーイベントが最も頻繁に失敗しますか?

テンプレートとユースケースの比較

このテンプレートでイベントを追加する

測定目標がすでに明確な場合は、このテンプレートをコピーします。一致するユースケースガイドを使用して、イベントの境界、成功の定義、および結果の SQL がサポートする必要がある決定を確認します。

読み取り Webhook のデバッグ

テンプレート

これをコーディングエージェントに貼り付けます

交換する YOUR_API_KEY、フローをローカルで実行し、生成されたイベントとダッシュボードを確認します。

webhook-debugging

Webhook デバッグテンプレート

text

Telemetry を使用した Webhook 処理を計測します。

/skill.md とこの Telemetry API キーを使用します: YOUR_API_KEY

webhook_received、webhook_processed、webhook_failed、webhook_retried、および webhook_deduplicated を次のように記録します。
provider、event_type、route_template、status、status_code、latency_ms、試行、idempotency_outcome、downstream_job_count、team_id、およびerror_type。

provider別のボリューム、event_type 別の失敗、再試行率、重複率、p95 処理時間、および最後に失敗した Webhook のクエリを作成します。

生の Webhook 本文、署名、シークレット、支払い詳細、個人データをログに記録しないでください。

キャプチャするイベント

webhook_receivedwebhook_processedwebhook_failedwebhook_retriedwebhook_deduplicated

検証チェックリスト