Getting started

Set up booking: every option in the wizard, a video course for administrators

A 13-minute video course with a reference table: every question in the Services and treatments template, from the department to the install.

By The Kav team Published 27 min read

This is course 2A of the Kav Studio Academy for tenant administrators. It sets up booking with the Services and treatments template, and walks through every option in its wizard, from the department to the install. It takes about 13 minutes, and the reference table below lists every question with its limits and defaults.

All businesses, services and people in this course are fictional examples. They are not Kav's own offering: the massage, physiotherapy and stretching class services belong to an imaginary studio, and you should use your own.

Every screen is the Studio of Kav's own organization on a test copy, with example people and addresses only. The booking in chapter 1 is a real one made through the real widget.

Use the chapter menu beside the video (below it on a phone) to jump to a topic, or the Transcript tab to read along. Course 2B, a separate video, covers what customers experience afterwards: the emails, the calendar entry and managing bookings.

What you will learn

Each item starts the video at that chapter.

  1. What your customers will get (0:00): See the booking journey your customers get, from the first question to the confirmation.
  2. Before you start (1:12): Know what to prepare, and where the wizard lives in the Studio.
  3. Part 1: Where bookings go (2:18): Choose the department, and decide whether to link a Google calendar.
  4. Part 2: Your services (4:16): Fill in every field of a service card, and manage several services.
  5. Hours per service (6:13): Give a service its own days and hours, and understand how they combine with the department's.
  6. Part 3: How bookings look (7:47): Set the business name and address, choose what stays private, and read the live preview.
  7. Part 4: What the assistant says (9:19): Add your own booking wordings, block the wrong ones, and write a scoping note.
  8. Review: what will change (10:29): Read the server's plan, fix a warning and a blocked item, and know what each action means.
  9. Install and the result (12:17): Install, read the result table, and know the next steps.

Before you start

  • Who this is for. Administrators who set up the assistant for an organization in the Studio. You need a staff account that can see the Solutions gallery and install (the first course in the series, What are solution templates?, explains the roles).
  • Have ready. A department with opening hours in the Agent Desk, and your list of services with a length in minutes each. A Google account is optional.
  • Nothing is written until Install. Questions and Review only prepare and show the plan. Rows you edit by hand later are left alone, and uninstalling switches rows off instead of deleting them.
  • About the demo. The wizard was recorded on a test copy of the Studio, with the template at version 0.1.1. The booking form in chapter 1 was recorded with the same template. Newer versions of the template can add options, so read the version number on the wizard page. The Google part is the real consent round trip, with the account's details blurred.
  • Not covered here. Customer emails, the calendar entry and managing bookings after the install are the subject of course 2B.

Every option in the wizard

The wizard has four parts, then Review and Install. This table lists each question as it appears on screen, with what it does, its limits and its default.

Part 1: Where bookings go

Question What it does Limits Default
Which department takes the appointments? Required. Its opening hours decide when appointments can be booked, its time zone comes with it, and special days and holidays come from the desk. A service with no hours of its own follows the department. If the department is open around the clock, every service needs its own hours. One of your desk departments None
Connected calendar account (optional) Confirmed appointments are copied to the account's calendar. Choose a connected Google account, Do not link an account, or Connect another Google account, which leaves the Studio for Google's consent screen and returns to the Connected accounts page. Google accounts you have connected Do not link an account
Calendar that confirmed appointments are copied to Appears once an account is chosen. Lists only calendars that events can be added to, and says how many are hidden because the account can only read them. Required once an account is linked None

Part 2: Your services (one card per service)

