Appointment Scheduling
With Appointment Scheduling on, the AI Assistant can check availability and book appointments during the conversation.
Getting here
In NZ Leads, go to Sources → select a source → Messaging Settings → Conversation Setup tab. For a whole business, open the sidebar’s Business switcher and click Messaging Settings next to the business.
The Appointment Scheduling panel (“Let the AI offer and book available appointment times.”) shows once the primary channel or SMS uses AI Assistant. Switch on the toggle in the panel header: the panel opens with its fields. Choose a Scheduling Service, fill in its fields, and click Save Settings.
If the tab shows Business Settings Active, turn on Customize for Location first to change scheduling for this source only.
Scheduling works for the AI on the primary channel and on SMS. The AI can finish a booking only when that channel’s AI Conversation Mode is Short conversation or Long conversation. With Only welcome message, the AI sends one message and stops.
Options
Appointment Scheduling switch
- Label: “Appointment Scheduling” (switch in the panel header)
- Default: off
- When on: the Scheduling Service dropdown and its fields appear, and the AI can offer and book available appointment times.
- When off: the AI will not bring up scheduling or attempt to book.
- Use this when: you want the AI to carry the conversation through to an actual booking, rather than handing off once the lead is qualified.
Scheduling Service
- Label: “Scheduling Service” (dropdown)
- Default: Job Scheduler - NZ Leads’s own Jobs calendars. Choose an AI or strict calendar.
- Options:
- Job Scheduler
- Google Calendar
- Microsoft Outlook
- Cal.com
- LeadConnector (GoHighLevel)
- Housecall Pro
- ServiceTitan
- FieldPulse
- Quickbase
Each option and its fields are detailed below. Workiz is offered only to voice agents, so text conversations can’t book into Workiz. See Scheduling Integrations.
Job Scheduler
Choose a Scheduling mode: AI or Strict. The Calendar list shows the business’s calendars of that mode, with their mode and timezone. Click Set up calendar to create a calendar without leaving the panel, or go to CRM → Jobs → New calendar. See Calendar setup.
Sources set up earlier with Open Schedule show it as Job Scheduler in AI mode.
Strict
- Required field: Calendar - a calendar whose available hours and booking rules are set in the calendar.
- What happens: the AI offers open slots from the calendar and creates a scheduled Job after the customer confirms.
- Use this when: you want booking and Job tracking to stay inside NZ Leads.
AI
- Calendar: choose an existing AI calendar, including one shared with a voice agent, or Create new one.
- AI scheduling instructions: plain-language rules for which times may be offered, up to 10,000 characters. They are saved on the AI calendar in Jobs, so a change here also applies to every source and voice agent that uses that calendar.
- Notify me when an appointment is scheduled: off by default. Sends booking details to your enabled messenger integrations. The appointment is always saved in Jobs.
- Use this when: you want custom written scheduling rules and a record of confirmed appointments in Jobs.
Example instructions:
We're open Mon–Fri 8–5. Offer 2-hour arrival windows starting at 8, 10,
1 and 3. No bookings on public holidays.
Google Calendar and Microsoft Outlook
- Account: click Connect Google Account (bookings go to the account’s primary calendar) or Connect Microsoft Account, and sign in. The account is connected per business, so every source of the business that picks this option books into the same account. Signing in turns scheduling on with this calendar and saves it. Connected account shows the email; Disconnect removes the account.
- Appointment Duration (minutes): required, at least 5. The length of each bookable slot.
- Event Title: optional. Use
{name}for the customer’s name and{service}for the service, for exampleEstimate: {name} - {service}. Left empty, events are titledAppointment: {name}. - Working Hours: appointments are offered only inside these hours, in the business timezone: Any time (no limit), Any day (the same hours every day), or Specific days and times.
- Buffer Between Appointments (minutes): free time kept before and after every busy event in the calendar.
- Scheduling Instructions: required, up to 2,000 characters. When bookings are allowed, including day-specific exceptions or preferred times. The field starts with sample rules: replace them with yours.
- Notify me when an appointment is scheduled: on by default. Sends booking details to your enabled messenger integrations. The appointment is always added to the calendar.
- What happens: the AI offers only times inside your working hours that are free in the calendar, and follows your instructions. Before it books, it needs the customer’s name and a phone number or email.
Cal.com
- Required fields:
- Cal.com API Key
- Event Type ID
- What happens: the AI checks availability for the event type you connect, proposes open slots to the lead, and creates the booking on your Cal.com calendar once the lead confirms. It fills the event’s booking questions with the customer’s details; set them in Cal.com under Event Types → your event → Advanced → Booking Questions.
- Use this when: you already use Cal.com and want the AI to book a specific event type (consultation, site visit, etc.).
LeadConnector
- Required fields:
- GoHighLevel API Key
- Calendar ID
- Location ID (Sub-Account ID)
- Requires the GHL Unlimited package.
- What happens: the AI checks availability on the specified calendar under the specified location, creates or finds the customer as a contact, and creates the appointment there. It needs the customer’s name and a phone number or email.
- Use this when: GoHighLevel is your CRM and you want new bookings on an existing calendar.
Housecall Pro
- Required field: Housecall Pro API Key (in Housecall Pro under Settings → Integrations → API key).
- Default assignee: click Load employees, then choose an employee. Availability is checked for that employee and new jobs are assigned to them. Housecall Pro default (no explicit assignee) leaves the choice to Housecall Pro.
- What happens: the AI checks Housecall Pro availability and creates a customer and a job in Housecall Pro.
- Use this when: you dispatch jobs through Housecall Pro and want new appointments on the same schedule.
ServiceTitan
- Required fields: Client ID, Client Secret, App Key, Tenant ID, Booking Provider ID, Business Unit ID, Job Type ID. Campaign ID is optional.
- What happens: the AI checks ServiceTitan Dispatch Capacity for open times and creates a booking request in ServiceTitan.
- Use this when: you run your jobs in ServiceTitan. Ask your ServiceTitan admin for the IDs.
FieldPulse
- Required fields:
- FieldPulse API Key
- Company ID
- What happens: the AI checks availability in FieldPulse and creates the appointment there. It needs the customer’s name, phone number and service address.
- Use this when: you run your jobs out of FieldPulse.
Quickbase
- Required fields:
- Appointments table link - open your appointments table in Quickbase and copy the browser URL.
- User token - assigned to the Quickbase app that holds the table.
- Setup: click Connect. NZ Leads picks the start, end or length, status, and customer detail fields automatically; click Edit to change them. Then set the Appointment length (minutes) and Working Hours.
- What happens: the AI offers only times inside your working hours that don’t overlap appointments already in the table, checks the time again right before booking, and writes the appointment with the customer’s details to your table. It can also cancel the appointment.
- Use this when: your appointments already live in a Quickbase table.
See Book appointments in Quickbase for the full setup and advanced options.
There is no timezone field for any scheduling service. Connected services, Google Calendar and Outlook working hours included, use the Timezone on the Timing tab. Job Scheduler uses the timezone of its calendar.
Validate Connection
- Label: “Validate Connection” button below the fields, for every service except Job Scheduler.
- What it does: tests your credentials against the selected service. On success you see Validation successful. On failure you see Validation failed with the reason, and the scheduling toggle switches off: fix the fields, switch the toggle back on, and validate again.
- On save: if you changed a connected service and didn’t validate it, Save Settings runs the check first. If the check fails, nothing is saved.
- LeadConnector: the check books a test appointment in a free slot and cancels it right away, to make sure the key can book. If the calendar has no free slot, it connects but warns that booking permissions couldn’t be checked.
- Use this when: always run it once after entering or changing credentials. Keys expire and IDs get deleted.
Job Scheduler doesn’t use external credentials, so there is nothing to validate for it.
Scheduling errors
When scheduling fails during a conversation, a warning icon appears next to Appointment Scheduling in the panel header. Click it to see the errors from the last 7 days and when each happened; Clear Errors removes them. It is the fastest way to spot an expired key, a deleted calendar, or a revoked API token.
Test AI Assistant uses these scheduling settings, even unsaved ones. A booking made in a test conversation is real: it goes into your calendar or system. If booking details go to your integrations, they’re headed “Test booking from the AI test chat”. Cancel the test booking when you’re done.
Which option should I pick?
- Keep appointments and Jobs inside NZ Leads: Job Scheduler.
- Your schedule lives in Google Calendar or Outlook: Google Calendar or Microsoft Outlook.
- Already using Cal.com for bookings: Cal.com.
- Field-service business on Housecall Pro, ServiceTitan, or FieldPulse: match your existing dispatch tool.
- GoHighLevel is your CRM: LeadConnector.
- Appointments live in a Quickbase table: Quickbase.
How it behaves
- Settings are per source. Different sources can use different calendars if needed.
- Job Scheduler creates a Job linked to the original lead and places it on the selected calendar.
- Confirmation to the lead: the AI reads back the chosen time once booked, so the lead knows the appointment is locked in.
- Jobs for connected services: when a connected service books for a lead, NZ Leads also adds the booking as a Job in CRM → Jobs, linked to the lead.
- Cancellations and changes: if the customer asks, the AI can cancel a booking made for this lead. To move it, the AI cancels the old booking and books the new time.
Troubleshooting
- No calendar is available in Job Scheduler: click Set up calendar, or open CRM → Jobs → New calendar and create one for the same business as the source. The Calendar list shows only calendars of the selected mode (AI or Strict). In AI mode you can also leave Create new one.
- A Job Scheduler slot disappeared: another active Job may have reserved it, or the time may now be in the past. Choose another open slot.
- Saving says “This calendar has upcoming Jobs”: you’re switching away from an AI calendar that still has upcoming Jobs. Move or cancel them in CRM → Jobs, then save again.
- “Validate Connection” fails: common causes are a wrong API key (typo, expired, or from the wrong account) or a wrong Event Type, Calendar, Location, Company, Business Unit, or Job Type ID. For Google Calendar or Microsoft Outlook, click Disconnect and connect the account again.
- AI books into the wrong calendar: confirm the IDs (Event Type ID, Calendar ID, Location ID) match the target calendar.
- Bookings come out at the wrong time: connected services use the Timezone on the Timing tab, and Job Scheduler uses its calendar’s timezone. Set them to your business’s timezone.
- AI never offers to book: confirm Appointment Scheduling is switched on and saved, the channel uses AI Assistant, and its AI Conversation Mode is Short or Long (the AI needs more than one message to collect scheduling info).
Questions? Email support@nzleads.com.