Google Calendar Integration
Connect agent calendars securely using OAuth. Understand how the connection persists.
How the Integration Works
SAVVii uses Google OAuth to securely connect to each agent's Google Calendar. Unlike older integrations that required making a calendar public, this approach means:
- Agents do not need to change any Google Calendar settings
- The connection is private and secure — only SAVVii can read it
- The connection is permanent — agents connect once and it stays connected
How tokens work
When an agent connects their calendar, Google issues two tokens:
- A short-lived access token (lasts ~1 hour) — used to read calendar events
- A permanent refresh token — stored securely on your server, never visible in the browser
The system automatically uses the refresh token to get a new access token before each one expires. This is why agents only need to connect once.
Think of it like a hotel key card: Google is the hotel, your server holds the master key, and the app uses short-term day passes to read calendar data — all invisibly in the background.
Connecting an Agent's Calendar
- 1Go to the Agents tab and click on an agent card to expand it.
- 2Scroll down to the Calendar section and click Connect Google Calendar.
- 3A Google login popup appears. The agent signs in with their Google account.
- 4Google asks for permission to read their calendar. Click Allow.
- 5The popup closes automatically and the calendar loads immediately.
Tip: Agents can also connect their own calendar from their agent view under My Calls — they do not need to ask an admin to do it for them.
Test Users (important during setup)
While your app is in Google's "testing" mode (before it is verified), only email addresses you have added as test users can connect their calendar. To add a test user:
- 1Go to console.cloud.google.com
- 2APIs & Services → OAuth consent screen
- 3Scroll to Test users → Add users
- 4Enter each agent's Google email address and save
Remember: Add every agent's Google email here before they try to connect, otherwise they will see an "Access blocked" error.
Troubleshooting
| Problem | Solution |
|---|---|
| Calendar not loading after connect | Refresh the page — the token is stored and will restore automatically |
| "Access blocked" error in popup | Agent's email is not added as a test user — add it in Google Cloud Console |
| Shows "Reconnect" button | Click Reconnect and complete the Google login again — takes 30 seconds |
| Calendar shows but no calls appear | Check the offer's Call Identifier matches the calendar event titles |