Question What it does Limits Default
Add, Duplicate, Remove row Add opens a card, Duplicate copies one and adds (copy) to the name, Remove row deletes it. A collapsed card shows name, minutes and hours; a counter says how many things still need fixing. 1 to 20 services One empty card to start
Name of the service as customers see it Shown on the booking form and spoken by the assistant. Renaming a service creates a new one and switches the old one off. Required, 2 to 100 characters; names must be different None
Length of the service in minutes How long one booking blocks the calendar. Used to find free times. The assistant never states a length of its own. Required, 5 to 480 minutes None
How many customers at the same time? How many customers can book the same time: 1 for one-to-one services, more for a class. 1 to 100 1
Break after each booking in minutes Turnaround time kept free after a booking. Slot starts step by the length plus the break. 0 to 240 minutes 0
Minimum notice in minutes Times that are too close are not offered. 0 to 43,200 minutes 240 (four hours)
How many days ahead can be booked? How far into the future customers can book this service. 1 to 45 days 30
Treat this service as health information The strictest data class. The calendar entry and the email subject say only Appointment. Interacts with the Part 3 switch Show the service name on the business calendar. Switch Off
Short description (optional) Shown after the name on the booking form. Keep prices out of it. Up to 80 characters Empty
Days and hours when this service can be booked (optional) Weekly days and hours for this service. Empty means it follows the department. Always combined with the department's hours, never beyond them. A lunch break is two rows for the same day. Up to 21 rows Empty
Day, From (HH:MM), Until (HH:MM, up to 24:00) One range per row, in 24-hour format. The wizard does not check that Until is later than From or that rows do not overlap: the server does, at Review. Until up to 24:00 Empty
Quick hours, Copy hours from, Add a day, Remove row Quick hours: Sun to Thu 09:00 to 17:00, or Every day 09:00 to 17:00. Copy hours from copies another service's hours onto a card that has none. Add a day adds a row; Remove row drops one. Up to 21 rows None

Part 3: How bookings look

Question What it does Limits Default
Business name for the emails (optional) Shown in the header of the booking emails and in the calendar entry. Up to 120 characters Empty
Address shown on the invitation and the calendar entry (optional) Written as the location of the customer's invitation and of your calendar entry. Plain text. Up to 200 characters Empty
Show the service name on the business calendar Only affects services marked as health information, which otherwise appear as Appointment. Switch, applies to every service Off
Keep the customer's name off the calendar entry By default the entry reads Service, a dash, and the customer's name. Switch, applies to every service Off
Keep the customer's email and phone off the calendar entry By default the entry's description lists the email and phone the customer gave. Switch, applies to every service Off
Leave the Studio link out of the calendar entry By default the entry carries a link to the booking in the Studio (staff sign-in required). The preview does not show this switch. Switch, applies to every service Off

Part 4: What the assistant says

Question What it does Limits Default
Extra wordings that mean "book" (optional) One wording per line. Built-in wordings already exist in Hebrew, Arabic, Russian and English. Up to 600 characters Empty
Wordings that must NOT start a booking (optional) One wording per line. Cancelling and rescheduling are already excluded. Up to 600 characters Empty
Scoping note One short sentence about what the tool is for and what it is not. It can only narrow, never widen. Refused: angle brackets, a line starting with a reserved platform heading such as USE WHEN, and tool names (checked on the server). Required, up to 300 characters, live counter None

Review and Install

Question What it does Limits Default
What will change (Review) The server's plan, grouped as Assistant, routing and forms; Appointments; Connections. Actions: Create, Update, Already present, Edited by hand (never overwritten), Switch off, Blocked, Not planned. Warnings and routing checks (Passed, Failed, Not run) follow. Read only Nothing is written
The plan is incomplete (Review) When a check could not be made, the page says so, and installing needs the tick I understand the plan is incomplete and want to install anyway. Not shown in this recording. Tick Not ticked
Install this solution, Apply again with these answers Install runs in the background. Results: Waiting, Applied, Already present, Needs your attention, Failed. Applying again is safe to repeat. Button None

Chapter by chapter

1. What your customers will get

Play this chapter (0:00, 1:12 long)

