Webhooks

Webhooks allow you to receive real-time notifications when a call is processed or a transcript is ready.

Payload Structure

The webhook payload is a JSON object sent to your configured URL via POST request.

Example Payload

{
  "version": "1.0",
  "event": "call.analysis.completed",
  "created": "2025-12-13T03:41:33.818878+00:00",
  "data": {
    "transcriptUrl": "https://0cadfe27141683eac10a20f5963f7a9a.r2.cloudflarestorage.com/comswise-prod/org.../transcript.md...",
    "executiveSummary": "# Call Analysis\n\n- *Customer Goal:* To follow up on an overdue payment of ₹856 for two Vodafone corporate numbers.\n- *Outcome:* *Unresolved. The call was misdirected to the Security department.\n\n## Call Details\n\n- **Customer Name:* Archana\n- *Subject:* Overdue payment for Vodafone corporate numbers.\n- *Amount Due:* ₹856\n- *Issue:* The customer reached the Security department instead of the Accounts department.\n- *Staff Action:* The staff member correctly identified the misdirected call and instructed the customer to contact the Accounts department.",
    "id": "jd784mh5qkwyarkyrmhndqj4s17x77gs",
    "callId": "018856e9-3396-41ca-8852-de5a1a22c455"
  }
}

Fields

Field	Description	Format
`data.transcriptUrl`	A signed URL to download the full transcript.	Markdown (`.md`) file.
`data.executiveSummary`	A summary of the call.	Markdown string.
`data.id`	The internal ComsWise ID for the call.	String.
`data.callId`	Your external reference ID provided during creation.	String.

Event Types

Currently, we support the following events:

Event	Description
`call.analysis.completed`	Triggered when AI processing is finished and transcripts/summaries are available.

Security

We send an Authorization header with every request if a Signing Secret is configured.

Authorization: Bearer <your-webhook-secret>

You should verify this header value against the secret you configured in the dashboard to ensure the request came from us.