Appointment Troubleshooting
Fix the common appointment problems: bookings missing from your calendar, no slots offered, wrong times, duplicates and missing reminders.
Showing instructions for Xebit VoiceCloud.Showing instructions for Xebit VoiceKit, on your own infrastructure. Switch with the selector at the top. Updated 22 October 2026.
Most appointment problems start in one of three places: the connection between the agent and your scheduling system, the availability held in that system, or the rules in the agent's instructions. Open the call's details first; the transcript and event log show what the agent asked your system and what came back.
A booking is missing from your calendar
- Open the call's details in the dashboard or admin console and read the transcript. The booking is written only after the caller clearly says yes; if they did not, there is no booking.
- Check the event log for the write booking action. If it failed, the error from your scheduling system is shown there.
- Check the credentials Xebit uses for your system are still valid and allowed to create bookings.
- Check you are looking at the right branch, calendar and time zone.
The agent offers no times
- Check your scheduling system has open days and hours set for the branch and appointment type the caller asked for.
- Check the requested date is inside your booking window and outside any closure.
- Check the agent has the check availability action attached, and that its instructions list the appointment types it can book.
- Check the event log: if the availability action returned an error or an empty list, the agent had nothing to offer.
- If everything is genuinely full, the agent is right. Look at the calendar to confirm.
Bookings land outside your hours
- Check the working hours and closures in your scheduling system.
- Check the time zone in your scheduling system matches the one in the agent's instructions.
- Check no special opening hours were added for that date by mistake.
Bookings are too far ahead or too soon
- Check the booking window and minimum notice in the agent's instructions, and in your scheduling system if it supports them.
- Make the rule explicit, for example "do not book more than 30 days ahead" or "do not book anything less than 2 hours away". See Availability and Booking Rules.
The agent will not reschedule or cancel
- Check the agent has the find bookings action and the update or cancel action attached.
- Check its instructions allow it to reschedule or cancel.
- Check whether the request was inside your notice period. If it was, the agent is right to transfer the caller.
- Check the find bookings action can match the caller, usually by phone number in E.164 format.
One person has several bookings
- Tell the agent in its instructions not to add a second upcoming appointment for the same person.
- Make sure the find bookings action runs before booking, so the agent knows about existing appointments.
Reminders or confirmations were not received
- Messages: these are sent by your own messaging system from a Xebit webhook. Check the webhook was delivered and that your system sent the message. See Webhook Failures.
- Reminder calls: check the appointment reached the reminder campaign's list, the campaign is running and the call falls inside its calling windows. See Campaign Troubleshooting.
- Check the customer's number and email address are correct in your scheduling system.
- On an air gapped install, check the messaging system that receives webhooks is inside the network.
The connection to your scheduling system fails
- Check your scheduling system's API is reachable from the internet and that a firewall is not blocking Xebit's requests.
- Check the credentials have not expired or been revoked.
- Check your scheduling system is reachable from where Xebit VoiceKit runs. On an air gapped install, it must be inside the network.
- Check the credentials have not expired or been revoked.
The SRE agent in Observability can open an incident when a workflow action keeps failing and writes up the root cause.
Still stuck
Write to hello@xebit.ai or use the contact page, with the agent's name and an example call.
Support is included in your Xebit VoiceKit licence.
Next steps
- Calendar Integration: check how your system is connected.
- Agent Troubleshooting: problems with the agent itself.