웹훅 이벤트 스키마 및 디버그 템플릿

템플릿 증거 경로

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이 지원해야 하는 결정을 검토하세요.

읽기 웹훅 디버깅

템플릿

이것을 코딩 에이전트에 붙여넣으세요.

바꾸기 YOUR_API_KEY, 로컬에서 흐름을 실행한 다음 생성된 이벤트 및 대시보드를 확인합니다.

webhook-debugging

웹훅 디버깅 템플릿

text

Telemetry로 웹훅 처리.

/skill.md 및 이 Telemetry API 키를 사용하세요: YOUR_API_KEY

다음을 사용하여 webhook_received, webhook_processed, webhook_failed, webhook_retried 및 webhook_deduplicated를 기록합니다.
공급자, event_type, route_template, 상태, status_code, latency_ms, 시도, idempotency_outcome, downstream_job_count, team_id 및 error_type.

공급자별 볼륨, event_type별 실패, 재시도 비율, 중복 비율, p95 처리 시간 및 최근 실패한 웹후크에 대한 쿼리를 만듭니다.

원시 웹훅 본문, 서명, 비밀, 결제 세부정보 또는 개인 데이터를 기록하지 마세요.

캡처할 이벤트

webhook_receivedwebhook_processedwebhook_failedwebhook_retriedwebhook_deduplicated

검증 체크리스트