What happens when webhook or cloud integrations fail?
In rare cases, webhooks and cloud integrations can fail to send your data successfully. This can happen for a variety of reasons, for example if the target server does not respond in time or if network issues occur somewhere between our servers and the target server. Most of the time issues like this are temporary and resending the data is sufficient to resolve the issue.
Setting Up Webhook and Cloud Integrations Alerts
Docparser comes with built-in alerts for webhooks and cloud integrations. You can set one or multiple email recipients in the settings of your document parser (Settings > Advanced Settings). Whenever a webhook or cloud integration fails, we'll send an alert to the provided email addresses.
Inspecting Failed Webhooks
A request is considered as 'failed' when the target application or API responds with a HTTP status code other than 2XX or 3XX. If the request times out (no response after 40 seconds), we will set the response code to 0 and also consider the request as failed.
All documents with failed webhook and cloud integration requests can be found in a dedicated list called 'Failed Webhooks'.
You can inspect all outgoing HTTP requests for one document by navigating to the document in the list of imported documents, clicking on the document and then then navigating to `Webhooks`.
Furthermore, you can click on a specific webhook which will reveal all details of the HTTP request, including the original payload and the answer received from the target server.
Retrigger Failed Webhooks And Cloud Integrations
If you want to re-send failed webhooks, you have basically two options.
You can send a specific HTTP request by clicking on "Replay" next to the failed request (see screenshot above). This will use the original HTTP request stored in our database and simply resend the exact same data.
Alternatively, you can also select a specific document in the document list and choose "Move to Integrations Queue" in the dropdown above the list. This will create a new HTTP request for every integration you created for your document parser.