Booking events directly to your calendar is coming soon. For now, the agent confirms the slot verbally with the caller, and your team locks it in afterwards.
Add the action to your agent
- Open the agent you want to give calendar access to.
- Go to Conversation Settings → Function Calls.
- Click the + button to add a new function call.
- Pick GCal — Check Availability from the list.
- Fill in the configuration (see below).
- Click Save.
Connect Google Calendar first. This action needs a connected Google Calendar at the workspace level. If you haven’t connected one yet, the action shows a prompt to connect from the Integrations page and Save stays disabled until you do.
GCal — Check Availability
The agent uses this when the caller asks “when are you free?” or wants to find a time for a meeting. It looks at your calendar(s), finds open windows, and reads back concrete slot suggestions.Configuration
| Field | What it does | Recommended starting point |
|---|---|---|
| Calendars | Which calendars to check. A dropdown shows every calendar your connected Google account can see — pick one or more. | Primary (your main calendar) |
| Slot duration (minutes) | How long each proposed slot should be. | 30 (or 15 for quick callbacks, 60 for inspections) |
| Look-ahead (minutes) | How far into the future to search. | 7200 (5 days) |
| Minimum notice (minutes) | Don’t propose slots starting within this many minutes from now. | 60 (don’t propose slots within the next hour) |
| Max slots | The maximum number of options the agent will read out. | 5 (more than this is overwhelming on a call) |
| Default timezone | IANA timezone, e.g. Australia/Sydney. The agent uses this when the caller doesn’t specify a timezone. | Your office’s timezone |
| Transition message | A short phrase the agent says before checking the calendar — fills the silence during the lookup. | ”Let me check the calendar for you…” |
What the caller hears
Caller: When can I come and see the property? Agent: Let me check the calendar for you… I’ve got three options that work: Thursday at 10 AM, Thursday at 2 PM, or Friday at 9 AM. Which suits you? Caller: Thursday at 2 PM works. Agent: Great — I’ll note that down and someone from our team will confirm with you shortly.The agent confirms the slot verbally; your team picks it up and creates the calendar entry once the call ends.
Common patterns
Inspection requests
- Slot duration 60 minutes, look-ahead 48 hours, max slots 3.
- Default timezone matches the property’s location.
Vendor catch-up calls
- Slot duration 15 minutes, look-ahead 5 days, max slots 5.
- Useful for callers who want a short check-in this week.
Sales colleague handovers
- Add the colleague’s shared calendar to the Calendars dropdown so the agent looks at their diary instead of (or in addition to) yours.
- Slot duration matches the colleague’s typical call length.
What happens if Google Calendar is disconnected
If you disconnect Google Calendar from the Integrations page, you’ll first see a confirmation listing every agent that uses the Check Availability action — and confirming removes the action from those agents. You can re-add it after reconnecting. If your Google account revokes Voqo’s access without you disconnecting in-app, the action stays configured but stops working gracefully — on the next call the agent simply doesn’t offer to check availability, and the caller experience is unaffected. Reconnect from the Integrations page to restore it.Other AI surfaces that use this connection
The same Google Calendar connection — granted once at the workspace level — powers other AI surfaces as they ship:- AI assistant (available now). The AgentOS sidebar assistant reads your events to answer scheduling questions like “what’s on my plate today?” without you having to add anything to an agent. Choose which calendars it reads from the Google Calendar card’s ⋮ → Choose calendars menu — see Setup.
- SMS agent (coming with SMS launch). The same GCal — Check Availability action becomes available on SMS agents — same form, same calendar picker, same behaviour.
When booking returns
We’re shipping the read path first to make sure availability lookups work reliably across a wide range of calendar setups. Once that’s proven out, we’ll add GCal — Create Booking as a second action so the agent can lock the slot in directly during the call (with an automatic calendar invite to the caller). When that ships you’ll need to reconnect Google Calendar to grant the additional write permission.Related docs
- Function Call Agent Actions → GCal — Check Availability — full configuration reference
- Google Calendar Overview
- Connect Google Calendar
- Troubleshooting