Webhook Best Practices

Overview

Webhooks provide a powerful method to be alerted of new actionable events occurring within your Talroo Job Customer. Review these best practices to ensure your webhooks remain secure and function seamlessly with your integration.

Event types

Your webhook endpoints should be configured to receive only the types of events required by your integration. Listening for extra events (or all events) is inefficient and is not recommended.

You can change the events a webhook endpoint will receive by working with your Talroo POC.

Retry logic

Talroo attempts to deliver your webhook events up to 100 times, at least 10 minutes apart, or until a 2xx response code is returned.

Event handling

Handling webhook events correctly is crucial to making sure your integration’s business logic works as expected.

Handle duplicate events

Webhook endpoints might occasionally receive the same event more than once. We advise you to guard against duplicated event receipts by making your event processing idempotent. One way of doing this is logging the events you’ve processed, and then not processing already-logged events.

Security

Keeping your endpoints secure is critical to protecting your information.

Verify events are sent from Talroo

Verify webhook signatures to confirm that received events are sent from Talroo.