Webhook Delivery
Receive HMAC-signed HTTP payloads when transcription completes, analytics run, or alert rules trigger.
⚠️Requires Audit & Export Pack. Only Admin roles can configure webhooks.
Configuring webhooks
- Go to Admin → Settings.
- Expand the Webhook Settings section.
- Enter the webhook endpoint URL (HTTPS required).
- Enter a secret key (used for HMAC signing).
- Click Save.
Test ping
Send a test ping to verify your endpoint is reachable.
- Click Send Test Ping in the Webhook Settings section.
- A synchronous test payload is fired to your endpoint.
- The HTTP response status is shown on screen.
Event types
| Event | Description |
|---|---|
| transcription.completed | Transcription finished and transcript data is available |
| analytics.completed | AI analytics (summary, emotion, intent, quality) have completed |
| alert.triggered | An alert rule's condition was met and the alert fired |
Signature verification
Every webhook request includes an X-KoeIQ-Signature header — an HMAC-SHA256 hex digest of the raw request body, keyed with your webhook secret.
Python verification example:
import hmac, hashlib
def verify_signature(body: bytes, secret: str, signature: str) -> bool:
expected = hmac.new(
secret.encode(), body, hashlib.sha256
).hexdigest()
return hmac.compare_digest(expected, signature)