Caspeco webhooks

Owned by David Thorarinsson (Deactivated)
Last updated: dec. 01, 2022

Our Implementation of Webhooks

Caspeco Coud provides webhooks for the transmission of real-time update of employee and booking actions. The webhooks uses HTTPS for the transmission of events in Caspeco Cloud to one or more receiving endpoints in the form of JSON messages. For more information on our JSON-payloads, see:

https://caspeco.atlassian.net/wiki/spaces/DD/pages/3287842824

If you’d rather get an employees state before and after an event - this can be configured, see:
[TODO: Insert guide for configuring snapshot webhooks (Not Yet Implemented)]
https://caspeco.atlassian.net/wiki/spaces/DD/pages/3435462718

 

The employee-related events differ slightly from the more “traditional” implementation pattern of webhooks as the Caspeco system allows the user to create future changes or “change points” on an employment. The future change points are put in a message queue awaiting transmission. Once the scheduled change points take effect the queued web hook messages are sent in the same manner as the real-time event messages. For more information on how the employee webhook events are triggered, see:

https://caspeco.atlassian.net/wiki/spaces/DD/pages/3309895685

 

Creating and Configuring Webhooks in Caspeco Cloud

Your webhook events and receiving end-points must be registered in Caspeco Cloud. The Caspeco webhooks expect a public HTTPS-endpoint which is to be registered on the webhook page in Caspeco Cloud. Your endpoint(s) must be configured for parsing of the JSON-payloads of the event messages which are sent via POST-requests to your endpoint(s). Upon message receival a 200 (OK)-status messages is expected to be returned from the receiving endpoint. For more information on how to configure your webhook events in Caspeco Cloud, see:

 

Securing your Webhooks (Recommended)

Caspeco webhooks allows you to create a signature to help you verify that the webhook messages are actually coming from Caspeco and not some other server acting like Caspeco. For more information on how to create and use a signature, see: