Table of contents
- Retry policies
- Regular webhooks and automation webhooks
- Creating a regular webhook
- Testing a webhook
A webhook is a way for Ongoing WMS to send an HTTP request to your server when some event occurs in Ongoing WMS. Using webhooks means that you don't have to poll Ongoing WMS for changes, which means that webhooks are more efficient than a traditional API integration.
As an example, you can set up a webhook which makes a call to https://yourserver.com/api/OngoingOrderPicked whenever an order is picked in Ongoing WMS. When an order is picked, the following happens:
- Order 12345 is picked in Ongoing WMS.
- Ongoing WMS triggers the webhook.
- An HTTP request is made to https://yourserver.com/api/OngoingOrderPicked, with a JSON payload indicating that order 12345 was picked.
- Your server can process this request and do what you like, such as sending an email to the end customer. If the webhook payload does not contain all the information that you want, make a request back to one of our APIs to fetch more information.
You can set a retry policy on each webhook. This determines how Ongoing WMS will react if the webhook fails. If the retry police is None, then Ongoing WMS will simply not retry a failed webhook trigger. If the retry policy is One day, then Ongoing WMS will retry the webhook several times for 24 hours.
Regular webhooks and automation webhooks
A regular webhook will only fire for a specific goods owner.
An automation webhook will trigger for all goods owners.
For instance, if you create a regular webhook for whenever an order is picked, then it will only trigger whenever an order is picked for the goods owner which you selected.
An automation webhook for whenever an order is picked will trigger whenever an order is picked for any goods owner in the system.
Creating a regular webhook
Go to Settings ⇒ Webhooks and click on Create new regular webhook and select a webhook from the list. Fill in the URL and an email address, and authentication details if applicable. Additional settings might be available depending on the type of webhook. Tick Enabled if you want to enable the webhook.
Testing a webhook
If you wish to trigger a webhook manually, for testing purposes, go to Settings ⇒ Webhooks and find the webhook in the list. Click on Test.