Cancellation from Google Calendar
TheBooking writes the bookings of a plan to its destination calendar. With cancellation from Google Calendar on for the plan, deleting the event of a booking in that calendar cancels the booking in TheBooking, and the usual cancellation emails go out.
You turn it on for each availability plan. Start with Observe only: TheBooking records the deletions it sees and what it would cancel, but cancels nothing.
Requirements
- An administrator. Only administrators see the setting.
- A Destination calendar in the plan. See Create events after reservation.
- Live updates on the Google account of that calendar, and so a public HTTPS site. TheBooking sees the deleted events through Google's notifications: without them, it does not look for deletions. See Live updates.
When a requirement is missing, the setting cannot be turned on and says why, for example Available when a calendar in this plan is a destination. When Live updates are missing, the message has a Go to Calendars link.
Turn it on
- Open Availability > Plans, and select the plan.
- On the Settings tab, under Calendars, save your changes to the calendars first. This setting applies at once, outside the Save bar.
- Turn on Cancel bookings when their event is deleted in Google Calendar.
- In Cancel bookings from Google Calendar, under Mode, select Observe only or Cancel bookings.
- If the plan has several Destination calendars, select one under Which calendar decides?. Only the deletions in that calendar count.
- With Cancel bookings, select I understand that deleting or moving an event in this calendar cancels its bookings.
- Select Start observing, or Turn on.
TheBooking first checks the future bookings of the plan, and the state is Preparing. Then the state is Observing or On, with the number of future bookings covered.
What cancels a booking
A booking is cancelled when its event leaves the calendar that decides:
- The event is deleted in Google Calendar.
- The event is moved to another calendar.
Changing the time, the title, or the guests of the event in Google Calendar changes nothing in TheBooking. Before cancelling, TheBooking reads the event from Google again: if the event was restored in the meantime, nothing happens. A booking that is already cancelled stays cancelled when the event is restored later.
Bookings that share one event, such as several bookings of the same group slot, are cancelled together.
Which bookings are covered
TheBooking covers the confirmed bookings of the plan that have not started yet, including the bookings made after you turn the setting on. The status shows, for example, "Covers 12 future bookings · 2 not covered". Select the "not covered" link to see each reservation number with its reason, for example:
- Reservation is not confirmed. A booking pending approval or payment is not cancelled from Google.
- Reservation has already started.
- The provider of this booking does not use the Destination calendar. The calendar that decides applies to other providers. See Google accounts and providers.
- The event is missing in Google Calendar.
What a cancellation does
A cancellation from Google Calendar works like a cancellation in the WordPress admin:
- The reservation becomes Cancelled, and its time is free again.
- The cancellation emails to the customer, the administrator, and the provider go out, as set in the notifications of the service.
- Webhooks for
reservation.cancelledreceive the reservation. See Webhooks. - TheBooking deletes the Zoom meeting of the booking, and removes the booking from its events in other Google calendars.
In the Activity tab of the reservation, the cancellation shows System as its author.
With Cancel bookings, deleting an event in the calendar that decides cancels a customer's booking and emails the customer. This includes a provider who cleans up their calendar, and every person who can change the events of the calendar. Tell them before you turn it on.
Try it with observe only
In Observe only, TheBooking cancels nothing and sends nothing. The plan shows Observing, and each deletion of a covered event is recorded in the activity of the plan, with the state Would have cancelled; no action taken and the reservation number.
To try the function safely:
- Turn on the setting with Observe only.
- Wait until the state is Observing.
- Book a time of the plan, and check that its event appears in the Destination calendar.
- Delete the event in Google Calendar.
- In the plan, select Show activity. The Activity panel lists the changes from Google Calendar for this plan: the deletion appears as Would have cancelled; no action taken, with the number of the test reservation.
- Cancel the test reservation in Reservations.
Select Start cancelling to switch to Cancel bookings. The deletions recorded in Observe only stay recorded: switching does not cancel those bookings. To go back, select Switch to observe only.
Review the activity
Select Show activity to open the Activity panel of the plan. All activity lists every change from Google Calendar that TheBooking recorded, with its state, the reservation numbers, and the delivery of each email and webhook. Filter the list by state, for example Cancelled or Ignored.
When something needs you, the plan shows a note with Review, and the panel lists it under Needs your attention:
- A blocked change: TheBooking did not apply it, for example because the bookings of the event belong to plans with different settings. Select Dismiss and enter a Reason to close it: the bookings stay unchanged, and the record stays in the activity.
- A delivery that failed, or whose result is unknown: select Repeat delivery. The email or webhook might have reached its recipient already, so repeating it can send a duplicate.
When it pauses
The state is Paused when TheBooking cannot follow the calendar, with the reason:
- Google is not sending notifications for the Destination calendar, or Live updates are off for its account. Cancellation resumes when the notifications are back, and the deletions made in the meantime are processed then.
- The bookings could not be checked. Select Check bookings again.
After a change to the plan or to the calendar, TheBooking checks the bookings again by itself, and the state is Preparing until it is done.
Turn it off
Turn off Cancel bookings when their event is deleted in Google Calendar. From then on, deleting an event in Google Calendar cancels nothing. The changes left to review stay in the Activity panel.
To use another Destination calendar to decide, select Change calendar.