This section provides all the information you need to understand the different types of webhook errors that can occur, how to detect and diagnose them, and most importantly, how to handle them in a way that minimizes downtime and disruption to your workflow.
If Bodyguard.ai fails to send a notification to your configured webhook URL, the retry policy will begin. This system is designed to keep trying to send the notification while your webhook URL is unreachable.
If your webhook URL remains unreachable for an extended period of time, the webhook status will be updated to
In this case, you will need to manually re-enable it through the dashboard.
How it works
If there is an issue with your webhook URL, a warning email will be sent to provide more details. Additional warning emails will be sent if the issue persists.
If the problem is resolved within the retry time interval, a recovery email will be sent to confirm that everything is back to normal.
However, if the problem persists beyond the retry strategy, you will receive a final email notifying you that
your webhook status is now
BROKEN (see webhook statuses for more information).
After the full retry policy time has elapsed, there are two possible use cases:
- At least one notification was successful during the entire retry period:
- You will receive a delivery failure email.
- The webhook will still be
ENABLED, but you should investigate to determine the cause of the failed notification.
- No notifications were sent successfully during the entire retry time:
- You will receive a broken webhook email.
- The webhook status will be set to
BROKEN, and in order to resume receiving notifications, you must fix the issue.
Here are examples of emails that are sent during a retry policy:
This email is sent at the first failure, and once in a while during the full retry time.
This email is sent when communication succeeds again after a failure.
This email is sent after the full retry time when no notification has ever been sent.
This email is sent after the full retry time when a notification has not been successfully sent, even though other notifications have succeeded (the webhook is not set as broken).