A web call is an inbound call to the number’s agent. It appears in call history, is recorded, analysed, billed, and fires webhooks exactly like a phone call. The caller shows as
web.Enabling web calls on a number
Web calls are off by default on every number. Turn them on per number:GET the same path to read the flag, DELETE to force it off. Turning the flag off is the kill switch - every start request for that number is refused from that moment.
Pricing
Calls on a number with web calls enabled bill at **0.09/min. Both enabled is still $0.09 - never more. Web calls use no carrier, so there are no Twilio/Telnyx charges at all on these calls.Starting a call from your own page
The start endpoint is public - the number is the identity. No API key ever reaches the browser; the engine verifies the flag, the owner’s balance, the agent, and concurrency on every single request.{"ok": false, "reason": "..."} - unavailable (number unknown, feature off, or owner unfunded), busy (concurrency cap), or bad_number.
Behaviour and guarantees
- Inbound only. A web call always rings in to the number’s agent.
- Everything is inherited. Voice, prompt, language, booking tools, custom functions, transfers, webhooks, post-call analysis - whatever the number’s agent does on the phone, it does on the web.
- Interruptions work. Visitors can talk over the agent and it stops, like a phone call.
- Recording included. If recording is on for the number/agent, web calls are recorded - and an interrupted sentence is recorded only up to the moment it was cut, exactly as the visitor heard it.
- Caller identity is
web. Every visitor arrives as the same caller, so caller history and greet-by-name are deliberately skipped on web calls. - No SMS destination. A browser visitor has no phone number, so
[SEND_SMS]and booking confirmation texts cannot be delivered. Tell your agent in its prompt not to offer texts on web calls - or have it collect a mobile number first.
Related
- Web Agent widget - the embeddable Call + Chat launcher
- Live Monitor - listen to calls live at the same $0.09 rate