Fine-Tuning Acuity Scheduling for Voka AI

Acuity gives you unusually deep control over how booking works — buffers, intake, packages, classes. Voka reads all of it live, which means the settings below decide what your assistant can and cannot do on a call.

Eight settings, about twenty-five minutes, with your Acuity dashboard open in another tab.

A studio reception desk after closing, lit violet and teal, with an appointment book and a phone handset

0 of 8 done

  1. Check your plan only for the features that need it

    Booking itself works on Standard — Voka connects by OAuth, not the per-account API key that Acuity gates to Premium. What is genuinely plan-dependent is narrower: packages, memberships and gift certificates start at Standard, Acuity’s own text reminders start at Standard and never send during a trial, and your calendar count is capped by tier.

    Do this

    • In AcuityAccountBilling

      Note your tier. Starter gives you one calendar, Standard six, Premium thirty-six. Calendars are how Acuity models both staff and locations, so count the people and places a caller might choose between.

    • In AcuityAccountBilling

      Only move up a tier if you actually want packages, memberships or Acuity text reminders. You do not need Premium for Voka to book.

    If it’s wrong, you’ll hear: Nothing, if you are on Standard — booking works. You would only notice the ceiling when you try to sell a package or split a second location onto its own calendar.

  2. Name appointment types the way your clients say them

    Voka matches what a caller asks for against your live appointment types by name. Names full of internal shorthand, or several types whose names begin with the same word, are what turn a straightforward request into "we don’t offer that". Durations and padding matter just as much: Acuity computes availability from them, so they decide what times a caller is offered.

    Do this

    • In AcuityAppointment TypesTypes

      Read each name out loud. Rename anything you would not say to a client. Keep codes and internal detail in the description.

    • In AcuityAppointment TypesTypeseach type

      Check the duration and the padding before and after. Padding is real time on your calendar — Voka only offers slots where the whole thing fits.

    • In AcuityAppointment TypesTypeseach type

      Anything marked Private stays off the phone as well as off your booking page. That is usually what you want — just know it is why.

    The Acuity Scheduling Appointment Types page showing durations, padding, a Private badge and a Group Classes category
    In AcuityDurations, padding, Private services and your categories all come from this page.

    If it’s wrong, you’ll hear: A caller asks for something by its everyday name and is told you do not offer it — or is offered a time that does not actually work once padding is counted.

  3. Decide whether calendars mean people or places

    Acuity has no separate location object. A calendar is either a staff member or a location, and the location is a free-text field on the calendar. That means a caller choosing a person and a caller choosing a shop are the same choice as far as Acuity is concerned, and you cannot cleanly model both dimensions at once.

    Do this

    • In AcuityAvailabilityCalendars

      Create one calendar per staff member if clients pick a person, or one per location if they pick a place. Pick the one your callers actually ask by.

    • In AcuityAvailabilityCalendarseach calendar

      Fill in the calendar’s location field with something a caller would recognise — the neighbourhood or the street, not "Calendar 2".

    Worth knowing

    One practitioner who works at two sites is handled properly: Voka checks both of their calendars together and offers every time that person is genuinely free.

    If it’s wrong, you’ll hear: A caller is offered a time at the wrong site, or asked to choose between two calendars whose names mean nothing to them.

  4. Answer the intake questions that do not change

    Every required intake question is another thing the assistant has to ask out loud. A three-question form turns a forty-second booking into a much longer call, and every extra question is another chance for something to go wrong. Voka can carry a saved answer for questions whose answer never varies, and submit it for every caller instead of asking.

    Do this

    • In VokaIntegrationsAcuity SchedulingIntake form answers

      Open the "Worth fixing when you have a minute" panel at the top. It names the exact questions costing you call time and links straight to where you answer them.

    • In AcuityIntake Form Questions

      Make genuinely optional questions optional. Anything that must be asked on every call should earn its place.

    • In AcuityIntake Form Questions

      Check for required file-upload questions. Acuity’s API cannot accept a file from a phone booking, so a required one makes that appointment type unbookable by phone.

    The Voka AI Manage Acuity page showing the Worth fixing when you have a minute advisor
    In VokaVoka audits your intake forms and tells you which questions are costing you call time.

    If it’s wrong, you’ll hear: Calls run long and callers get impatient being asked the same fixed question every time — or a booking dead-ends entirely on a required file upload.

  5. Group a long service list into categories

    If your menu is too long to read out, the alternative to a sample of eight services is your own categories: "massage, facials, injectables, or something else — which sounds closest?" Voka then moves to services once the caller picks a direction. It uses your real Acuity categories, and it will refuse to speak them if your account uses the category field as a second name field rather than as real groupings.

    Do this

    • In AcuityAppointment TypesTypes

      Group your types into categories that a caller would recognise as directions, not as service names.

    • In VokaIntegrationsAcuity SchedulingLong service lists

      Turn it on. It is off by default, and Voka shows you how many services and categories it can see.

    If it’s wrong, you’ll hear: Callers hear a long list of example services and pick nothing, or ask the assistant to repeat itself.

  6. Let callers use and buy packages and memberships

    If you sell class packs, memberships or gift certificates, Voka can recognise the caller, apply what they already hold automatically at booking, read the remaining balance back and skip the payment prompt when the pack covers the visit. It can also text a link to buy one. When someone holds both a pack and a membership, it spends whichever expires first.

    Do this

    • In VokaIntegrationsAcuity SchedulingSelling packages & memberships

      Turn it on and confirm how many sellable items Voka can see. It is opt-in per account.

    • In AcuityPackages, Gifts & Subscriptions

      Check that what you sell is set up here and priced. This needs Acuity Standard or above.

    If it’s wrong, you’ll hear: A member with sessions left is asked to pay again, or a caller who wants to buy a pack is told to do it online instead of getting a link.

  7. Choose which add-ons the assistant may offer

    Voka offers your Acuity add-ons once, after the caller has picked their service, and Acuity extends the appointment length automatically. Nothing is offered until you approve it — the assistant will not upsell something you did not choose.

    Do this

    • In VokaIntegrationsAcuity SchedulingAdd-ons

      Turn it on and pick which add-ons may be offered on a call.

    • In AcuityAppointment TypesAdd-ons

      Make sure the add-ons you want offered exist and are attached to the right appointment types.

    The Voka AI Manage Acuity settings list showing add-ons, packages, long service lists, call notes and text reminders
    In VokaEach of these is opt-in, and each shows what Voka can currently see in your account.

    If it’s wrong, you’ll hear: The assistant never mentions the add-on you make the most margin on, because it has not been approved.

  8. Switch on text reminders and call notes

    Someone who books on your Acuity page gets a text reminder. Someone who books by phone historically did not. Voka can ask each caller once, before booking, whether they want reminders and opt them in on a yes — Acuity sends them from its own number. Separately, call notes save what a caller volunteers onto the appointment: the gate code, the parking, that they may run ten minutes late.

    Do this

    • In VokaIntegrationsAcuity SchedulingText reminders

      Turn it on so phone bookings get the same reminders as online ones. Needs Acuity Standard or above, and reminders do not send on a trial account.

    • In VokaIntegrationsAcuity SchedulingCall notes

      Turn it on if you want what callers mention written onto the appointment, in their own words. It is not a call summary and nothing is read back to the caller.

    If it’s wrong, you’ll hear: Phone bookings no-show more than online ones, because only the online ones ever got a reminder.

