iCalendar (iCal) is a standard way to exchange calendar information between software systems. BookThatApp supports the iCalendar standard so you can export and import your bookings to any calendar product that supports that standard such as Google Calendar and Airbnb. You can export all bookings for a shop, or you can export/import bookings for specific products or resources.
Google will check the iCalendar feed that BookThatApp provides for exporting periodically (anywhere between 6 - 24 hours) and synchronize it with any new, updated, or deleted bookings in BTA. In contrast, the app checks incoming calendar feed links used for importing once per hour.
Please note that BTA can also connect directly to a Google Calendar via the API. The advantage of this approach is that the synchronization between calendars happens in real-time. Please see our article on Staff Accounts to learn more.
Exporting All Bookings
Steps:
- On the Overview page, you will find a button that will provide you with your store's iCal feed link.
- Select the iCal icon and a pop-up will display that provides the feed link.
- Select the copy symbol (outlined in red below) and the feed link will be copied to your device's clipboard.
- Open Google Calendar.
- Click on Other Calendars.
- Select Add by URL.
- Paste the URL as noted in step 1.
- If you want the calendar publicly accessible, check the box.
- Select Add Calendar.
Exporting Product Specific Bookings
Here are 2 examples of where you may want to export specific product bookings instead of the entire store's bookings:
- to provide a service provider a feed of the bookings for a product where they provide the service
- to sync your bookings for a specific product in an external system such as AirbnBb
Note: external calendars can only be added to the store once so you cannot add an external calendar to multiple products.
Here are the steps to implement this using Google calendar as the external source to sync to:
- Access a product page in the app.
- Select the More Actions drop-down to reveal the iCal option.
- Select the iCal icon and a pop-up will display that provides the feed link.
- Select the copy symbol (outlined in red below) and the product feed link will be copied to your device's clipboard.
- Open Google Calendar.
- Click on Other Calendars.
- Select Add by URL
- Paste the URL as noted in step 1.
- If you want the calendar publicly accessible, check the box.
- Select Add Calendar.
Note:
- Google updates its copy of the calendar every few hours (every 6 - 12 hours in our experience).
- The feed provides bookings from the last 7 days through to 3 months from now.
Removing a Legacy Feed from Google
Earlier versions of the feed were not secure and are no longer supported. If you are using the legacy ical feed url (that includes your store name at the front) you can remove it by going to your Google calendar and hovering over the calendar.
Click on the X to unsubscribe.
Importing Bookings
Product Implementation
If you offer a product that can be booked in the app as well as on an external site this will allow the product’s availability to be updated in the app. This saves you time because you will not need to create a manual booking or blackout to compensate for the external booking.
- First, you will need to retrieve the iCal feed link provided by your external app.
- In BTA, navigate to the corresponding product.
- On the product configuration page locate the External Calendars section and select the Edit link.
- Select the Add External Calendar button and a field will appear where you can add a name for the calendar feed link as well as the actual link.
- Select Apply.
- You also will need to select Save to update the product configuration.
Now bookings for the product made on your external site will have their availability updated in the app. The app reviews the feed once per hour in order to update availability.
Resource Implementation
For instance, say you have a service provider that you have set up as a resource in the app. It is now possible for their busy time from their external calendar to be reflected in the app without creating a corresponding staff account.
It will work by affecting the availability of the products the resource is associated with. This is great for stores that have a service provider that handles multiple services.
- First, you will need to retrieve the iCal feed link provided by your external app.
- In the app, select Configuration-> Resources.
- Select the Staff resource where you want to add the external calendar feed.
If you need details on how to create your resource please see the following.
https://support.zetya.com/hc/en-us/articles/211514086-Resources - Locate the External Calendars section and select the Edit link.
- Select the Add External Calendar button and a field will appear where you can add a name for the calendar feed link as well as the actual link.
- Select Apply.
- You also will need to select Save to update the resource configuration.
Now bookings for the resource made on your external site will impact the resource's availability in the app. The app reviews the feed once per hour in order to update availability.
Comments
7 comments
Is there a way to import additional details such as customer name/ transaction ID/ notes?
Hi Azmolek
No, sorry not at the moment. You can view full booking information using the built-in Run Sheet in the app.
Thanks
Jack
But how do we access this on the run? We are running out of a truck, and have no computer access, only ipads...
Hi there
You would log into Google the same way you would on a desktop and open up the calendar.
Thanks
Jack
is there a time lag between following the above and having it 'go live"?
My shopify class does not appear at my google calendar as yet...
Thanks!
Hi Brian
The calendar will show bookings, not events. Google synchs once every 24 hours so if you have existing bookings then they will display on the calendar once it has synched.
Thanks
Zetya Support
thanks for this tutorial, works great! I am wondering if i can retrieve bookings from when my store opened, which is more then 6 months ago? When i setup this calendar in google it only retrieved today going forward. Any help on this would be greatly appreciated!
I want to have the old bookings because I like the google interface when reviewing the past bookings.
thanks again, Jamie
Article is closed for comments.