Testing Methods
| Method | Best For |
|---|---|
| Dashboard Test | Quick validation |
| webhook.site | Inspecting payloads without server |
| ngrok | Full integration testing with local server |
API Test Endpoint
API Test Endpoint
Send test webhooks programmatically:
Example: Test webhook response
Example: Test webhook response
Testing with webhook.site
- Visit webhook.site
- Copy your unique URL
- Use as webhook URL in test API
- Inspect full request details
Local Testing with ngrok
Setup
Setup
Local Webhook Server
Local Webhook Server
Testing Workflow
Testing Workflow
http://127.0.0.1:4040 to inspect and replay requests.
Testing Event Types
StartWebHookPayload
StartWebHookPayload
ToolWebHookPayload
ToolWebHookPayload
Testing Retry Behavior
Testing Retry Behavior
Simulate failures to test retry handling:
Testing Idempotency
Testing Idempotency
Handle duplicate webhooks:
Debugging
Common Issues
| Issue | Solution |
|---|---|
| Connection refused | Verify URL is publicly accessible |
| Timeout | Respond within 30s, use async processing |
| 401 Unauthorized | Check authentication headers |
| 500 errors | Check server logs, add error handling |
Response Time Requirements
| Event Type | Max Response Time |
|---|---|
| StartWebHookPayload | 5 seconds |
| ToolWebHookPayload | 10 seconds |
| Other webhooks | 30 seconds |
Quick Response Pattern
Quick Response Pattern
Pre-Production Checklist
- Webhook URL is publicly accessible
- Response time under required limit
- Idempotency handling for duplicates
- Error handling for all scenarios
- Logging enabled for debugging
- Tested all event types
Next Steps
- Configuring Webhooks — Set up webhook endpoints
- Webhook Events — Event types and payloads