Voice agents, over REST.
Whizz Voice is a REST API for building AI voice agents that answer the phone — in under a second, in the caller's own Arabic dialect. Create an agent, give it a web widget or a phone number, and it listens, reasons over your knowledge, calls your tools, and logs every call. 14 dialects, 32 languages, one all-in per-minute price.
What the API does#
Build. POST /v1/agents creates an agent from a persona, a first message, a language set, a dialect and voice, and the tools it may call. The router picks the engine for you — Arabic goes to the Dialect Engine, English and 31 other languages to the Global Engine — so you never name a vendor.
Connect. Publish the agent and reach it three ways: embed the web widget for browser calls, buy or import a phone number, or point your own SIP trunk at it. Inbound and outbound share the same agent.
Run. Take inbound calls, or place outbound calls and campaigns over the API. Every finished call fires a webhook with the recording, transcript, tool log, sentiment, and outcome; meter your minutes with the usage endpoint.
Arabic-first, by design#
The Dialect Engine hears Egyptian, Saudi, Gulf, Levantine and 10 more Arabic dialects as spoken — never flattened to MSA — and code-switches to English digits and terms the way callers actually talk. Set an agent's dialect and voice and the caller hears their own. English and 31 other languages run on the low-latency Global Engine.
The flow#
POST /v1/agents — create an agent
Persona, first message, languages, dialect, voice, and tools. The router derives the engine and pricing tier from the language set.
{ "id": "ag_…", "status": "draft", "engine_route": "dialect" }
POST /v1/agents/{id}/publish — go live
Snapshots a version and returns the web-widget embed. Attach a phone number, or point your SIP trunk at it, to take PSTN calls too.
Take or make calls — then get the receipts
Inbound over widget/number/SIP; outbound via POST /v1/calls. call.completed fires with the recording, transcript, tool log, sentiment, and outcome.
meter minutes with GET /v1/usage
Base URL#
https://voice.whizztech.ai/v1All endpoints live under /v1 and speak JSON over HTTPS. Responses carry rate-limit headers on every call.
Authentication at a glance#
Every request is authenticated with an API key in the Authorization header. Keys are created in the dashboard and start with wz_live_ or wz_test_:
curl https://voice.whizztech.ai/v1/agents \
-H "Authorization: Bearer wz_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"Details — key format, storage, and failure shapes — are on the Authentication page.