Webhook design
Your endpoint should accept JSON, verify the source, return quickly, and process work asynchronously.
Recommended handling
- Receive the event.
- Validate signature or shared secret when configured.
- Store the event id for deduplication.
- Queue downstream work.
- Return a successful HTTP response.
Reliability
Make webhook handlers idempotent. Providers and Chataman may retry events when a timeout or network error occurs.