Goal: See the booking journey your customers get, from the first question to the confirmation.

  • A customer opens the assistant on a business website and asks to book a massage. The assistant opens a booking form.
  • The form asks for a service, then a day on a calendar where days with no free time are struck out, then a time, a name, an email, an optional phone number and a reminder choice.
  • A review lists every answer. After the customer sends it, a six digit code arrives by email, and nothing is booked until it is entered.
  • Times step by the length of the service plus its break, and are shown in the business's own time zone.

2. Before you start

Play this chapter (1:12, 1:06 long)

Goal: Know what to prepare, and where the wizard lives in the Studio.

  • Prepare three things: a department with opening hours, optionally a Google account, and your list of services (a name and minutes for each).
  • The Solutions card lists what you need first: Department (Ready) and Calendar account (Needs setup, optional).
  • A department's opening hours frame every booking. If the department is open around the clock, every service needs hours of its own.
  • The wizard has three steps, Questions, Review and Install, and nothing is written until Install. A collapsed block, What this solution sets up, lists the pieces the template creates.

3. Part 1: Where bookings go

Play this chapter (2:18, 1:57 long)

Goal: Choose the department, and decide whether to link a Google calendar.

  • Part 1 has three questions: the department (required), the optional calendar account, and, once an account is chosen, the calendar that appointments are copied to.
  • The default account choice is Do not link an account: customers then get an emailed invite only. You can connect an account later and apply the solution again.
  • Connect another Google account leaves the Studio for Google's own consent screen, which asks for three permissions: to see your calendars, to see when you are free or busy, and to create, change and delete events on calendars you own. Kav never sees your password.
  • The calendar picker lists only calendars that events can be added to, and says how many are hidden because the account can only read them.

4. Part 2: Your services

Play this chapter (4:16, 1:56 long)

Goal: Fill in every field of a service card, and manage several services.

  • Part 2 holds one card per service, from one to twenty. Each card has a name (2 to 100 characters), a length (5 to 480 minutes), how many customers at the same time (default 1), a break after each booking (default 0), minimum notice (default 240 minutes) and how many days ahead (default 30).
  • A switch marks the service as health information: the strictest data class, and the calendar entry and email subject say only Appointment.
  • A short description (up to 80 characters) appears after the name on the booking form.
  • Duplicate copies a card and adds (copy) to its name, Remove deletes a row, and a collapsed card shows a summary of name, minutes and hours. A counter says how many things still need fixing.

5. Hours per service

Play this chapter (6:13, 1:34 long)

Goal: Give a service its own days and hours, and understand how they combine with the department's.

  • Each card has optional days and hours. Left empty, the service follows the department's opening hours; a service can be booked only when its own hours and the department's are both open.
  • Quick hours set Sunday to Thursday or every day, 09:00 to 17:00. Each row is a day, a From time and an Until time (up to 24:00); a lunch break is two rows for the same day. Up to 21 rows per service.
  • A card with no hours offers Copy hours from, to copy another service's hours.
  • The wizard accepts an Until time earlier than the From time. The server checks it when you reach Review.

6. Part 3: How bookings look

Play this chapter (7:47, 1:31 long)

Goal: Set the business name and address, choose what stays private, and read the live preview.

  • Part 3 is optional. Business name for the emails (up to 120 characters) and address (up to 200 characters, plain text) appear on emails, the invitation and the calendar entry.
  • Four switches, all off by default and applied to every service: show the service name on the business calendar (only matters for health-information services), keep the customer's name off the calendar entry, keep the customer's email and phone off it, and leave the Studio link out of it.
  • The live preview, What your customers will experience, shows the first six service names with their minutes, a confirmation card with an example time, and the calendar entry following your switches. It does not show the Studio link switch or the day picker.

7. Part 4: What the assistant says

Play this chapter (9:19, 1:10 long)

