Managing webhooks

Webhooks send events from Klang to your own server. Use them to update a CRM, post to a chat tool, or kick off any process when a meeting finishes processing.

Webhooks are personal. Each webhook belongs to one user and only receives events for content that user has access to.

Create a webhook

1. Open Settings → Developers → Webhooks
2. Click Create webhook

3. Enter the URL that should receive the events. It must be a public HTTPS endpoint
4. Optional: Add a Description so you can recognize the webhook later
5. Select which events to subscribe to. All three are selected by default
6. Click Create

Klang shows the signing secret once after creation. Copy it and store it somewhere safe. You will use it to verify that incoming requests come from Klang.

Available events

• conversation.ready: the transcript and AI analysis are finished and ready to fetch
• conversation.failed: processing failed for a meeting or file
• conversation.deleted: a meeting or file was deleted

Each event payload includes an event ID, the event type, and a reference to the conversation. For the full payload schema, signature header format, and example verification code, see the webhook documentation.

Monitor deliveries

Click any webhook to open its detail page.

The detail page shows:

• Status and URL at the top, with a toggle to pause deliveries
• Signing secret: click Show to reveal or Copy to copy it
• 24-hour stats: delivered count, error rate, average response time, and activity
• Latest deliveries: one row per delivery attempt. Click a row to see the request body and your server’s response

Klang retries failed deliveries up to six times with backoff. A webhook is automatically paused after 25 consecutive failures. Fix your endpoint, then turn Receiving events back on.

Send a test event

To check that your endpoint works:

1. Open the webhook detail page
2. Click Send test event in the top-right corner
3. If your webhook is subscribed to more than one event, choose which event to send
4. Watch the new row appear in Latest deliveries

Test events are marked with a TEST tag and use event IDs prefixed with evt_test_. The payload schema matches a real event so you can verify your handler end to end.

Pause or delete a webhook

On the webhook detail page:

• To pause, turn off Receiving events. Klang stops sending events but keeps the webhook and its history
• To delete, click Edit, then Delete webhook at the bottom of the dialog

You can also pause or delete from the … menu on the webhooks list.

Next steps

• Read the webhook documentation for payload schemas and signature verification
• Manage your integrations to send events through built-in services like Slack instead
• Build a flow if you want to transform content before it leaves Klang