Agent Configuration
The agent editor has six sections, in this order: General, Knowledge base, Appointments, Calling hours, Integrations, and Advanced. This page is the full reference for each of them.
Getting here
In NZ Leads, open Voice Agents → Agents. Click Create agent, or click Edit on an existing agent.
The Search settings… box above the sections finds a setting by name, such as “voicemail”, “transfer”, or “hours”. Click a result to jump to it.
Agent types
You choose the type in Agent Type when you create the agent. It can’t be changed afterwards; to get the other type, open the agent’s menu on the Agents page, click Clone, and choose the other type on the copy.
- Office Agent - answers incoming calls to its number and calls new leads from the sources connected to it. One setup covers both directions.
- Call Campaign Agent - calls a list of customers in a Call Campaign and tries to book appointments with them. See Call Campaigns.
General
Business & Phone
- Business - required. The business this agent belongs to. A new agent starts with the business you’re working in, or with your only business. Pick it first: the knowledge bases, sources, and calendars you can choose depend on it. If you change it while you have unsaved knowledge base edits, the editor asks first.
- Phone Number - click Choose number (or Change number) to pick one of your numbers or buy a new one. The agent places its calls from this number, and an Office Agent also answers calls to it. Click the X next to the number to take it off the agent. See Phone Numbers.
- Caller ID Phone Number - optional. The number leads see when the agent calls them. Only numbers you verified under Manage Business Phones can be selected. See Caller ID & Spam Protection.
- Spam approval - for US numbers, a button next to the number shows its spam approval status and opens Prevent Calls Going to Spam. See Caller ID & Spam Protection.
- Connected Sources - Office Agents only. The sources whose new leads this agent calls. The agent needs a phone number before a source can be connected. For a Thumbtack source, the agent’s number is registered with your Thumbtack account, because Thumbtack connects calls to its leads only from registered numbers. See Outbound Calling.
Agent Identity
- Display Name - shown when editing an existing agent. Identifies the agent in your dashboard; it isn’t spoken on calls. A new agent is named for you from its business and Agent Name (for example, “ABC Plumbing - Sarah”).
- Company Name - required. The business name the agent uses throughout conversations.
- Agent Name - required. The AI assistant name customers hear. It names an AI persona only: the agent never claims to be human.
- Voice - pick a voice and click play to preview it. See Voice Selection.
Conversation examples
Example calls that show the agent the tone and flow you want. The agent treats them as a reference, not a script. Generate with AI drafts an example for you from the agent’s settings and its knowledge base, unsaved edits included. The buttons above each editor insert the agent name, the company name, and Agent or Customer lines.
- Inbound Example Call (Office Agent) - “When a Customer Calls You”. It must start with an
Agent:line. That first Agent line is the greeting callers hear when the agent answers. - Outbound Example Call (Office Agent) - “When Calling a Lead”. It must start with an
Agent:line too, and that line is how the agent opens calls to leads. With the example empty, the agent opens withHi, this is [agent name], AI Assistant from [company name].and says it is calling about the service request. - Example of a Good Conversation (Call Campaign Agent) - the example for campaign calls. Its first Agent line opens the call the same way.
New agents start with default examples that open with Hi, this is [[agent_name]], AI Assistant from [[company_name]]. The agent is always an AI assistant: whatever your examples, rules, or knowledge base say, it never claims to be human, the business owner, or an employee, and it never denies being an AI. Asked whether it’s a robot, an AI, or automated, it says it is an AI assistant. Keep the AI Assistant introduction when you edit the first line.
Knowledge base
Knowledge base
The agent’s knowledge base: About the business, Prices, Services you don’t provide, FAQ, and Files. Pick the agent’s business in General first.
- The picker (Search knowledge bases…) shows which knowledge base the agent uses. Without a pick of its own, that’s the one its connected sources agree on, or else its business’s. You can pick another knowledge base of its business or a business above it, No knowledge base, or New knowledge base.
- Text edits are saved with Save changes and apply everywhere that knowledge base is used. They aren’t kept in the agent’s draft, so save before you leave.
- Files upload as soon as you add them. On a new agent, save the agent first to add files.
- Open in Knowledge bases opens the knowledge base on its own page, in a new tab.
See Knowledge Base and Knowledge Bases.
Service Identification (Office Agent)
- Checkbox. Default: on.
- On incoming calls, if the caller hasn’t said what they need, the agent asks your Service Question (default
what can i help you with today?). It doesn’t ask when the caller already described the job. - On calls to leads, the agent opens by referring to the service the lead requested.
- When off, the agent just listens to the caller’s request, and on lead calls it skips confirming the requested service.
Pricing
There is no switch for prices. The agent quotes only prices in the knowledge base, and only when the customer asks or your Custom Rules say to mention a price. When the knowledge base has no price for the service, the agent never guesses a number: it says the team will confirm the price. To keep prices out of calls, add a rule in Advanced → Custom Rules.
- Free On-Site Estimates - default on. When no price is available, the agent offers a free on-site estimate instead.
- Summarize Service Components - default on. After stating the price, the agent briefly says what’s included.
- Ask About Part Supply - default on. For part replacement jobs, the agent asks whether the customer has the part or needs you to supply it.
Closing Sentences (Call Campaign Agent)
Sentences the agent uses to guide the customer toward booking. Each row has a checkbox; click Add Sentence for more. Default entries, all checked:
- “When is the best time for the technician to arrive?”
- “What day works best for you?”
- “Can i save you a spot?”
Promotion (Call Campaign Agent)
Optional. The promotion the agent mentions to encourage booking, for example “Tune-up usually cost 220$ but for the promotion it is only 49$”.
Aggressive Sale (Call Campaign Agent)
- Checkbox. Default: on.
- When on, the agent works to overcome objections and keeps trying to get the customer on the schedule (for example, offering to book now with the option to cancel later). When a Promotion is set, it uses the promotion to create urgency.
- When off, the agent doesn’t use these sales tactics.
Appointments
Appointment Scheduling
- Checkbox. Default: off.
- When on, the agent books appointments during calls in the Scheduling Service you choose: Job Scheduler (the default), Google Calendar, Microsoft Outlook, Cal.com, LeadConnector, Housecall Pro, ServiceTitan, FieldPulse, Quickbase, or Workiz. See Scheduling Integrations.
- A warning icon next to the title shows booking errors from calls; click it to see them.
Information to Collect
- What the agent asks for, one field at a time, skipping anything it already knows. Each row has a checkbox and a name; click Add Field for more.
- Defaults, all checked: Customer Name, Service Address, Phone Number.
- With Appointment Scheduling on, the agent collects these before booking.
- With Appointment Scheduling off, an Office Agent collects them for your team and tells the customer the team will follow up.
- Hidden when the Scheduling Service is Job Scheduler or Cal.com (Cal.com uses the booking questions of your Cal.com event), and on Call Campaign Agents without Appointment Scheduling.
Appointment Summary
- Shown when Appointment Scheduling is on. Checkbox. Default: on.
- The template for confirming a booking. Default:
You're all set! {{day}} at {{time}}. - Placeholders:
{{day}},{{time}},{{address}},{{service}},{{phone}}. - The agent always confirms the booked day and time. If your template says goodbye, the agent ends the call with it.
Calling hours
Timezone
- Required. A new agent starts with the timezone used most in the Timing settings of its connected sources. If they set none, or two timezones are tied, it looks at its business and all the business’s sources, then at the businesses above it. If that finds nothing, it starts with
America/Los_Angeles. - Used for the Call Schedule and when the agent talks about dates and times. The Scheduling Service books in it too, except Job Scheduler, which uses its calendar’s timezone.
Call Schedule
- When the agent places calls: Always On (24/7), Any day (the same hours every day), or Specific days and times (switch days on and add hours with Add time range). A new agent calls every day, all day.
- It applies to calls the agent places: automatic calls to new leads, call retries, call-backs a customer asks for, and campaigns started from the Leads page. A call that falls outside these hours is scheduled for the next available window.
- It does not limit incoming calls: the agent answers them at any time while it is active.
- Call Campaigns created from a CSV file or by hand don’t follow it. They go out at the time you choose.
- Changing the Call Schedule does not move calls that are already scheduled.
Don’t schedule a call for leads received outside these hours
- Checkbox. Default: off.
- When on, a lead that arrives outside the Call Schedule gets no automatic call. You can still call it from the lead with More actions → Call with Voice Agent.
Integrations
Where this agent’s call reports go: email, SMS, Slack, Telegram, your CRM, or a webhook. Save the agent first.
- Agent Integrations - Add integration → Use existing or Create new. The switch on a row turns an integration on or off for this agent, and Settings opens its window. The agent uses one integration of each kind at a time.
- Source & Business Integrations - calls with a source’s leads also go to that source’s integrations. A destination used in both gets one notification, not two.
- Integration changes apply right away, separately from Save changes.
Advanced
Voicemail Message
- Required. What the agent says when a call it places reaches voicemail. The agent leaves the message and ends the call.
- Default:
Hey {{lead_name}}, sorry we could not reach you directly. Please give us a callback if you can. - Placeholders: Lead Name (
{{lead_name}}), Lead Phone ({{user_number}}), Agent Name, and Company Name.
Call Retries
- Checkbox. Default: off. Each retry is another call billed as talk time.
- When on, the agent calls a lead again when nobody picks up, the line is busy, the call is declined, or it reaches voicemail.
- Retry Delays - click Add retry for up to 5 attempts. Default: 10 minutes, then 1 hour, then 1 day. Each delay is counted from the previous unanswered attempt and can be from 1 minute to 14 days.
- A retry that lands outside the Call Schedule moves to the next available window. If there is no window within a week, the retry is skipped.
- Retries stop once the customer picks up or calls back.
- Stop retries when the customer replies in the chat - default on. A reply from the customer in the lead conversation cancels the retries.
- Stop retries when the business sends a message manually - default off. A message your team writes in the lead conversation cancels the retries.
- Calls in Call Campaigns are never retried.
- Turning Call Retries off and saving cancels the retries already scheduled.
Post-Call Data Extraction
- Call Summary Instructions - required. How the AI summarizes each call from its transcript. The default asks for
Callback: [Yes/No]. Summary: [...], where Callback: Yes means the customer’s need wasn’t fully resolved on the call.
Closing Options
- Ask “Anything Else?” Before Closing - default on. The agent gives the customer one last chance to ask something before it says goodbye.
Call Transfer
- Checkbox. Default: off.
- Transfer Criteria - leave empty to use the default criteria. Each line is a condition for a transfer.
- Transfer to Phone Number - required when Call Transfer is on, for example
+15555550100. It must use the same country code as the agent’s phone number. - Transfer Type - Cold Transfer (the default) connects the caller directly; Warm Transfer lets the agent brief the person first.
- Private Handoff Instructions - required for Warm Transfer. What the agent says to the person before the caller is connected.
- See Call Transfer.
Custom Rules
- Special instructions, policies, or guidelines for your business. Each rule has a checkbox; click Add Custom Rule for more.
- Examples:
- “Never give prices on the phone. Offer a free estimate instead.”
- “If the customer mentions an emergency, offer the earliest available time.”
- A rule that tells the agent to deny being AI or to act as a human is ignored.
Agent Status (Office Agent)
- Shown when editing an Office Agent. Click Pause agent to stop it, or Resume agent to start it again.
- While paused, the agent doesn’t answer incoming calls and places no calls to leads, including retries and Call with Voice Agent calls. Blocked attempts are recorded.
- Pausing cancels calls that were already scheduled, such as off-hours lead calls and retries. Resuming doesn’t bring them back.
- The Agents page shows each Office Agent as Active or Paused.
Saving and drafts
- Save changes checks the settings first. If something is missing or too long, a message says what, and the editor opens the section with the problem. After a successful save, the editor closes.
- Integrations, Pause agent / Resume agent, and knowledge base files apply right away, without Save changes.
- Unsaved work is kept as a draft. A new agent you haven’t saved shows on the Agents page as DRAFT; a saved agent with unsaved edits shows Unsaved changes. Cancel on a saved agent discards its unsaved edits.
Cloning and deleting
- Clone - on the Agents page, open the agent’s menu and click Clone to start a new agent from a copy of its settings. Nothing is created until you click Save changes. The copy keeps the original’s knowledge base choice while it stays in the same business. It also starts with the original’s phone number: pick another one in General before you save, so the two agents don’t share a number.
- Delete - open the agent’s menu and click Delete. The agent stops handling calls. If an Office Agent is connected to sources, those connections are disconnected and disabled. Deleting the agent doesn’t remove its phone number.
Placeholders
[[agent_name]],[[company_name]]- in Conversation examples and the Voicemail Message.{{lead_name}},{{user_number}}- in the Voicemail Message.{{day}},{{time}},{{address}},{{service}},{{phone}}- in the Appointment Summary.
Agent type at a glance
| Setting | Office Agent | Call Campaign Agent |
|---|---|---|
| Connected Sources | Yes | - |
| Inbound and Outbound Example Calls | Yes | - |
| Example of a Good Conversation | - | Yes |
| Service Identification | Yes | - |
| Closing Sentences / Promotion / Aggressive Sale | - | Yes |
| Agent Status (Pause agent) | Yes | - |
| Main Goal | - | Set per campaign |
Deep dives
Voice Selection
American voices, previews, and how to pick.
Scheduling Integrations
Job Scheduler, Google Calendar, Outlook, Cal.com, LeadConnector, Housecall Pro, ServiceTitan, FieldPulse, Quickbase, Workiz.
Voice Agent Integrations
Connect messengers and CRMs to the agent's calls.
Call Transfer
Cold vs warm transfer, private handoff instructions, transfer criteria.
Knowledge Base
What the agent knows when it answers.
Questions? Email support@nzleads.com.