Goal: Add your own booking wordings, block the wrong ones, and write a scoping note.

  • Part 4 has three questions. Extra wordings that mean book and Wordings that must not start a booking take one wording per line, up to 600 characters each. Built-in wordings already exist in Hebrew, Arabic, Russian and English, and cancelling and rescheduling are already excluded.
  • The scoping note is required, up to 300 characters, with a live counter. It can only narrow the tool, never widen it.
  • The wizard lists problems under the field: angle brackets are refused, and so is a line that starts with a reserved platform heading such as USE WHEN. Tool names are checked on the server.

8. Review: what will change

Play this chapter (10:29, 1:47 long)

Goal: Read the server's plan, fix a warning and a blocked item, and know what each action means.

  • Next: review asks the server for the plan the install would run, and writes nothing. Items are grouped as Assistant, routing and forms; Appointments; and Connections.
  • Actions: Create, Update, Already present, Edited by hand (shown as a difference, never overwritten), Switch off, Blocked and Not planned.
  • In this recording the group class has an invalid range, so its appointment type is Blocked, with the reason beside it. Fixing the hours clears it.
  • Routing checks list sample sentences in four languages with a state of Passed, Failed or Not run. All eleven passed here.

9. Install and the result

Play this chapter (12:17, 1:00 long)

Goal: Install, read the result table, and know the next steps.

  • Install this solution sends the install, which runs in the background while a table refreshes every few seconds.
  • In this recording thirteen items reported. The four capability bindings first said Needs your attention, because the connector instance could not be verified yet.
  • Apply again with these answers is safe to repeat. Existing items read Already present, the bindings become Applied and the status reads Installed.
  • What to do next offers Try it in the widget, Connect your calendar and See bookings.

Full transcript

Full transcript of the video

The words of the video, in order. Use the chapter list above to watch a part instead.

Chapter 1. What your customers will get

Goal: See the booking journey your customers get, from the first question to the confirmation.

Welcome to course two A of the Kav Studio Academy. In this course you will set up booking, and meet every option in the wizard. First, see what your customers will get.

Here is an example: a fictional massage and physiotherapy studio, with the Kav assistant on its website. None of it is Kav's own offering.

A customer opens the assistant, and says they would like to book a massage.

The assistant opens a booking form. The customer chooses a service, each with its name and description, and then a day. Days with no free time are struck out.

Next come the times. They step by the length of the service plus its break, and they are in the business's own time zone. The customer adds a name.

Then an email address, an optional phone number, and a reminder choice, which stays at No here.

Before anything is sent, a review lists every answer.

The customer sends it, and a six digit code arrives by email. Nothing is booked until the code is entered.

The code goes in, and the appointment is confirmed. Everything you just saw is what you will build in this course, one wizard question at a time.

Chapter 2. Before you start

Goal: Know what to prepare, and where the wizard lives in the Studio.

Before you open the wizard, prepare three things. Everything else is optional.

First, a department. On the Solutions page, the card for Services and treatments lists What you need first: Department, Ready, and Calendar account, Needs setup. The calendar is optional.

The department matters, because its opening hours frame every booking. This one is Sales, in the New York time zone, open on weekdays from nine to five. If a department is open around the clock, every service will need hours of its own.

Second, if you want bookings copied into your own calendar, a Google account you can sign in to. Without one, customers still get an emailed invite.

Third, your list of services: a name, and a length in minutes, for each.

Choose Set up. The page has three steps: Questions, Review and Install. Nothing is written to your account until the last one.

A collapsed block, What this solution sets up, lists the pieces the template creates, before you answer anything.

Chapter 3. Part 1: Where bookings go

Goal: Choose the department, and decide whether to link a Google calendar.

Part 1 is Where bookings go. The four parts are tabs at the top of the form, and a counter shows how many of the twelve questions are answered.

The first question is required: which department takes the appointments? The list shows your desk's departments. Its opening hours decide when appointments can be booked, and its time zone comes with it.

