Bookings troubleshooting¶
If something here doesn't solve it, note the call (its View call link in the audit log) and contact support.
Connecting¶
I can't see the Bookings tab
The tab is for operator admins and super-admins, and an operator admin only sees it after a super-admin has switched Bookings on for the operator (Administration). Regular users never see it.
\"This doesn't look like a Cliniko API key\" or \"Cliniko rejected this key\"
Copy the key again in full; Cliniko shows it only once, so if you no longer have it, create a new one. Check the key hasn't been archived in Cliniko, and that the user who created it still has Allow yourself to create and use API keys set to Yes.
\"This Cliniko user's role is too narrow\"
Cliniko refused a request the connection needs, such as reading patients, practitioners or appointments. Give the Cliniko user a role that can view patients and manage appointments, then press Re-verify (or Replace key with a key from a user who has that role).
The card warns the key belongs to a user with a broad role
The key owner is an Administrator, Bookkeeper or Power receptionist. It works, but a leaked key could do everything that user can. Create a dedicated user with a narrower role and use Replace key (Set up Cliniko bookings).
A business shows \"Not online-bookable\" or is missing practitioners
Phone offers follow Cliniko's online-booking setup. Make sure online bookings are on, and that the business, the practitioner and the appointment type are each shown in online bookings, with the practitioner offering that type at that business. Then press Re-verify. See Prepare Cliniko.
\"Timezone unknown: bookings are blocked for this business\"
Cliniko didn't give a timezone for the business or the key owner. Set the timezone in Cliniko, then press Re-verify.
Switching agents on¶
The agent's switch is greyed out
The agent must be enabled, in scenario mode and English; the note under the agent says which. The switch is also greyed out while the connection isn't Connected (for example Key rejected) or the operator's Bookings switch is off.
\"Cliniko's cancellation notice is unset or 0\"
Cliniko has no minimum notice for cancellations. Either set one in Cliniko and press Re-verify, or choose Custom hours under Cancellation notice and save.
\"The chosen businesses must share one timezone\"
One agent can only act for businesses in the same timezone. Use a separate agent for the other businesses.
An agent's bookings switch turned itself off
Either Cliniko rejected the key (the connection shows Key rejected; see Change the key), or the overnight check found the agent's businesses are no longer online-bookable. Fix the business in Cliniko, press Re-verify, and switch the agent back on.
On calls¶
The agent didn't offer to change the appointment
Check the agent's bookings switch is on and Cliniko is Connected. The booking steps start when the caller asks about an appointment they already have; a new booking, a different practitioner or a different appointment type becomes a message.
A real patient couldn't be verified
Open the call's rows in the audit log. Common causes:
- the date of birth in Cliniko is missing or different;
- the patient called from a number not on their Cliniko record (with the default unknown-number setting the agent takes a message);
- the name in Cliniko is spelled differently (names must match exactly, apart from capitals, accents and punctuation);
- another patient has the same details and number, so the agent can't tell them apart;
- a daily limit was reached (see the limits).
The agent says it can't move an appointment, only cancel it
The appointment's practitioner or appointment type isn't online-bookable, or the appointment is longer than its appointment type. The agent takes a message for the clinic to move it.
The agent won't change an appointment that is soon
It is inside the cancellation notice window, which covers moves as well as cancellations. The agent takes a message.
The agent finds no free times, but the diary has gaps
The agent only offers times that online booking would offer: the same practitioner and appointment type, inside Cliniko's lead time and booking window, and at most four weeks ahead. Gaps shorter than the appointment type, or outside the practitioner's online availability, aren't offered.
The caller was told the clinic will confirm the change
Cliniko didn't confirm the change in time. The clinic got an alert email ("A booking change could not be confirmed"). Check the appointment in Cliniko and call the patient.
The transcript shows [date of birth]
That's by design: dates of birth are removed from transcripts. The recording still has it until data deletion.
Some of an agent's older calls lost their transcripts and recordings
Once an agent has bookings on, all its calls older than Keep call data for are cleared each day, including calls from before bookings were switched on. See Data deletion.
Related¶
- Set up from the start → Set up Cliniko bookings
- General problems → Troubleshooting
Related¶
- What happens on a booking call — Step by step, what a caller is asked and hears when they move or cancel a Cliniko appointment with an agent, and when the agent takes a message instead.
- Appointment bookings (Cliniko) — Let an agent move or cancel a caller's appointment in Cliniko during the call, and control how callers are verified, what is kept and which agents can do it.
- Running bookings day to day — Look after a live Cliniko connection, covering the audit log, alert emails, summary-email lines, the patient email, nightly key checks, data deletion, and changing or removing the key.
- Set up Cliniko bookings — Step-by-step setup of Cliniko bookings for a clinic, from preparing Cliniko and creating the API key to testing an agent and going live.
- Troubleshooting — Common issues with agents, calls, and embeds — and how to fix them.