Developer documentation
Build phone agents on zlicx.
Set up an agent, connect it to a phone line or your website, and run it from your own code.
Create an agent
curl --request POST 'https://api.in.zlicx.ai/api/v1/agents' \
--header 'x-api-key: YOUR_ZLICX_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Support Agent",
"isActive": true,
"templateId": "support"
}'Start here
Three steps to a working agent.
- 01Build an agentWrite its instructions, choose a language and voice, and talk to it in your browser.Your first agent
- 02Put it on a lineConnect the SIP trunk you already use, or add a talk button to your website.Connect a trunk
- 03Control it from codeCreate agents, place calls and read results with the REST API.Open the API
Ways to connect
Pick where your agent meets people and systems.
REST API66 documented routes for agents, numbers, calls, campaigns and more.MCP server33 tools and 26 resources for operating zlicx from an AI client.SIP trunksKeep your carrier and numbers. Route them to agents on our voice engine.Website widgetEmbed a voice button, or build your own interface on the public session API.
Inside a call
Five stages, repeated for each reply.
How a call runs- 01
Hear
Streams caller audio to speech-to-text and detects the end of the turn.
- 02
Decide
Sends the turn to your language model, with your instructions.
- 03
Act
Calls your tools, MCP servers or knowledge base when needed.
- 04
Speak
Plays the reply sentence by sentence, and stops if interrupted.
- 05
Record
Saves the transcript and analysis, then sends your webhook.
API basics
One base URL, one key.
- Base URL
- https://api.in.zlicx.ai/api/v1
- Region
- The API is hosted in our India region
- Auth
- Organisation API key in the
x-api-keyheader - Permissions
- Each key carries its own permissions, and each route checks them
{
"success": true,
"message": "Agents fetched successfully",
"data": []
}