Questions have an information button, with a fuller explanation. This one says that a service with no hours of its own follows the department's hours.

Next, the optional calendar account. Confirmed appointments are copied to the account's calendar. You can skip this: customers then get an emailed invite only.

The default is Do not link an account. Skipping is fine. You can connect an account later, and apply the solution again.

To link a calendar, choose Connect another Google account. You are taken to Google to approve access.

Google asks which account to use. In this recording it is the organization's own account, so its details are blurred.

Then Google asks for your approval. Kav asks to see your list of calendars, to see when you are free or busy, and to create, change and delete events on calendars you own. Kav never sees your password.

Google sends you back to Kav. In this build you land on the Connected accounts page, where the new account is saved.

Back in the wizard, the account is now an option, with the date it was connected.

Choose it, and a third question appears: the calendar that confirmed appointments are copied to. Only calendars that events can be added to are shown, and the wizard says how many it hides because the account can only read them.

Here a dedicated demo calendar is chosen, so bookings stay apart from everything else.

If you skip the account, nothing is lost. The review will say: no calendar linked, customers get an emailed invite only.

Chapter 4. Part 2: Your services

Goal: Fill in every field of a service card, and manage several services.

Part 2 is the heart of the template: your services. Each service is a card, and you can have from one up to twenty. The three services here are examples for a fictional studio. Use your own.

Choose Add, and a card opens. The first field is the name, as customers see it, from two to a hundred characters. Use your customers' own words. Renaming a service later creates a new one, and switches the old one off.

Next, the length of the service in minutes, from five to four hundred and eighty. The system uses it to find free times, and the assistant never states a length of its own.

How many customers at the same time? The default is one. Raise it for a class, or a shared resource.

Break after each booking, from zero to two hundred and forty minutes. Slot starts step by the length plus the break, so sixty minutes with a ten minute break offers a time every seventy minutes.

Minimum notice defaults to two hundred and forty minutes, which is four hours. And how many days ahead can be booked runs from one to forty-five, with a default of thirty.

Treat this service as health information is a switch. When it is on, the service gets the strictest data class, and the calendar entry and the email subject say only Appointment.

A short description, up to eighty characters, appears after the name on the booking form. Keep prices out of it.

Duplicate copies a card and adds the word copy to its name. Here the copy becomes a physiotherapy session, forty-five minutes, with shorter notice, and the health switch on.

A third card, a group class, with room for eight customers at the same time.

Collapse a card to see its summary: the name, the minutes, and the hours. A counter in the footer tells you how many things still need fixing before you can continue.

Chapter 5. Hours per service

Goal: Give a service its own days and hours, and understand how they combine with the department's.

Every service can have its own days and hours. This section is optional, and it sits at the bottom of each card.

Left empty, the service follows the department's opening hours. But if the department is open around the clock, every service needs hours of its own, or no times will be offered.

When both exist, they combine. A customer can book a service only when its own hours and the department's hours are both open, so a service can never reach beyond the department.

On the physiotherapy card, Quick hours does the typing for you. Sunday to Thursday, nine to five, fills five rows in one click, and says so underneath. The other quick option is every day, nine to five.

Each row has a day, a From time, and an Until time, in twenty-four hour format. Until may be as late as twenty-four hundred, and a range cannot cross midnight.

A lunch break is simply two rows for the same day. Here Sunday now ends at one o'clock, and a new row opens it again from two until five.

Add a day adds a row, up to twenty-one in all. Remove drops one.

A card with no hours of its own also offers Copy hours from, which copies the hours of another service in one step.

Now a mistake, on purpose. On the class, I type an Until time that is earlier than the From time. The wizard accepts it. The server checks that every range closes after it opens, and that ranges do not overlap, when you reach Review.

Chapter 6. Part 3: How bookings look

Goal: Set the business name and address, choose what stays private, and read the live preview.

Part 3 is how bookings look. All six questions are optional.

