Taalk Help Center

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

  1. Go to Platform › Developer › Integrations and click Connect on Google Suite.
  2. In Connect to Google, click Connect.
  3. Pick the Google account that owns (or can edit) the calendar you want to book into.
  4. Approve access. Taalk asks for:
    • your profile and email
    • read access to your calendars and permission to create events
    • access to Google Sheets
  5. 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:

  1. During the call, the agent asks when the contact is free ("tomorrow", "next week").
  2. A plugin action asks Taalk for open times on the connected calendar (the primary calendar unless another calendar is set).
  3. Taalk returns up to 3 open 30-minute slots, picked at random from the free time in that range.
  4. The agent offers them. The contact picks one ("the first one", "Tuesday at 2").
  5. 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.

Related