Google Calendar Integration

Connect your Google Calendar so visitors can book meetings directly from the chatbot. Boei checks your real availability, respects buffers and working hours, and drops confirmed bookings straight into your calendar with a Google Meet link.

How to get there: Go to Setup → Chatbot in the top menu → click your chatbot → Leads → Calendar Booking in the sidebar.

What You Get

  • A visitor-facing time picker inside the chatbot (mini calendar with real free slots)
  • Bookings written to a Google Calendar you pick
  • Automatic Google Meet link on each event
  • Availability rules (working days, hours, buffer, lead time, daily cap)
  • Cancellations from the Boei inbox that also cancel the calendar event

Step 1: Connect Your Google Account

  1. Open Setup → Chatbot → your chatbot → Leads → Calendar Booking
  2. Under Google Account, click Connect Google Account
  3. Sign in with the Google account whose calendar you want bookings to land in
  4. On Google's consent screen, tick all requested permissions (calendar read and event write). Boei needs both to list your calendars, check free/busy, and create events.
  5. You'll return to Boei with Connected as your@email shown in green

Missing permissions warning: if Google only granted part of the permissions, Boei shows a yellow warning listing the missing scopes. Click Disconnect Google Account, then reconnect and tick everything on the consent screen.

During verification: while our Google integration is finishing Google's verification review, new connections are allowlist-only. Email support@boei.help with the Google account you want to use and we'll add you (usually same day).

Step 2: Pick the Calendar and Timezone

Once connected:

  1. Select calendar — pick from the dropdown which Google Calendar to write bookings into. Your primary calendar is labelled "(Primary)". You can pick any calendar the connected Google account has write access to (personal, shared team calendar, etc.). Use the refresh button if a newly-created calendar isn't listed yet.
  2. Timezone — pick your business timezone. Availability windows below are interpreted in this timezone. Visitors see slot times converted to their own browser timezone.

Step 3: Set Your Availability

Under Availability, toggle each day of the week you want to be bookable and add one or more time windows per day using HH:MM-HH:MM (24-hour) format. Examples:

  • 09:00-12:00 — morning only
  • 09:00-12:00 and 13:00-17:00 — split around lunch
  • 08:00-18:00 — full working day

Days without an enabled toggle are never offered.

Step 4: Booking Defaults

  • Buffer between meetings — gap Boei enforces between consecutive slots (0, 5, 10, 15, or 30 minutes). Applies against your existing Google Calendar events too.
  • Days ahead — how far into the future visitors can book (1-90 days). Beyond this, the calendar picker shows no available days.
  • Minimum notice (hours) — earliest a visitor can book from "now" (0-72 hours). Set 2 to prevent bookings less than 2 hours out.
  • Max bookings per day — hard cap on how many chatbot-sourced bookings can land on the same day (0 = unlimited).

Step 5: Event Template

Control what the Google Calendar event looks like:

  • Event title — supports {name} and {email} placeholders. Default: Meeting with {name}
  • Event description — supports {name} and {email}. Leave blank for a minimal event.

The visitor is added as an attendee (so they receive the calendar invite email), and a Google Meet link is added automatically.

Step 6: Turn It On

Flip Enable calendar booking at the bottom of the settings, then click Save Calendar Settings.

Enabling this switch does two things:

  1. Makes the Booking field available as a lead-flow field type (see Lead collector)
  2. Registers the book_meeting and show_calendar_picker skills so the AI chatbot can offer times inside the conversation (see Calendar booking in the chatbot)

Upcoming Bookings

The Upcoming Bookings table at the bottom of the settings shows all future bookings made through this chatbot. Cancel a booking here and Boei also cancels the corresponding Google Calendar event.

Disconnect

Click Disconnect Google Account at the top of the settings. This removes Boei's access token from Google. Existing calendar settings on the chatbot are kept so you can reconnect later without losing your availability rules.

Troubleshooting

"No calendars in the dropdown" — Google didn't grant the read scope. Disconnect and reconnect, and tick all boxes on the consent screen.

"No open slots on this day" — either the day has no availability window configured, the day is beyond your Days ahead limit, or every slot conflicts with an existing calendar event (respecting the buffer).

Bookings not appearing in Google Calendar — check you selected the correct calendar in Step 2. Boei writes to exactly the calendar you picked, not to all your calendars.

Visitor got a wrong time — the visitor sees slots in their browser timezone. Boei stores the booking in the chatbot's business timezone. If a visitor reports a mismatch, ask which timezone their device is set to.