Handle webhook suspension
Webhook suspension refers to the disabling of the webhook notifications for shipment events due to an error.
If the webhook is suspended, it looses all its tracking data. For example, if a customer reactivates the webhook after one week, they loose one week of the tracking data. Therefore, if you do not want to loose any tracking data, then make sure to activate it promptly.
If the receiving endpoint (the system where the notifications are sent) is down or encounters errors, for example, time out, invalid data, SAPIENT may suspend sending further webhook notifications to avoid overwhelming the system.
How webhook suspension works
Suspension Process
When your webhook endpoint is down or encounters errors, SAPIENT follows a structured retry process before suspending the webhook:
- Error Detection: The system detects issues like timeouts, invalid data, or server errors
- Retry Attempts: Multiple retry attempts are made following specific intervals
- Threshold Exceeded: If all retry attempts fail, the webhook is suspended
- Notification: An email is sent to the user registered to receive the suspension notifications. This email can be specified while configuring the Webhook details.
- Retry Loop: When the webhook is suspended, it will be queued to retry again.
Retry Schedule
The system follows this retry schedule before suspending a webhook:
| Retry ID | Retry Count | Interval |
|---|---|---|
| 1 | 0 | 5 minutes* |
| 2 | 1 | 10 minutes |
| 3 | 2 | 15 minutes |
| 4 | 3 | 30 minutes |
| 5 | 4 | 5 hours |
| 6 | 5 | 18 hours |
| 7 | 6 | 72 hours |
| 8 | 7 | 72 hours |
Reactivation Process
To reactivate a suspended webhook:
- Navigate to the webhook configuration in your GUI
- Toggle the Activate switch to enable the webhook
- Monitor the endpoint to ensure it's functioning properly
Best Practices
Prevention
- Implement robust error handling
- Set up monitoring and alerting
- Ensure endpoint reliability
- Test webhook endpoints regularly
Recovery
- Monitor suspension notifications
- Reactivate webhooks promptly
- Verify endpoint functionality
- Check for missed tracking data
See also
Set Up Tracking Webhook Connection
Automate the instantaneous flow of information regarding the status of shipments.
Add Tracking Account
Establish your tracking account for seamless integration.
Set Up Manifest Webhook
Enable webhook notifications for manifest-level tracking operations.
Track Events and Milestones
Understand tracking events and milestone data.
Updated 1 day ago