Google Calendar and Workspace Integration
The Google Suite integration connects a Google account to your workspace so booking plugins can check free time on a Google Calendar and add appointments to it. It also allows plugins to read and write Google Sheets.
Go to Platform › Developer › Integrations › Google Suite.
Google Suite is an add-on ($10.00 one-time). If the row shows Unlock, buy it first. See Integrations Overview.
Connect Google
- Go to Platform › Developer › Integrations and click Connect on Google Suite.
- In Connect to Google, click Connect.
- Pick the Google account that owns (or can edit) the calendar you want to book into.
- Approve access. Taalk asks for:
- your profile and email
- read access to your calendars and permission to create events
- access to Google Sheets
- Back in Taalk, the panel shows Account, Connected At and Expired At.
The connection is shared by the whole workspace. Use Connect with Another Account to switch, or Disconnect to remove it. To fully revoke Taalk's access, also remove Taalk under third-party access in your Google Account settings.
Taalk doesn't ask for Gmail access and doesn't send email through Google. Email from Taalk goes through your email providers. See Email Provider Setup.
How booking works
Calendar booking runs through a plugin on your AI agent:
- During the call, the agent asks when the contact is free ("tomorrow", "next week").
- A plugin action asks Taalk for open times on the connected calendar (the primary calendar unless another calendar is set).
- Taalk returns up to 3 open 30-minute slots, picked at random from the free time in that range.
- The agent offers them. The contact picks one ("the first one", "Tuesday at 2").
- A second plugin action books it. Taalk creates a 30-minute event on the calendar.
Which hours count as open
| Case | Open hours |
|---|---|
| The plugin passes a campaign | That campaign's schedule (Start Time, End Time, Working Days) |
| No campaign | Monday to Saturday, 8 AM to about 8 PM, in the timezone passed (or the default) |
Busy times on the calendar are skipped. A range with "week" or "month" looks 5 days ahead; anything else looks at one day.
What the event contains
| Field | Value |
|---|---|
| Time | The chosen slot, 30 minutes long |
| Attendee | The contact's name, with "Phone: <number>" as the comment |
The event has no title, description or call summary. If you need those, add them from your own system using the post-call webhook.
[Confirm] Taalk support or the Calendar Booking plugin template sets up the two booking actions for you; there's no booking switch in the agent settings.
Google Sheets
The connection includes Sheets access, so a plugin can read or write a spreadsheet through Taalk without its own Google credentials. This is an advanced setup; ask Taalk support or see Plugin Actions Reference.
Troubleshooting
| Problem | What to check |
|---|---|
| No slots offered | The calendar is busy for that range, or the hours fall outside the campaign schedule. |
| Events land on the wrong calendar | The plugin books into the primary calendar of the connected account unless set otherwise. |
| "Expired At" is in the past | Click Connect with Another Account and sign in again. |
| Google shows a warning screen | Make sure you're signing in with the account you meant to use. |
What Google Suite can't do (yet)
- Send email through Gmail.
- Set slot length (always 30 minutes) or buffers between meetings.
- Add a title, description or meeting link to the event.
- Invite the contact by email.
- Check more than one calendar at a time.