Key concepts
These are the terms used throughout NZ Leads and this documentation. Skim this page once and the rest of the product will feel familiar.
Source
A source is one connected account or profile on an external platform that sends you customer inquiries. Examples:
- One Yelp location = one source.
- One Thumbtack Pro account = one source.
- One Facebook Page (Messenger) = one source.
- One Facebook Page’s Lead Ads = one source, named after the Page with “(Lead Ads)” added.
- One Instagram Business account = one source.
- One Google Local Services account = one source.
Every source has its own Messaging Settings, its own row in Analytics, and its own price on your monthly bill. It uses a knowledge base and integrations - its business’s, unless you pick others for it. See Lead Sources for the full list of supported platforms.
Business
A business is a group that owns one or more sources. For a single-location company this is just “your business”. For a multi-location or multi-brand organization, each business can hold its own set of sources so messaging, branding, and reporting stay separate.
Switching between businesses
The sidebar has a Business switcher under the logo. It shows the current business’s name, or All Businesses.
- Click it to open the Businesses dialog listing every business you can access.
- Pick a business to switch to it - the sidebar, sources, leads, and analytics all update to that business’s data.
- If payment is an issue on the current business, the button shows a Payment Issue tooltip as a reminder.
Some actions need one business picked, for example adding an integration on the Integrations page.
Managing businesses
In the Businesses dialog, each business has a menu. Admins of a business can:
- Add - create a new business under it. Use Add on All Businesses to create a new top-level business.
- Edit - change the Business name and see the Billing owner. The Parent business is shown but can’t be changed; contact support to move a business under another one.
- Delete - shown only when the business has no sources and you have more than one business. Deleting can’t be undone.
Next to each business you can also open Permissions (who has access, see Team Management) and Messaging Settings. The billing owner also sees a billing icon that opens the billing portal.
Lead
A lead is a single customer inquiry, bound to exactly one source. Each lead has:
- A conversation thread - every message between your business and the customer.
- A status - see below.
- Memos - private notes your team can add (the customer never sees them).
- Customer info - name, phone, email, address, and any structured details the source extracted from the inquiry.
All leads across all sources live together in the Leads inbox.
Status
A status is a label on a lead that tells you where it is in your pipeline. The seven statuses are:
- Auto Follow-up (yellow) - where a new message lead starts while NZ Leads sends the welcome message and automatic follow-ups. You can’t pick this status yourself. (Facebook Lead Ads leads and Google Local Services call or booking leads start in Follow-up.)
- Answered (green) - the customer replied.
- No Answer (red) - the last automatic follow-up went out without a reply.
- Follow-up (orange) - the lead needs a person: someone on your team replied by hand, the AI handed the lead to you, or you set it yourself.
- Scheduled Messages (purple) - messages you scheduled on this lead are waiting to send.
- Meeting (blue) - an appointment is booked. The AI sets it when it books one.
- Done (gray) - the lead is closed (won, lost, or not a fit).
Automatic follow-ups and scheduled messages only go out while a lead is in Auto Follow-up or Scheduled Messages. Each source can also have its own custom statuses.
Full details: Lead Statuses.
Contact
A Contact is a reusable customer profile in the built-in CRM. It can hold multiple phone numbers and email addresses, plus linked Leads, sources, notes, tags, and addresses. When a Lead shares a real phone number or email address, NZ Leads creates a Contact or links the Lead to a matching Contact in the same business.
See Contacts.
Job
A Job is a record of work or an appointment for a customer. It has a status, priority, optional schedule and Calendar, service address, tags, notes, and links to related Contacts or Leads when available. Jobs can be created manually or by a supported AI scheduling flow. The Jobs workspace provides shared Calendar and List views.
See Jobs.
Calendar
A Calendar defines when appointments can be booked: either Strict weekly hours with job types and their durations, or AI instructions the AI follows. It also has a timezone, color, and the customer information an AI must collect before booking. When Job Scheduler is selected as the scheduling service, the text or voice AI books on the selected Calendar.
See Calendar setup.
Voice Agent
A Voice Agent is an AI phone agent that:
- Answers inbound calls to a phone number you assign it.
- Calls new leads outbound when a qualifying lead arrives.
- Runs batch call campaigns on a list of contacts.
The agent uses a knowledge base to answer questions, qualify callers, and book appointments. See Voice Agent.
Knowledge base
A knowledge base is what the AI knows about your business: About the business, Prices, Services you don’t provide, FAQ and files such as long price lists. Chats and voice agents read the same knowledge base. A business usually has one, and its sources and voice agents use it unless you pick another one for them. See Knowledge Bases.
Integration
An integration sends your leads (and voice agents’ call reports) to an external tool. Each one is set up once - one Slack channel, one email address, one HubSpot account - and then turned on where it’s used: a business, a source type, single sources, or voice agents. A place uses one integration of each kind.
- Team notifications - Email, SMS, Slack and Telegram.
- CRM and field service - HubSpot, Pipedrive, Salesforce, LeadConnector (GoHighLevel), Workiz, Housecall Pro, ServiceTitan, AccuLynx, Quickbase, SmartMoving, Monday.com.
- Webhooks and automation - Zapier, REST webhook, Lead Reply API.
Manage them on Settings → Integrations, or on the Integrations tab of a source’s Messaging Settings. See Integrations.
Override and inherit
In Messaging Settings, a source that belongs to a multi-location business can either inherit a setting from its parent business or override it with its own value.
- Inherit means the source uses the same value as the business. Change the business and the source picks up the change automatically.
- Override means the source has its own value that does not change when the business changes.
This lets you set a default at the business level and override only the sources that need to be different. Knowledge bases and integrations follow the same rule: a source uses its business’s unless you pick others for it.
Most small single-location accounts will never touch override/inherit - the default is to use business-level settings and every source inherits.
Putting it together
A typical account looks like this:
- One business (your company).
- Several sources under it - one per Yelp location, one per Thumbtack Pro account, one per Facebook Page, and so on.
- Each source has its own Messaging Settings and billing line, and uses its business’s knowledge base and integrations unless you pick others for it.
- Every inquiry on any source becomes a lead in the shared Leads inbox.
- Leads that share real contact information are organized into Contacts in the built-in CRM.
- Booked or manually entered work becomes a Job, which can reserve a slot on a Calendar.
- Your team triages leads by status and lets automation handle follow-ups until a customer replies.
Questions? Email support@nzleads.com.