Connect your Google Calendar

Vervox works with two calendar modes:

• Native Vervox calendar — lightweight, built into the dashboard. Good for solo operators or if you don't already use Google Calendar.
• Google Calendar — reads live availability from calendars you and your team already use; writes every booking back to them automatically.

If you use Google Calendar, connect it. The AI will pick up holidays, busy events, and appointments made outside Vervox — preventing double-bookings without you having to duplicate anything.

Steps:

1. Open Settings → Smart Booking → Calendar
2. Click Connect Google Calendar
3. Sign in with the Google account that owns the calendars (not your personal Gmail if those are separate)
4. Grant Vervox read + write access on the selected calendars. You can select which calendars to expose; anything you don't tick is invisible to the AI.
5. Return to the dashboard — the connection status should say "Connected"

If you use multi-staff routing, each provider maps to one calendar. Set this per-provider in Settings → Smart Booking → Providers.

A few common patterns:

• One shared team calendar → every provider points to the same calendar ID (works but removes the benefit of per-staff routing)
• One calendar per staff member → the clean default
• One calendar per resource (chair, bay, room) → treats resources as providers

Vervox uses your Google Calendar OAuth grant for exactly two things:

• Read — when the AI checks availability for a caller, it fetches busy blocks from the mapped calendar(s) for the next 14 days. That's it — it never reads event details or past events.
• Write — when a booking is confirmed, we create a calendar event with the service name, caller name, caller phone, and a link back to the Vervox appointment.

We don't delete, edit, or share other events. If you cancel access from Google, bookings stop working but existing events stay where they are.

Two common issues:

• "Connection lost" / 401 errors — the Google OAuth token expired (usually after revocation or an admin change). Reconnect from Settings → Smart Booking → Calendar.
• Wrong-timezone slots — the AI uses your business timezone, not the calendar timezone, so they must match. Set your business timezone in Settings → Business hours.

For anything else, see Troubleshooting Smart Booking.