Google Calendar

The Google Calendar connection gives a ThunderPhone agent a defined set of calendar tools for live phone conversations. An attached agent can list events, check availability, create an event, update an event, or cancel an event, subject to the permissions enabled on the connection.

That makes the integration suitable for scheduling flows where the calendar event is the working record. It does not decide your availability rules, cancellation policy, or escalation criteria; those belong in the calendar configuration and the agent prompt.

What the Google Calendar connection does

Google Calendar is a native app connection under Connections → Apps. An administrator or owner completes the authorization flow, reviews permissions, and then attaches the saved connection to one or more agents. Multiple accounts can be connected when separate agents or workflows need different calendars.

Viewing events and availability and creating events start enabled. Updating and canceling events start off until you enable them. When an operation is disabled, its corresponding tool is not available to the agent during calls. This lets a scheduling agent create appointments without automatically receiving permission to change existing ones.

Once attached, the agent chooses when to use the calendar tools from the caller's request and its prompt instructions. The prompt should define the event details to collect, how to present available times, what the caller must confirm, and what to do when the calendar returns no suitable result.

Typical call flows

Schedule a new event. In appointment scheduling by phone, the agent identifies the type of appointment, checks availability, reads a manageable set of options, and confirms the selected time and caller details. It creates the event only after confirmation and describes the booking as complete only after the tool succeeds.

Change or cancel an event. In a rescheduling and cancellations flow, an agent with the relevant permissions can update or cancel an existing event. It should identify the correct event and repeat the proposed change before writing. If it cannot distinguish between similar events, it should ask for clarification or use a human route.

Interview coordination. For interview scheduling, the agent can check availability and create the agreed calendar event. Hiring decisions, exceptions, and promises beyond the calendar action remain with the recruiting team.

Setup outline

1. In ThunderPhone, open Connections → Apps, select Google Calendar, and complete the account authorization flow.
2. Open the connection and review the operation toggles. Decide separately whether the agent needs view, create, update, and cancellation access.
3. Open the agent in the builder and attach the Google Calendar connection under Connected apps.
4. Write prompt rules for event naming, required caller details, confirmation, allowed calendars or appointment types, and escalation.
5. Save the agent changes, test them against the draft configuration, and deploy only after the scheduling paths behave as expected.
6. Test successful creation, conflicting availability, no openings, ambiguous existing events, updates, cancellations, and calendar errors.

Operating limits

Calendar access is not the same as an end-to-end scheduling policy. The integration provides operations; your configuration determines when they are appropriate. Confirm spoken dates, times, names, and contact details before any write, and do not let the agent infer that a failed or timed-out tool call created an event.

See appointment setting for the broader workflow and human handoff for cases that require staff judgment. For outbound confirmation workflows, keep the rules for appointment confirmation calls explicit and separate from calendar write permissions.