Skip to main content
Webhooks and API

VAW Native Agent Webhooks: Events and Delivery

Send every call and chat event from a VAW Native agent to your own server, test the URL, and check or resend deliveries for each call.

Written By voiceaiwrapper

Last updated 26 days ago

Give a VAW Native agent a webhook URL and it sends every call and chat it handles to your own server: when it starts, when it ends with the full transcript, and when the analysis is done. Use it to update a CRM, start an automation in n8n, Make or Zapier, or store calls in your own database.

Setting it up takes a few minutes. Each call's details then show whether every event arrived, with a button to send it again.

Applies to: VAW Native Pods. For Vapi, Retell AI and ElevenLabs, use the campaign's Post-call event webhook. See Post-Call Event Webhook.

Before you start

  • A VAW Native agent. See Create an Agent from Scratch.
  • An endpoint that accepts POST requests. It must start with https://, be reachable from the internet, and answer with a 2xx status within 10 seconds. Local and private addresses (such as localhost or 192.168.…) are refused.
  • Optional: your signing secret, to check each request came from VoiceAIWrapper. See Verify Webhook Signatures.

Step 1: Add the webhook URL

  1. Open the agent and go to the Call Settings tab.
  2. Scroll to Webhooks at the bottom.
  3. Paste your endpoint into Webhook URL (up to 2,048 characters).

Each agent has one URL, and that URL receives every event. You can't pick which events to receive. Your server can ignore the ones it doesn't need.

Step 2: Send a test event

Click Send test event. VoiceAIWrapper sends a sample call.ended event to the URL in the field (saved or not), signed like a real one, and shows your server's answer under the field:

  • Delivered β€” 200 in 143 ms: your server accepted it.
  • Failed β€” …: the reason, for example Failed β€” Timed out after 10 s or Failed β€” Rejected with status 401.

If the URL itself isn't accepted, you see the reason in red instead, such as Webhook URL: The URL must start with https://.

The test body uses your agent's real IDs and contains "test": true, so your code can tell it apart from a real call. A test is sent once and never retried. No call is placed.

A VAW Native agent's page β†’ Call Settings tab, scrolled to the Webhooks section at the bottom: the heading Webhooks, the help text "This is the webhook URL where we send all post-call data…", a URL in the Webhook URL field, the Send test event button, and the green result line "Delivered β€” 200 in … ms" under the field. Blur the URL.

Step 3: Save the agent

Click Save changes, either at the top of the page or in the Unsaved changes bar at the bottom. Calls that start from now on send their events to this URL.

The URL is fixed for each call when the call starts. If you change or remove it, calls already in progress keep sending to the old URL. The next call uses the new one. Clearing the field and saving turns webhooks off for the agent.

The events

EventWhen it's sent
call.startedThe call is answered.
call.endedThe call has ended and its transcript is complete, a few seconds after hang-up. Sent for calls nobody answered too.
call.analyzedThe post-call analysis, every call data extraction and the final cost are done. Always the last event of a call, even if the analysis was skipped or failed.
chat.startedA chat starts and the greeting is saved.
chat.endedThe chat closes and its transcript is complete.
chat.analyzedThe chat's analysis and extractions are done. The last event of a chat.

Test calls and chats from Test agent send events too. Chat events include a source field (test, widget or preview), so you can filter out test chats.

Campaign calls: every event of a campaign call includes the campaign and the lead. If the campaign has a Post-call event webhook, the same events also go to that URL, each delivered and retried on its own. If both URLs are the same, each event is sent once.

What's in an event

Every event is a JSON POST with the same outer shape:

{
  "id": "evt_5b0c1f…",
  "type": "call.ended",
  "created_at": "2026-10-01T10:03:15Z",
  "version": "2026-10-01",
  "call": { "…": "…" }
}

Chat events carry a chat object instead of call. version only changes when the format changes in a way that could break your code. New fields are added without a version change.

The call object grows as the call moves on:

