Calendar setup
Calendars define when your business can accept appointments. A Calendar can be used by your team when scheduling manually and by the text or voice AI when Job Scheduler is selected as the scheduling service.
Calendars are configured inside the unified Jobs workspace; there is no separate Calendars page in the app.
Getting here
In NZ Leads, open CRM → Jobs.
- To create one, click New calendar.
- To edit one, open the Calendar selector and click the edit icon beside its name.
Click Save calendar or Cancel to return to Jobs.
What a Calendar controls
Each Calendar belongs to one business and stores:
- A name and display color.
- A Schedule type: Strict weekly hours or AI instructions.
- The timezone used to calculate availability and booking times.
- On a Strict weekly hours Calendar: weekly working hours, Job types with their durations, and the Travel between jobs rule.
- On an AI instructions Calendar: the Scheduling instructions the AI follows.
- The customer information the AI must collect before it can book.
Create separate Calendars when teams, services, or locations have different working hours or job lengths.
Schedule type
You choose the Schedule type when you create a Calendar. It can’t be changed after the Calendar is saved.
- Strict weekly hours - NZ Leads offers only times inside your Weekly hours, using the duration of the matching job type and your Travel between jobs setting.
- AI instructions - there are no weekly hours. The AI reads your Scheduling instructions to decide when it may offer appointments. The Calendar tracks booked times and blocks overlaps.
Creating a Calendar
Click New calendar, then complete the sections. Which sections appear depends on the Schedule type.
Basic information
- Business - required; determines where the Calendar and its Jobs belong.
- Name - required; use a recognizable name such as Estimates or Standard service hours.
- Schedule type - Strict weekly hours or AI instructions (see above).
- Timezone - required. Weekly hours and the times offered to customers are calculated in this timezone. A Calendar created from Jobs starts on America/Los_Angeles, so change it if your business is in another timezone. One created with Set up calendar in a source’s or agent’s scheduling settings starts on that source’s or agent’s timezone.
- Calendar color - pick one of the colors or Custom; it identifies the Calendar’s Jobs in the combined view.
Job types (Strict weekly hours)
Job types let different kinds of work take different amounts of time. Click Add job type and fill in:
- Job type - the name, for example Estimate or Installation. Names must be unique.
- Description for AI matching - what this job type covers. The AI uses each description to choose the right appointment length.
- Duration (minutes) - from 5 to 1440 minutes. A new job type starts at 60 minutes.
The Default row is always present. It is used for any request that doesn’t match one of your job types, and its Duration (minutes) starts at 90 on a new Calendar. The Default duration is also the slot length when you schedule a Job yourself on the Jobs page.
Travel between jobs (Strict weekly hours)
Choose how much time to keep free around booked Jobs:
- Leave a fixed number of minutes between jobs - keeps Minutes to leave between jobs free before and after each booked Job on the same day. A new Calendar starts with this option at 120 minutes; you can set 5 to 1440.
- Estimate drive time automatically - in text conversations, the assistant estimates driving time between job addresses when checking available times, rounded up to the next 10 minutes. This option makes Address required in Information to collect. Jobs without a service address get no travel gap. Voice-agent calls and Jobs you schedule yourself on the Jobs page get no drive estimate, so they leave no travel time on such a Calendar.
A Calendar saved before this setting existed has neither option selected and leaves no travel gap until you choose one.
AI scheduling instructions (AI instructions)
Under Scheduling instructions, describe when the AI may offer appointments, for example your working hours, appointment or arrival-window length, how much notice you need, and any limit on jobs per day. Up to 10,000 characters. Write travel or service-area rules here too, since an AI instructions Calendar has no Travel between jobs setting.
Every source and voice agent that uses the Calendar follows these same instructions. The AI scheduling instructions box in a source’s or agent’s Job Scheduler settings edits this same text (Saved on the AI calendar in Jobs.), so a change there applies everywhere the Calendar is used.
Availability (Strict weekly hours)
Under Weekly hours, enable the days you accept appointments and add one or more time ranges to each day. For example, set 8:00 AM–12:00 PM and 1:00 PM–5:00 PM to leave a lunch break.
A new Calendar starts on Monday to Friday, 8:00 AM–4:00 PM, with the weekend closed. Adjust it to your real hours before pointing a source or agent at it.
A Strict weekly hours Calendar has no notice setting: any future time inside the weekly hours can be booked, including later the same day. To require notice, use an AI instructions Calendar and state it in Scheduling instructions.
Information to collect
This section controls what the AI asks for before booking.
- Name is always collected and cannot be turned off.
- On a new Calendar, Phone and Address are required and Email is not collected.
- At least one of Phone or Email must be required.
- Address can’t be turned off while Estimate drive time automatically is selected.
- Click Add custom field for information such as service type, gate code, or property size. Each custom field needs a unique Field name and a Description. A new custom field starts as Required; uncheck it to make it Not collected.
Unchecked fields are not requested as part of the booking.
How available times are calculated
On a Strict weekly hours Calendar, NZ Leads combines:
- The Calendar’s timezone.
- Its weekly working hours.
- The duration of the matching job type (or the Default duration).
- Its Travel between jobs setting.
- Scheduled, in-progress, and on-hold Jobs already using the Calendar.
Times start when each weekly hours range opens and follow one after another by the job’s duration. For example, a 90-minute job on 8:00 AM–4:00 PM hours is offered at 8:00, 9:30, 11:00, 12:30, and 2:00. A time is offered only if the whole job fits before the range ends. After a booked Job, the next time starts when that Job ends plus the travel time. Past times are never offered.
One Calendar holds one Job at a time: there is no capacity setting, so a time already taken by a Scheduled, In progress, or On hold Job can’t be booked again. NZ Leads checks availability again when saving, which prevents two people from reserving the same time.
Using a Calendar with Job Scheduler
After creating the Calendar, select it in the scheduling settings that should use it.
Text AI Assistant
Go to Sources → the source’s Messaging Settings → Conversation Setup. Appointment Scheduling shows below How replies work once a channel is set to AI Assistant. Switch it on, choose Job Scheduler under Scheduling Service, pick the Scheduling mode, and select the Calendar. See Appointment Scheduling.
Voice Agent
Open the agent → Appointments → check Appointment Scheduling → under Scheduling Service choose Job Scheduler → pick the Scheduling mode → select the Calendar. See Scheduling Integrations.
The Calendar list shows only Calendars that match the Scheduling mode: Strict lists Strict weekly hours Calendars and AI lists AI instructions Calendars. Switch the mode, or click Set up calendar to create one of the right type. In AI mode the list also offers Create new one, which creates an AI instructions Calendar named after the source or agent when you save.
The AI checks the Calendar’s open times, collects its required information, and creates a scheduled Job after the customer agrees to a time.
A built-in Calendar lives inside NZ Leads. It is different from choosing a connected third-party calendar as the scheduling service.
Editing or deleting a Calendar
In the Jobs workspace, open the Calendar selector and click the edit icon beside a Calendar. Saving changes updates future availability calculations. The Schedule type can’t be changed.
To delete a Calendar, click Delete calendar and confirm. A Calendar that still has upcoming Jobs (Scheduled, In progress, or On hold, ending in the future) can’t be deleted: you’ll see “This calendar has upcoming Jobs. Move or cancel them before deleting it.” Past Jobs are kept. Any Source or Voice Agent that used the Calendar is disconnected from it: appointment scheduling is turned off and its scheduling setup is cleared, so turn Appointment Scheduling back on and choose the service and Calendar again.
Before deleting a Calendar, update every Source and Voice Agent that should keep booking appointments.
Related topics
Built-in CRM
See how Calendars connect Leads, Contacts, and Jobs.
Jobs
Use the shared Calendar and List workspace to manage scheduled work.
Text appointment scheduling
Configure Job Scheduler for lead conversations.
Voice Agent scheduling
Configure Job Scheduler for phone calls.
Questions? Email support@nzleads.com.