Getting Started
Webhooks enable you to receive real-time notifications whenever specific events occur in our system. This allows you to automate workflows, update data, and respond to events immediately, seamlessly integrating Captino into your existing systems.
Step 1: Set Up a Webhook Endpoint
To receive webhooks, you’ll need to set up an endpoint on your server that can accept HTTP POST requests. This endpoint should:
- Listen for incoming requests from our webhook service.
- Process JSON payloads.
- Respond with an HTTP
2XXstatus code when the webhook is received successfully.
Step 2: Register Your Webhook
To register a webhook, follow these steps:
- Log into your Captino account and navigate to the Webhooks section in your account settings.
- Click Add New Webhook.
- Enter the URL of the endpoint you set up in Step 1.
- Select the events you want to subscribe to (for example,
funnel.created, etc.). - Save the webhook. Once saved, Captino will start sending event notifications to the specified endpoint.
Timeouts and Retries
To ensure timely and reliable webhook delivery, Captino enforces a 5 second timeout for each webhook request. If we do not receive a successful response within 5 seconds, the webhook attempt is marked as failed, and we will automatically queue it for retry.
Retry Strategy
Captino retries failed webhook deliveries up to 10 times, employing an exponential backoff strategy to space out the attempts. This approach helps reduce the risk of overwhelming your server and increases the likelihood of successful delivery under temporary network issues. The interval between retries increases progressively as follows:
| Retry Number | Delay | Total Time Elapsed |
|---|---|---|
| 1 | 5s | 5s |
| 2 | 10s | 15s |
| 3 | 30s | 45s |
| 4 | 1m | 1m 5s |
| 5 | 5m | 6m 5s |
| 6 | 10m | 16m 5s |
| 7 | 30m | 46m 5s |
| 8 | 1h | 1h 46m 5s |
| 9 | 2h | 3h 46m 5s |
| 10 | 4h | 7h 46m 5s |