Getting Started with Voice Agent
This guide walks you through creating your first voice agent, giving it a phone number, and testing it with a live call.
Getting here
In NZ Leads, open Voice Agents → Agents → Create agent. If you have no agents yet, you can also click Create Your First Agent.
Before you start
Have the following ready:
- Company name - what the agent calls your business on calls.
- Agent name - what the agent calls itself (for example “Sarah”).
- Your prices, services you don’t provide, and common questions - the agent answers from a knowledge base. If your business already has one (for example, from Messaging Settings), the agent can use the same one.
- A calendar (optional) - NZ Leads’s Job Scheduler, or Google Calendar, Microsoft Outlook, Cal.com, LeadConnector, Housecall Pro, ServiceTitan, FieldPulse, Quickbase, or Workiz.
- Your own business phone number (optional) - if you want leads to see your number when the agent calls them, you verify it as caller ID.
Pricing for talk time and phone numbers is on the pricing page.
Create your agent
Open Create agent
Open Voice Agents → Agents and click Create agent.
Choose the Agent Type
- Office Agent - answers incoming calls and calls new leads, with one setup for both.
- Call Campaign Agent - calls a list of customers in a Call Campaign and tries to book appointments.
The type can’t be changed later.
Fill in General
- Business - the business this agent belongs to.
- Phone Number - click Choose number to pick one of your numbers or buy a new one. See Phone Numbers.
- Connected Sources (Office Agent) - the sources whose new leads the agent calls. Choose the phone number first.
- Company Name and Agent Name.
- Voice - pick a voice and click play to preview it. See Voice Selection.
The agent’s name in your agent list is made from the business and Agent Name. You can change it later under Display Name.
Check the conversation examples
Persona settings control the name, voice, tone, and conversation style. They can’t make the agent claim to be human, deny being AI, or present itself as the business owner or an employee.
Open Conversation examples in General. The first Agent: line of the Inbound Example Call is the greeting on incoming calls, and the first Agent: line of the Outbound Example Call opens calls to leads. A Call Campaign Agent has one Example of a Good Conversation instead. Edit them, or click Generate with AI for a draft.
The agent is always an AI assistant, and you can’t turn this off: whatever your examples say, it never claims to be human and never denies being an AI. Asked, it says it is an AI assistant. The default examples open with Hi, this is [[agent_name]], AI Assistant from [[company_name]]. Keep that introduction when you edit them.
Add knowledge (recommended)
In the Knowledge base section, fill in what the agent should know: about the business, prices, services you don’t provide, FAQ, and files. Unless you pick another one, the agent uses the knowledge base of its connected sources or its business, and your edits apply everywhere that knowledge base is used. To add files to a new agent, save it first. See Knowledge Base.
Connect a calendar (optional)
In Appointments, check Appointment Scheduling and choose the Scheduling Service. See Scheduling Integrations.
Set calling hours
In Calling hours, set the Timezone and the Call Schedule for calls the agent places. Incoming calls are answered at any time. A new agent takes its timezone from the Timing settings of its sources or business when one is set there.
Save
Click Save changes. If something required is missing, a message says what, and the editor opens the section with the problem. After the first save you can set up Integrations.
Make a test call
- Call the agent’s phone number.
- Let the agent greet you.
- Ask about a service, ask for a price, or try booking an appointment.
- Open Voice Agents → Call Logs to hear the recording, read the transcript, and see the AI summary.
Common next steps
- Forward your existing office line to the agent - see Call Forwarding Setup.
- Show your own business number as caller ID - see Caller ID & Spam Protection.
- Get spam approval for a US number so its calls aren’t flagged - see Caller ID & Spam Protection.
- Fine-tune the agent - see Agent Configuration.
Troubleshooting
The agent isn’t answering incoming calls.
- Confirm the number is set as the agent’s Phone Number in General.
- Confirm the agent isn’t paused: Advanced → Agent Status.
- If you forward your office line, confirm the forwarding points to the agent’s number.
The agent sounds robotic or rushed.
- Try a different voice.
- Shorten the greeting (the first
Agent:line of the example).
The agent gives wrong answers.
- Check your knowledge base for outdated or conflicting information.
- Add a Custom Rule in Advanced for edge cases.
Questions? Email support@nzleads.com.