Webhooks provide a way for notifications to be delivered to an external medium (e.g. HTTPS push, slack) whenever certain events occur on spektr.
About webhooks
Webhooks let you subscribe to events happening in spektr and automatically receive a notification to your server whenever those events occur.
Webhooks are used to receive data as it happens, as opposed to polling an API (calling an API periodically) to see if data is available. With webhooks, you only need to express interest once, when you create the webhook.
Webhooks are used in a wide range of scenarios, including:
- Receive information about executing processes, for example getting an notification every time an onboarding process executes, gives you information about service calls and when.
- Stay on top of what happens to your customers, for example if one customers gets a certain tag (high risk, for instance) after a monitoring process. Being notified immediately can help you build contingency logic on your side.
- Reflect changes on your customers in spektr.
- Logging events as they happen on spektr, for audit purposes.
About webhooks on spektr
When you create a webhook, you specify a URL and subscribe to events that occur on spektr. When an event occurs, spektr will send an HTTPS request (or Slack) with data about the event to the URL that you specified. If your server is set up to listen for webhook deliveries at that URL, it can take action when it receives one.
For example, you could subscribe your webhook to events that occur when a process starts, a customer status changes, an AML alert is created or a a process ended. Your server could respond by sending a notification, adding information collect to your customers or creating a ticket in your own alerting system.
- You must create a webhook on spektr's platform.
- You can set the rate limit.
- And the delivery method. We support HTTPS push and Slack notification.
- When a non 200 response is received by Spektr, 3 retries will be attempted, at 1 second intervals.
- At least once delivery is guaranteed.
