Skip to main content

Webhooks

Webhooks allow you to receive real-time notifications about incoming messages and events.

Configuring Webhooks

  1. Navigate to Webhooks in the sidebar.
  2. Click Add Webhook.
  3. Name: Give your webhook a descriptive name.
  4. URL: The endpoint where WhatsSpot will send POST requests.
  5. Secret (Optional): A string used to sign the payload for security.
  6. Message Types: Select specific types (Text, Image, etc.) or leave empty for all.
  7. Device: Assign to a specific device or "All Devices".
  8. Click Create.

Verifying Webhooks

Check Logs

You can view the delivery logs for any webhook directly in the dashboard:

  1. Click the Activity Icon (Graph) next to a webhook.
  2. See the list of recent attempts, status codes (200, 404, etc.), and response times.
  3. Click Refresh to see new events.

Security

If you provided a Secret, WhatsSpot includes a signature header X-Webhook-Signature in every request. You should verify this signature to ensure the request came from us.