polite.aiDocs
BUILD / Tools on calls

Calendar booking

Callers book real appointments straight into a connected calendar, under rules the organisation sets. The AI never reads the calendar.

Connect a calendar first

Booking writes into a real Google or Microsoft 365 calendar, so the organisation needs a connected account. An owner or admin sets it up once, on plans that include integrations (Pro and Scale). See Connect Google Workspace or Microsoft 365. Without a connection, the setup panel offers Connect Google / Connect Microsoft 365 from the same panel.

Set up booking in the Builder

A request to the Builder for callers to book appointments is enough. It proposes the design, then opens the Set up calendar booking panel for an admin to approve:

Choose the calendar

Book into lists the writable calendars from every connected account, grouped by account and marked with the provider used by each one. It never silently picks a main calendar, and the booking policy is saved against the chosen calendar's own account.

Set the rules

Name the appointment (say, Repair visit), then decide when and how callers can book.

Enable booking

Press Enable booking. The assistant writes the agent's booking conversation, ready to test immediately.

When setup cannot proceed, the panel says exactly why, with a link to the place that resolves it.

Booking rules

The rules belong to the organisation: which weekdays and hours are bookable, how long a slot lasts (15 minutes up to 2 hours), how much notice a caller must give (from no notice up to a day), and how far ahead they can book (from one week up to 30 days). A typical policy:

appointment Repair visit
days Monday–Friday, 09:00–17:00
slot 30 minutes
notice 1 day minimum
window 2 weeks ahead

Toggles cover the rest: ask what the appointment is for, capture an address, restrict booking to existing contacts, and save new callers into contacts. One booking policy per team, with one slot length; if the team has several voice agents, a Takes bookings picker chooses which one books.

The two contact toggles depend on what the chosen calendar's account was granted. Saving new callers into contacts needs contact-save permission, which is off unless it was ticked when the account was connected; where it is missing, the panel says so beside the toggle, and reconnecting the account from Integrations adds it.

What the AI can and cannot see

The AI sees only the slots that can be offered, a recognised caller's name, and its own booking confirmations. It never sees the calendar's events, free/busy detail, or the account credentials. Availability is re-checked at the moment of booking, so two callers cannot take the same slot. See Security, privacy & your data for more detail.

Confirmations

Every booking gets a short, speakable reference (like B-4729), read back to the caller. Two kinds of email can follow: team summaries, a note of every booking, sent only to the organisation's verified member addresses (on by default), and caller invites, an emailed calendar invite the agent offers, asking for an email address only when this is on.

Callers can change their own bookings

The same agent can find, move and cancel bookings on a later call. A caller ringing from the number the booking was made with is matched automatically; anyone else is verified against the booking's name, reference or phone number. Moved bookings use a newly offered slot; cancellations need an explicit yes. Changes trigger the same confirmations as the original booking, and everything the agent reads back comes from its own booking record, never from reading the calendar.

Good to know:

Only existing contacts can book restricts new bookings, not changes. Having the booking details is enough to manage it. Past appointments cannot be moved or cancelled.

Last updated 2026-08-24