Sync a calendar with Google Calendar
Summary
Section titled “Summary”You sync a KonversAI calendar with Google Calendar in the Google Calendar section of the Edit calendar page in the KonversAI console. You connect a Google account once, then each KonversAI calendar picks one Google calendar from that account. With Two-way sync, times you are busy in Google cannot be booked in KonversAI, new bookings appear in Google Calendar on their own, and changes to titles, notes and guests go both ways. With Only block my availability, Google events block times in KonversAI and KonversAI writes nothing to Google. When someone deletes or moves a customer’s booking in Google, KonversAI does not change the booking. KonversAI lists the change under Action required on the Calendar screen until you decide.
Who can do this
Section titled “Who can do this”A Tenant Admin, or any team member whose role includes the Modify calendar permission. You need Modify calendar to connect a Google account, choose a Google calendar, pause or stop the sync, and decide on changes under Action required. If you do not see Booking in the left sidebar of the KonversAI console, ask a Tenant Admin to change your role.
Before you start
Section titled “Before you start”Make sure your tenant has the calendar feature. Calendar is a per-tenant feature flag. When the feature is off, Calendar is missing under Booking in the left sidebar of the KonversAI console. A tenant administrator can switch it on under Cost & contract > Addons.
Save the KonversAI calendar first. The Google Calendar section appears only on the Edit calendar page, never on the Create calendar page. See Set up a booking calendar.
Have the Google account that owns the Google calendar ready. Sign in to that Google account in the same browser. To use Two-way sync, the Google account needs permission to change events in that Google calendar. A Google calendar you can only view supports Only block my availability.
The Google account is connected for the whole workspace, not for you alone. Every team member with Modify calendar can pick its Google calendars for any KonversAI calendar, also when a colleague connected the Google account. The connection keeps working when the person who connected the Google account leaves the workspace. KonversAI shows this under Calendar accounts and below Google account in the Google Calendar section. To share calendars from a Google account that does not belong to one person, connect a shared Google account of your team.
Connect your Google account
Section titled “Connect your Google account”- In KonversAI: Select Booking in the left sidebar, select Calendar, then select Settings.
- In KonversAI: Go to Your calendars and select Edit on the calendar. The Edit calendar page opens.
- In KonversAI: Open the Google Calendar section and select Connect Google Calendar. KonversAI opens Google in the same window.
- In Google: Choose the Google account that owns the calendar.
- In Google: Leave every permission box ticked and allow access. Google sends you back to the Edit calendar page in KonversAI.
- In KonversAI: Check for the message Google Calendar is connected.
You can also connect a Google account under Calendar accounts on the Calendar settings page. Select Connect Google Calendar, or Connect another account when one is already connected.
Choose the Google calendar and what syncs
Section titled “Choose the Google calendar and what syncs”- In KonversAI: In the Google Calendar section, choose the account in Google account if more than one is connected.
- In KonversAI: Choose a calendar in Google calendar. (main) marks the main calendar of the Google account. view only marks a Google calendar you cannot change.
- In KonversAI: Under What should sync?, select Two-way sync or Only block my availability.
- In KonversAI: Read the sentence below the choice. For example: We’ll show 34 Google events from the next year here and add 12 upcoming bookings to Google. The sentence also lists Google events that overlap a booking.
- In KonversAI: Select Start syncing. The section shows Getting your Google events. This can take a minute. and then Syncing.
Each KonversAI calendar syncs with one Google calendar. To sync another KonversAI calendar, open its Edit calendar page and repeat steps 7 to 11.
Check the sync
Section titled “Check the sync”- In KonversAI: Open the Google Calendar section of the Edit calendar page. The line under the account shows when the last sync ran, for example Synced 2 min ago · Live updates on.
- In KonversAI: Select Sync now to get changes from Google at once.
- In KonversAI: Select Booking, then Calendar. Google events show with a Google Calendar mark in the colour of the KonversAI calendar. Turn them on or off under Show > External calendars.
Checks for changes every 15 minutes in place of Live updates on means Google changes reach KonversAI on a schedule, not within a minute or two.
Decide on a booking changed in Google
Section titled “Decide on a booking changed in Google”- In KonversAI: Select Booking, then Calendar. A badge such as 3 need attention appears in the toolbar when a change waits for you.
- In KonversAI: Select the badge. The Action required panel shows the KonversAI version and the Google version side by side.
- In KonversAI: Select one action on each card. The card explains what the action does before you select it.
- Use Google’s version cancels or moves the booking in KonversAI. KonversAI emails the customer that the booking is cancelled, or emails the new time.
- Keep ours puts the booking back in Google Calendar, or moves the Google event back to the booking’s time. KonversAI does not email the customer.
- Try again saves the booking to Google Calendar again after Couldn’t update Google.
- Dismiss hides a Double booked card. Both the booking and the Google event stay as they are.
Pause or stop the sync
Section titled “Pause or stop the sync”- In KonversAI: Open the Google Calendar section of the Edit calendar page.
- In KonversAI: Select Pause to stop syncing for a while. Select Resume to start again.
- In KonversAI: Select Change to pick another Google calendar or another sync mode.
- In KonversAI: Select Stop syncing, then Stop syncing again in the dialog, to end the sync for this calendar.
To remove the Google account from the whole workspace, select Disconnect on the account under Calendar accounts on the Calendar settings page. The dialog lists every KonversAI calendar that stops syncing.
What syncs between KonversAI and Google Calendar?
Section titled “What syncs between KonversAI and Google Calendar?”With Two-way sync in the Google Calendar section of the Edit calendar page, confirmed bookings, bookings waiting for review and blocked time appear in Google Calendar. A booking waiting for review has a title that starts with Pending:. The title, the description and the guests sync both ways. The booking notes become the event description in Google, followed by the customer’s name, email address and phone number. A short hold while a customer finishes booking or paying does not appear in Google. A cancelled booking disappears from Google Calendar. With Only block my availability, KonversAI writes nothing to Google Calendar.
Does the customer get an invitation from Google?
Section titled “Does the customer get an invitation from Google?”No. KonversAI does not add the customer as a guest on the Google Calendar event. KonversAI writes the customer’s name, email address and phone number in the event description instead. KonversAI sends the customer’s booking confirmation and calendar invitation by email, the same as without Google Calendar. Only guests that your team adds to the event sync as guests. When you add a guest in the Edit Google event dialog in KonversAI, Google does not email that guest.
Why do some Google events show only as busy?
Section titled “Why do some Google events show only as busy?”A Google event marked Private in Google Calendar shows in KonversAI as busy time only. KonversAI does not store its title, description or guests, and you cannot edit it from the Calendar screen in KonversAI. The private event still blocks booking times on the KonversAI calendar. A Google event marked Free in Google Calendar shows with a dashed outline and does not block bookings. A Google event you declined does not block bookings either.
Someone deleted or moved a booking in Google Calendar. What happens?
Section titled “Someone deleted or moved a booking in Google Calendar. What happens?”KonversAI keeps the booking as it is and does not email the customer. The change waits under Action required on the Calendar screen, behind the toolbar badge such as 1 needs attention. Use Google’s version cancels or moves the booking in KonversAI, and KonversAI emails the customer. Keep ours puts the booking back in Google Calendar as it is in KonversAI, and the customer is not emailed. A new time must be free in KonversAI. When the time is not free, KonversAI shows why and the card stays open.
The colleague who connected the Google account left. What happens?
Section titled “The colleague who connected the Google account left. What happens?”The sync keeps working. KonversAI does not stop a connection when the person who connected it leaves the workspace. The connection stops when someone selects Disconnect on the account under Calendar accounts on the Calendar settings page. It also stops when Google stops accepting the connection, for example when the Google account is closed. The account then shows Needs reconnecting. To move the calendars to another Google account, connect that account under Calendar accounts. Then select Change in the Google Calendar section of each Edit calendar page and choose a Google calendar from the new account.
Can I keep using my iCal link?
Section titled “Can I keep using my iCal link?”Yes. The iCal link stays available under Use an iCal link instead in the Google Calendar section of the Edit calendar page. The iCal link only reads, and checks every 15 minutes. When Google Calendar sync is running and an iCal link is still on, KonversAI shows Google Calendar is syncing, so you can turn off the iCal link now. Select Turn off iCal link to pause the iCal link. When both stay on, the same Google event shows twice on the Calendar screen, and availability is not affected. A Google iCal link shows the button Switch to Google connection. See Connect an external calendar.
The section says “Needs reconnecting”. What do I do?
Section titled “The section says “Needs reconnecting”. What do I do?”Google stopped accepting the connection means Google no longer lets KonversAI use the Google account, and nothing syncs. This happens when someone removes KonversAI’s access in the Google account settings, or when the Google administrator of a work or school account blocks the access. Select Reconnect in the Google Calendar section of the Edit calendar page, or under Calendar accounts on the Calendar settings page. Sign in to the same Google account and leave every permission box ticked. The sync then catches up.
Why can I only choose “Only block my availability”?
Section titled “Why can I only choose “Only block my availability”?”The Google calendar is marked view only. The Google account can see that Google calendar but cannot change its events, so KonversAI cannot add bookings to it. KonversAI shows You can only view this Google calendar, so bookings can’t be added to it. Ask the owner of the Google calendar to give the Google account permission to make changes to events. Then select Change in the Google Calendar section of the Edit calendar page and choose Two-way sync.
The connection failed. What do the messages mean?
Section titled “The connection failed. What do the messages mean?”Google wasn’t connected because access was declined. means access was not allowed on the Google screen. Select Connect Google Calendar again. Google was connected without permission to manage calendar events. means a permission box was cleared. Connect again and leave every box ticked. The connection took too long or was started in another window. means more than a few minutes passed in Google. Select Connect Google Calendar again. Google Calendar can’t be connected yet: the connection isn’t set up on our side. means the connection is not available yet. Contact KonversAI support.
Last reviewed . Tell us when a step no longer matches the product.