What problem does it solve?
Webhook deliveries can be lost, replayed, or spoofed, causing missed orders, duplicate processing, and operational toil. This Skill provides a clear architecture and implementation guidance to verify signatures, deduplicate events, retry failed deliveries, and surface unrecoverable failures for human intervention.
Core Features & Use Cases
- Timing-safe HMAC verification for incoming providers (Shopify, Stripe) and outbound signing so recipients can authenticate deliveries.
- Idempotent receivers that mark event IDs as received before processing to prevent duplicate work under retries.
- Outbox pattern for sending with a poller, exponential backoff retry schedule (1m, 5m, 30m, 2h, 8h), SKIP-LOCKED-friendly polling, and dead-letter queue promotion with alerting and replay.
- Operational tooling: delivery attempt logging, DLQ alerting, replay mechanisms, and platform-specific setup notes for Shopify, WooCommerce, and BigCommerce.
- Use Case: Ensure Shopify order create events are verified, deduplicated, and processed exactly once even when the platform retries for 72 hours.
Quick Start
Set up an HTTPS endpoint that verifies the provider HMAC header, records the provider event ID as received, and enqueues the payload for asynchronous processing.