Included inWhat it adds
Every call eventCall ID, agent ID and name, Pod ID, direction, phone numbers (customer_number is the caller or the person called), status, times, duration and the call's variables
call.ended and call.analyzedEnd reason and outcome, the transcript (as text and as a list of turns), tools used, the recording link and the cost in credits
call.analyzed onlyThe full analysis: summary, sentiment, call success and every call data extraction, plus the final cost
Every event of a campaign callThe campaign (ID, name, type) and the lead (name, email, phone number, custom fields)

Recording links in events work for 7 days and need no login. If the recording is still processing, the link answers with status 409. Try again a little later and it redirects to the audio file.

How delivery works

  • Success is any 2xx answer within 10 seconds. Redirects aren't followed, so a 301 or 302 counts as a failure.
  • Retries: a timeout, a connection failure, a response body over 1 MB, or a 408, 429, 500, 502, 503 or 504 answer is retried. There are 4 attempts in total: right away, then 1 minute, 4 minutes and 10 minutes after the previous attempt, about 15 minutes in all.
  • Not retried: any other status (for example 400, 401, 404 or a redirect), or a URL that isn't allowed.
  • Duplicates can happen. An event keeps the same id on every attempt (also sent as the webhook-id header). Use it to ignore repeats.
  • Order isn't guaranteed. Each event carries the call's status and timestamps.
  • Your server can't affect the call. A slow or failing endpoint never delays or drops a call.

Check and resend deliveries

  1. Open Call Logs in your VAW Native Pod and click the call.
  2. Open the Webhooks tab.

The tab shows "Sent to" and the URL, then one card per event:

BadgeMeaning
DeliveredYour server answered with a 2xx.
RetryingThe last attempt failed and another is scheduled. Next attempt shows when.
FailedAll attempts are used up, or the failure can't be retried.
PendingNot sent yet.

Each card also shows Last sent, Attempts, Response (the status code or the error) and Event id. For a campaign call that also sends to the campaign's webhook, you see a card for each event at each URL.

Call Logs in a VAW Native Pod with one call open, on its Webhooks tab: "Sent to <url>" at the top, then event cards for call.started and call.ended with Delivered badges and call.analyzed with a Failed badge. Each card shows the Resend button and the Last sent, Attempts, Response and Event id rows; the failed card shows Attempts 4 and a Response such as "500". The line "Every attempt, with the full request and response, is in API & Webhook Logs." is visible below. Blur the URL.

To send an event again, fix your server, then click Resend on its card. Resend sends the same body with the same event id, to the URL recorded for the call, with a fresh timestamp and signature. It's a single attempt, with no automatic retries. A message tells you "Delivered β€” …" or "Failed β€” …". Resend isn't shown on a Pending card, because that event hasn't been sent yet.

Resend sends the original body. A recording link in an event that's more than 7 days old will have expired by the time you resend it.

The Webhooks tab is only in your webapp, not in the client portal. Every attempt, with the full request and response, is also in API & Webhook Logs, where VAW Native deliveries are kept for 14 days on every plan. See API & Webhook Logs.

Troubleshooting

The URL is copied onto each call when it starts. The call ran before you saved the URL, or the agent's Webhook URL was empty. Save the URL and place a new call. Events for past calls aren't sent.

On a campaign call, you see this message whenever the agent has no URL, even if the events went to the campaign's Post-call event webhook. Check API & Webhook Logs for those deliveries.

You see a message such as Webhook URL: The URL must start with https:// or Failed β€” URL not allowed: …. The URL must start with https:// and point to a public address. localhost, private network addresses and bare IP addresses on private ranges are refused. Use a public HTTPS endpoint, or a tunnelling tool that gives your local server a public https:// address.

Your endpoint answered with a redirect. This often happens when the URL is missing a trailing slash or uses the wrong subdomain. Paste the final URL the redirect points to.

call.analyzed waits until the analysis, every call data extraction and the final cost are done. That usually takes longer than the transcript. Use call.ended if you need the transcript quickly, and call.analyzed for the summary and extracted data.

Retries and Resend reuse the same event id. Store the IDs you've processed and skip any you've seen before.