Webhooks allow you to subscribe to events from Onna. In the compliance case, you can receive a notification to your service anytime Onna finds a document that matches your smart action criteria. You can then use that information to populate external systems, such as a ticket tracking system.
You need to setup the webhook first, before creating your Smart Actions.
Add a Webhook
To add a new webhook, navigate to the Admin Preferences > Compliance Tab and expand the webhooks section to add a new webhook.
When adding a webhook, you'll need to provide a name and url with the option to provide a secret.
Description of fields:
- Payload URL: URL where Onna will be submitting a JSON payload with information about the matched resource
- Secret (Optional): To ensure you are only validating events sent by Onna, you can share a random string (the secret) that will be used to compute a hash of the payload. This value will be sent to your service in the “x-onna-signature” header. Your service will calculate the hash using the same secret and ensure that both hashes match before accepting it.
"title": "Form of Shareholders Agreement Resources, Inc.pdf",
"title": "SSN Smartaction",