Skip to main content

Google Calendar

With Google Calendar connected, "book me in for Tuesday at 2" in a chat becomes a real event on your business calendar, with the customer invited by email. This guide covers connecting the account, what the agent can do with it, and where bookings show up.

Connect, Step by Step​

  1. In Faberiq, open Workflow, then the Connectors tab.
  2. Find Google Calendar in the catalogue and click it.
  3. Name the connection, for example "Bookings calendar", and continue.
  4. On the Configure step, click Continue. A Google sign-in popup opens.
  5. Pick the right account. Events are created on this account's primary calendar, so sign in with the Google account whose calendar should hold your bookings (a shared business account is usually better than a personal one). If your browser is signed into several Google accounts, the chooser lists them all; take a second here, because picking the wrong account is the most common setup mistake.
  6. Google shows what Faberiq requests: permission to view calendars and to create and edit events (the calendar.events and calendar.readonly scopes). It cannot delete your calendars or touch anything else in the Google account. Approve.
  7. The popup closes, Faberiq stores the tokens, and the connector card turns connected, showing the calendar name, calendar ID, and time zone it bound to.
  8. On the Skills step, the connector exposes Create calendar event, Update calendar event, Delete calendar event, and Check availability. Leave them enabled and finish.

No webhook or console work is needed; Google Calendar is a pure tool connector.

What It Enables​

Real bookings from conversation​

Workflows use the Book appointments tool (appointment.book). When your agent has agreed on a time with a customer, it books the appointment and Faberiq:

  • creates the event on the connected account's primary calendar,
  • invites the customer by email, so they get Google's normal invitation and reminders,
  • records the appointment against the customer's profile and links the conversation it came from.

The agent needs the customer's email address to send the invite, so a well-built prompt collects name and email before booking. The channel bot recipes (Telegram, WhatsApp, Instagram, Messenger, and the AI Front Desk) already include this tool and the prompting for it.

You can attach the tool to any workflow yourself in Workflow Settings: under Tools, enable Book appointments.

Availability checks​

The Check availability skill queries the calendar's free/busy times, so an agent can avoid proposing a slot you already have booked.

Where Bookings Show Up​

Open Customer Management, then the Appointments tab. It is a Google-style calendar (month, week, and day views) of everything the agent has booked:

  • clicking an event opens a popover with the customer and a link to their profile,
  • each appointment that created a Google event carries a link to the event in Google Calendar,
  • clicking an empty slot pre-fills a manual booking form, so you can book by hand too,
  • cancelling an appointment in Faberiq also deletes the Google event.

The Appointments tab activates once a calendar connector is connected.

Reconnecting​

Google access can end without warning: you revoke Faberiq under the Google account's security settings (Security, then Third-party apps with account access), the account password is changed by an admin, or a Workspace policy revokes tokens. When that happens the connector still exists but calls fail.

To reconnect: open Workflow, then Connectors, click the Google Calendar card, and on the Configure step click Continue to run the Google sign-in again. Reconnect with the same account to keep everything on the same calendar.

Troubleshooting​

SymptomLikely cause and fix
The agent says the appointment was recorded but no calendar invite went outNo calendar is connected (or it was disconnected). The agent is told this explicitly at booking time and will say so. Connect or reconnect Google Calendar, then book again. The appointment itself is still saved in the Appointments tab.
Events appear on the wrong calendarYou signed in with the wrong Google account during OAuth. Disconnect, reconnect, and pick the correct account. Note that events always go to that account's primary calendar.
Customer never received the invitationThe agent booked without a valid customer email. Check the appointment in the Appointments tab; if no email is attached, none could be invited. Tighten the agent's instructions to collect the email before booking.
Bookings worked before and now failAccess was revoked or expired. Reconnect as described above.