Business name for the emails, up to a hundred and twenty characters. It appears in the header of the booking emails, and in the calendar entry. Watch the preview: the name appears there too.

The address, up to two hundred characters, plain text. It becomes the location on the customer's invitation, and on your own calendar entry.

Now four switches. All of them are off by default, and each one applies to every service.

Show the service name on the business calendar only matters for services you marked as health information. Those appear as just Appointment, unless you turn this on.

Keep the customer's name off the calendar entry. By default the entry reads the service, a dash, and the customer's name. With this on, the name is left out.

Keep the customer's email and phone off the calendar entry removes the contact lines from the entry's description.

Leave the Studio link out of the calendar entry. By default the entry carries a link to the booking in the Studio, for signed-in staff. Switch this on when people outside your staff can see the calendar.

On the right is the live preview, What your customers will experience. It shows the first six service names with their minutes, a confirmation card where the time is only an example, and your calendar entry, following the switches. It ignores the Studio link switch, and it does not show the day picker.

Chapter 7. Part 4: What the assistant says

Goal: Add your own booking wordings, block the wrong ones, and write a scoping note.

Part 4 is what the assistant says. There are three questions, and only the last one is required.

Extra wordings that mean book: one per line, up to six hundred characters. Wordings such as book an appointment are already built in, in Hebrew, Arabic, Russian and English, so add only your own trade words.

Wordings that must not start a booking, also one per line. Cancelling and rescheduling are already excluded.

The scoping note is required: one short sentence, up to three hundred characters, with a live counter. It says what the tool is for, and what it is not.

It can only narrow the tool, never widen it. Angle brackets are refused, and so is a line that starts with a platform label such as USE WHEN. The wizard lists the problems right under the field.

No code fences, no control or zero-width characters, and no tool names either; tool names are checked on the server. Here is a good note, and the counter shows eighty-seven of three hundred.

When all four parts are complete, the last button changes to Next: review.

Chapter 8. Review: what will change

Goal: Read the server's plan, fix a warning and a blocked item, and know what each action means.

Next: review asks the server for the full plan, the same plan the install would run. It is a preview. Nothing is written.

The items are grouped by the service that will handle them. Assistant, routing and forms holds the module, the visitor forms, the assistant's access to the service, the routing rule and your note. Appointments has one appointment type per service. Connections is the Kav appointments service itself.

Every row has an action. Create will be added. Update changes something you installed before. Already present means it exists and matches. Edited by hand means someone changed the row: it is shown as a difference, and never overwritten. Switch off retires a row. Blocked cannot be installed, and Not planned is left alone.

Here the Appointments group has one Blocked row, with the reason beside it: the booking hours are not valid. This is the mistake from chapter five, on the group class. The server checks that each range closes after it opens, and that ranges on one day do not overlap.

At the top, the plan says no calendar is linked, so customers get an emailed invite only, and that the licence is included.

Routing checks list sample sentences in four languages, with the capability and routing rule each should reach, and a state: Passed, Failed or Not run. All eleven passed. A check that was not run is no evidence that routing works.

Go back to the questions, and fix the hours on the class.

Review again. Every row says Create, nothing is blocked, and Next: install is ready.

Chapter 9. Install and the result

Goal: Install, read the result table, and know the next steps.

The last step is Install. The install is sent and runs in the background, and the table refreshes every few seconds.

Choose Install this solution.

Thirteen items report back. Some are Applied at once. The assistant's four capability bindings say Needs your attention: the connector instance could not be verified, check it, then apply again. The overall status says Needs your attention too.

Installing is safe to repeat. Choose Apply again with these answers. What exists is now Already present, the four bindings are Applied, and the status reads Installed.

Below, What to do next offers three steps: Try it in the widget, Connect your calendar, and See bookings.

That is every option in the wizard. In course 2B, we look at what your customers experience: the emails, the calendar entry, and managing bookings afterwards.