GmailIntegration
Connect your Google account to WA Orbit to enable appointment booking, Google Meet links, and Google Workspace flow nodes — all powered by a single Google sign-in.
Explore IntegrationsOverview
A single Google sign-in connects your workspace to Google Workspace and unlocks several features: Calendar slot pickers for appointment booking, on-demand Google Meet links inside flows and the inbox composer, and the Sheets, Docs, and Forms flow-builder nodes.
You manage the connection from More → Google account. Connect once per workspace — the connection is stored securely and reused everywhere Google is needed.
One Account Per Workspace
The Google account belongs to whoever clicks Connect first. Calendar events and Meet links appear in that user's Google Calendar. There is a hard cap of one Google account per workspace.
Platform Admin Setup (One Time)
A platform administrator creates one Google OAuth client in the Google Cloud Console. After that, each workspace operator just clicks Connect and approves the consent screen.
Step 1 — Project + OAuth Consent Screen
- Create (or select) a Google Cloud project.
- Open APIs & Services → OAuth consent screen. Choose External (unless every user is inside your own Google Workspace org, then Internal).
- Fill in the app name, support email, and authorized domain.
- Add the scopes you intend to use. While in Testing, add the Google accounts that will connect as Test users.
Step 2 — Enable Required APIs
Under APIs & Services → Library, enable each of these:
- Google Calendar API — slot pickers + Meet link generation.
- Google Sheets API — the Sheets flow node.
- Google Docs API — the Docs flow node.
- Google Drive API — doc copy/share + file pickers.
- Google Forms API — the Forms flow node.
Step 3 — Create OAuth 2.0 Client + Redirect URI
- Open APIs & Services → Credentials → Create credentials → OAuth client ID.
- Application type: Web application.
- Under Authorized redirect URIs, add:
https://YOUR-DOMAIN/appointments/oauth/google/callback - Click Create. Copy the Client ID and Client Secret.
Step 4 — Paste Credentials into WA Orbit
- Go to Admin → Settings → Integrations → Google.
- Paste the Client ID and Client Secret (the secret is encrypted and never shown again).
- Turn Enable on and save.
Connecting Your Account
- Open More → Google account.
- Click Connect Google account. You're taken to Google's consent screen.
- Sign in and approve the access. Google shows you exactly what you're granting.
- You land back on the page. The status flips to connected, showing your account email, avatar, and selected calendar.
OAuth Scopes & Privacy
WA Orbit requests the minimum scopes needed for the features it powers, bundled into one consent:
| Feature | Scope | Access |
|---|---|---|
| Calendar & Meet | auth/calendar | Check free/busy times, create events, generate Meet links. |
| Sheets node | auth/spreadsheets | Add and read rows in your spreadsheets. |
| Docs node | auth/documents | Copy a template document and fill in placeholders. |
| Drive (file pickers + sharing) | auth/drive | List existing Sheets/Docs/Forms, copy templates, share copies. |
| Forms node | auth/forms.body.readonly | Read a form's structure and its responder link. |
Privacy
WA Orbit only reads or writes the specific files you pick in a flow node — it never touches the rest of your Drive. The drive permission is needed so the flow builder can list and copy the files you choose.
Calendar & Meet Links
Once connected, the Google token powers three touchpoints:
- Book Appointment node — offers customers real open time slots (your availability minus busy time on your Google calendar) and writes the booking to your calendar.
- Google Meet node — creates a fresh Meet link inside a flow and sends it to the customer.
- Inbox "Send Meet link" — a button in the Team Inbox composer. The operator picks a duration and a Meet link is generated and dropped into the reply.
Troubleshooting
| Symptom | Cause & Fix |
|---|---|
| redirect_uri_mismatch | The redirect URI in Cloud Console doesn't match. Set it to exactly https://YOUR-DOMAIN/appointments/oauth/google/callback — same protocol, host, and path, no trailing slash. |
| Admin setup needed / Connect disabled | The platform OAuth client isn't set up, or the feature is off. An administrator pastes the Client ID and Secret and turns Enable on. |
| Flow node fails with "missing scope" | The connection predates that node. Click Reconnect on the Google account page to re-run OAuth with the full scope set. |
| Sheets/Docs call errors despite the scope | The matching Google API isn't enabled. Admin enables the APIs in the Cloud Console. |
| Connection drops after ~1 hour | Auto-renew wasn't enabled. Click Disconnect, then Connect again so Google shows the consent screen. |
Google Sheets
Export WhatsApp analytics and contact data directly to Google Sheets for reporting.
Google Drive
Send documents and files stored in Google Drive directly through WhatsApp.
Trello
Create Trello cards from WhatsApp messages and manage tasks collaboratively.
Webhook
Connect any custom software by sending data to your own webhook endpoint via WA Orbit.
