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.

Click Save calendar or Cancel to return to Jobs.

What a Calendar controls

Each Calendar belongs to one business and stores:

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.

Creating a Calendar

Click New calendar, then complete the sections. Which sections appear depends on the Schedule type.

Basic information

Job types (Strict weekly hours)

Job types let different kinds of work take different amounts of time. Click Add job type and fill in:

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:

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.

Unchecked fields are not requested as part of the booking.

How available times are calculated

On a Strict weekly hours Calendar, NZ Leads combines:

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.


Questions? Email support@nzleads.com.

Get Started