Skip to content
AskVault Docs
Try Free →

The Webhooks page

Written by , Founder, AskVault · Reviewed by Aashiq
Last updated: · 4 min read

Available event types

  • conversation.started.
  • conversation.escalated.
  • conversation.resolved.
  • lead.captured.
  • lead.qualified.
  • knowledge.gap_detected.
  • channel.error.
  • payment.succeeded.
  • subscription.cancelled.
  • whatsapp.opt_in, whatsapp.opt_out.
  • sentiment.threshold_crossed.

Creating an endpoint

  1. Dashboard > Webhooks > Create.
  2. Enter URL (e.g., https://yourapp.co/askvault-webhook).
  3. Pick events to subscribe.
  4. Copy the signing secret for HMAC verification.
  5. Click Save.

Verification check fires within 60 seconds.

Payload format

Standard JSON:

{
  "event": "lead.captured",
  "timestamp": "2026-05-15T10:30:00Z",
  "workspace_id": "ws_xxx",
  "data": { ... }
}

See webhooks reference for per-event payloads.

Signature verification

Every request signed:

X-AskVault-Signature: t=1715789432,v1=abc123...

Verify using the signing secret to confirm authenticity. Detailed verification at webhooks reference.

Retry behavior

If your endpoint returns non-2xx:

  • Retry 1: 30 seconds later.
  • Retry 2: 5 minutes later.
  • Retry 3: 30 minutes later.
  • After 3 failures: event logged as failed; subscription auto-paused after 100 consecutive failures.

Delivery log

For each endpoint:

  • Last 1,000 deliveries visible.
  • Per-delivery status (success / retry / failed).
  • Replay specific deliveries for testing.

Useful for debugging integration issues.

Concurrent deliveries

For high-volume workspaces:

  • AskVault sends up to 10 webhooks in parallel per endpoint.
  • Auto-throttles if your endpoint slow-responds.

Limits

  • Endpoints per workspace. 25 on Growth, 100 on Business, unlimited Enterprise.
  • Event types per endpoint. All or a subset.
  • Payload size. Up to 256 KB.
  • Delivery timeout. 10 seconds; longer fails.

Common pitfalls

Signature verification fails. Wrong secret or wrong hash algorithm. Use HMAC-SHA256.

Endpoint timeout. Your endpoint takes more than 10 seconds. Optimize or use async processing.

Subscription auto-paused. 100 consecutive failures. Fix and re-enable.

FAQ

Can I have multiple endpoints?

Yes. Each event type can fanout to multiple endpoints.

Will my endpoint receive duplicates?

Rare but possible during network issues. Implement idempotency via delivery_id header.

What's the latency?

Typically under 30 seconds from event to delivery.

Was this page helpful?