What stays on your Acuity booking page

A few things are finished online rather than on a call. None of this is something to fix — it is a map of where a caller gets sent.

  • Asks forTo sign up for a multi-week course

    VokaRecognises it as a series and declines rather than booking one session of it, then points them at your booking page. Booking a single session would leave them thinking they had the whole course.

  • Asks forTwo seats in the same class

    VokaBooks one seat per call. Class booking is seat-aware, but one at a time.

  • Asks forTo use a coupon code

    VokaSends them to your booking page, where coupons apply at checkout.

  • Asks forTwo services with two different providers

    VokaBooks them as separate appointments. One Acuity appointment has one provider; add-ons extend a service rather than chaining a second person onto it.

  • Asks forTo be added to a waitlist

    VokaNever claims to have done it. Offers your nearest real openings and can take a callback request that emails your team.

Now test it

Call your Voka number and book the service you just fixed. If you saved an intake answer, listen for the question not being asked. Then open the appointment in Acuity and check the intake answers, the add-ons and the padding all landed.

Something not behaving as described? hello@vokaai.com — we can pull the recording, the transcript and exactly what Acuity Scheduling returned.

Not a Voka customer yet? See what the Acuity Scheduling integration does.

Frequently asked questions

Do I need to upgrade my Acuity plan to use Voka AI?

Not for booking. Voka connects to Acuity by OAuth and reads availability, books, reschedules and cancels on a Standard account. Two things are genuinely plan-gated on Acuity’s side: packages, memberships and gift certificates need Standard or above, and Acuity’s own text reminders need Standard or above and do not send during a trial. Calendar count is the other limit — one on Starter, six on Standard, thirty-six on Premium — and calendars are how Acuity models both staff and locations.

Why is my assistant asking callers a question I already answered?

Your Manage Acuity page in Voka has a panel called "Worth fixing when you have a minute" that tells you exactly this. A required intake question with no saved answer has to be asked out loud on every call, which lengthens the call and adds a chance to get it wrong. Save an answer once, or make the question optional in Acuity.

Can Voka AI collect any intake question over the phone?

Almost all of them. Text, dropdown, multi-select, yes/no and address questions are all collected conversationally and submitted with the booking. The exception is a file upload — Acuity’s API cannot accept a file from a phone booking, so a required file-upload question makes that appointment type unbookable by phone. Make those optional, or keep that service online-only.

How does Voka AI handle prepaid packages and memberships?

It recognises the caller, applies the pack or membership automatically at booking, reads the remaining balance back, and skips the payment prompt when the pack covers the visit. It can also text a link to buy a pack, membership or gift certificate. This needs Acuity Standard or above, since that is where packages and subscriptions begin.

Can Voka AI book group classes?

Yes, with real seat counts, and it tells a sold-out class apart from no class that day. It books one seat at a time. A multi-week series is different — Voka detects a series and declines it rather than booking a single session of it, which would leave the client thinking they had signed up for the whole course.

Why does my assistant read out categories instead of services?

Because your service list is too long to say out loud. Rather than reading a sample of eight, Voka offers your own Acuity categories first — "massage, facials, injectables, or something else" — and then goes to services once the caller picks a direction. It is optional and off by default. It will refuse to speak categories if your account uses the category field as a second name field rather than as real groupings.

Does Voka AI run a waitlist?

No, and it will never tell a caller it has added them to one. When a time is full it offers your nearest real openings, and it can take a callback request that emails your team.

Related

Acuity platform behaviour described here was verified against Acuity’s own developer and help-centre documentation on September 3, 2026. Menu paths follow the Acuity dashboard as of that date and may move. Acuity Scheduling is a Squarespace company. Voka AI is an independent integration partner and is not affiliated with, endorsed by, or sponsored by Acuity or Squarespace. Last updated September 3, 2026.