Sookly
ENไทย

Set up webhooks

Send Sookly conversation events to external systems through secure endpoints.

Who this is for: DeveloperEstimated time: 35 minutes

Table of contents

Prerequisites

  • Admin access in Sookly.
  • A public HTTPS endpoint with request logging.
  • Ability to deploy endpoint updates quickly.

Steps

  1. Create webhook receiver endpoint in your system.
  2. Open Settings → Developer → Webhooks in Sookly.
  3. Add endpoint URL and select event types.
  4. Implement signature validation and idempotent processing.
  5. Run test events and confirm 2xx response handling.
  6. Monitor retries and error logs for production readiness.

What success looks like

  • Webhook events arrive with expected payload shape.
  • Duplicate processing is prevented by idempotency logic.
  • Operational monitoring is in place for failures.

Common issues and fixes

  • Issue: Webhook retries continue even after endpoint changes.

    Fix: Ensure endpoint returns fast 2xx responses and move heavy processing async.

  • Issue: Signature validation fails intermittently.

    Fix: Verify shared secret, header parsing, and canonical payload handling.