Your first agent

This guide takes you from an empty account to a working agent. You can do the first three steps in the console without a phone number.

1. Create the agent

  1. Open Agents in the console and choose Create agent.
  2. Give it a name.
  3. Pick a template. Business, Support, Medical and Questionnaire come with suggested instructions and analysis fields. Blank starts empty.

2. Tell it what to do

On the Behavior tab, set the first message and the instructions. Keep the job narrow to begin with:

  • Say who the agent is calling for, and that it's an AI assistant.
  • List what it may do, and what it should leave to your team.
  • Tell it to report an action as done only after the tool has succeeded.

Recording disclosure

If you record calls or keep transcripts, callers must be told. Set the agent's recording disclosure: a short sentence, such as “This call is recorded for quality and training”, that the agent speaks at the start of every call before anything else. You are responsible for its wording and for keeping it on wherever the law or your own policy requires it.

On Models & Voices, choose the language, then the speech, language and voice models. Each agent runs in one language. To serve both Hindi and English callers, create one agent for each and route callers before the call starts.

3. Talk to it

Open the preview panel on the agent and choose Start preview. Allow your microphone and talk to it. Try interrupting it, ask for something outside its job, and give it a wrong answer on purpose.

4. Connect a line

Choose how callers reach the agent:

  • Your own carrier. Follow the SIP trunk guide to keep your numbers.
  • A rented number. Open Phone numbers, buy one, and assign your agent to it.
  • Your website. Follow the widget guide. No phone number is needed.

5. Record what you need

On the Analysis tab, add the fields you want from each call, such as an outcome or a callback time. On Webhooks, set a post-call webhook to send results to your own system.

6. Place a call from the API

Create an API key under Settings → API keys, then start a call. agentId is the agent's ID, and phoneNumber is the full number with its country code.

curl
curl --request POST 'https://in-api.zlicx.ai/api/v1/outbound-calls/quick' \
  --header 'x-api-key: YOUR_ZLICX_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "agentId": "AGENT_ID",
    "phoneNumber": "+919876543210",
    "consentAttested": true
  }'

Only set consentAttested if the person really agreed to be called, because it's stored as your consent record. Outbound calls only ring inside the agent's calling hours, 09:00 to 21:00 by default. Numbers on your do-not-call list are refused.

Opt-out and do-not-call

If the person asks during a call not to be called again, the agent acknowledges it and zlicx adds the number to your organization's do-not-call list automatically. Later outbound calls to that number, from the API or a campaign, are refused. Only remove a number from the list if the person has given fresh consent. Calling in India must also follow TRAI's commercial-communication rules, including the DND register; see the Terms of Service.

Next steps