Get a quick quote with our pricing calculator

Knowledge Base

Browse our knowledge base articles to quickly solve your issue.

Knowledgebase articles

Integration Monitoring & Error Handling

When a document is signed using the integration, the signed document is stored in Workbooks by default. If you have configured any field mappings, at the point of signature, the submitted values from the document are also stored back in Workbooks. From time to time, a problem with the integration may result in the form not writing back to Workbooks. If this happens, the integration will write a record to API Data giving details of the issue as follows:

  • Adobe Sign Agreement Id
  • Record Id of the source document
  • Record Type of the source document
  • The Agreement Name
  • The Agreement Sender
  • The error that occurred when trying to update the record

Adobe Sign will automatically try again if an agreement event fails to sync with Workbooks. Each failed attempt will result in a retry, Adobe Sign will double the time between attempts. This starts with a 1-minute interval increasing to every 12 hours. A maximum number of 15 retries will occur over the course of a 72 hour period, at which point the Adobe Sign Webhook will be disabled for ALL agreements. If this happens, you will need to manually enable the Webhook again, see here for details on how to do this direclty in Adobe Sign. 

A failed document may continue to fail until the underlying cause of the issue has been resolved. To help identify when there has been an issue, you can build a report on API Data records. If anything appears on the report, then there has been an issue with the integration.

NOTE: Workbooks Support does not actively monitor your Adobe Sign integration. If you are unable to resolve the issue, please contact us via support@workbooks.com with details of the issue stored in API Data.
We have created a Report Template which can be saved to your Workbooks database. Click Start > New > Report > Create a report from a template report. Add a filter to find the report called “TEMPLATE – Adobe Sign Integration – Error Monitor”. Save a copy to your database. You may wish to pin the report to your desktop so you see it when you login, or setup a Scheduled Report Email to periodically review the integration errors. A scheduled email can be configured to only send if there are rows on the report using the “Send if empty” setting. See here for more information.
Previous Article Installing the Integration Next Article Setup of Adobe Sign