Connecting Google Workspace lets your agent read new orders straight from the Gmail inbox your buyers email, and write to buyers from your own address, in their own email thread. It also lets the app save documents to Google Drive and keep lists in Google Sheets.
Plan: every plan. Who can do it: admins. You also need to be able to sign in to the Google account your orders arrive in.
In the app your agent is called Ava by default; you can rename her.
Before you start
For now, you connect with your own private Google app. You make it once in your own Google account, in about 10 minutes. Only your business uses it, nobody else can sign in to it, and you can delete it any time.
- Use the Google account your buyers email, for example
orders@bloomsupply.com. - Works with Google Workspace and with personal @gmail.com accounts (one extra step for @gmail.com, below).
- Don't want to connect? Forwarding works with any email: see Forward orders from your inbox.
Open Integrations → Google Workspace. The section How to connect your Google Workspace shows the same steps as below, each with an Open in Google Cloud link to the right page and Copy buttons for what you paste.
<!-- screenshot: email/connect-google-workspace-1.png — Integrations → Google Workspace with the setup steps -->Step 1: Create a Google Cloud project
- Click Open in Google Cloud and sign in with your orders account.
- Name the project, for example "Wholesale orders", and click Create.
- Make sure the new project is selected at the top of the page for the next steps.
Step 2: Turn on 4 APIs
Click Turn on next to each, then Enable in Google Cloud:
- Gmail API: reads and sends your email.
- Google Drive API and Google Sheets API: save your documents and lists.
- Google Picker API: lets you choose files from your Drive.
Step 3: Set up the sign-in screen
- In Google Cloud, open Google Auth Platform → Branding.
- Enter an app name (for example "Wholesale Agent") and your email as the support and developer contact. Save.
- Open Audience:
- Google Workspace: choose Internal. Only people in your Workspace can sign in, and Google doesn't need to review the app.
- Personal @gmail.com: Internal isn't offered. Choose External, add your own email as a test user, then click Publish app so it says In production. If you leave it in Testing, Google signs the app out every 7 days.
Step 4: Add the scopes
- In the app, click Copy all scopes.
- In Google Cloud, open Google Auth Platform → Data access → Add or remove scopes.
- Paste them under Manually add scopes, click Add to table, then Update, then Save.
The app only gets the access in this list:
- Read the orders buyers email you
- Write reply drafts in the buyer's email thread
- Send the emails you approve: replies, reminders, statements
- Save documents and use the sheets you choose (only files the app makes or you pick, never the rest of your Drive)
- Know which Google account is connected
Step 5: Create the sign-in client
- Open Google Auth Platform → Clients → Create client.
- For Application type, choose Web application.
- In the app, copy the Redirect URI. In Google Cloud, paste it under Authorized redirect URIs, then click Create.
- Copy the Client ID and Client secret Google shows. You paste them in step 7.
Step 6: Create a key for choosing Drive files
- Open APIs & Services → Credentials → Create credentials → API key.
- Edit the key: under API restrictions choose Restrict key, tick Google Picker API, and click Save. Copy the key (it starts with AIza).
- Find your project number on the project's Dashboard (or IAM & Admin → Settings). It's numbers only, not the project ID.
Step 7: Paste them in the app and sign in
- On Integrations → Google Workspace, click Connect.
- On Your Google app, paste the Client ID, Client secret, API key and Project number. Click Continue.
- On Sign in, click Sign in with Gmail (Google Workspace). A small window opens. Sign in with your orders account and tick every box Google shows (Gmail and Drive). You come straight back.
- On Replies, choose how your agent answers buyers: Off, Draft or Auto-reply. See How your agent answers buyers by email.
- Optional: under Folder or label, enter a Gmail label to read only mail with that label. Leave it empty to read the whole inbox.
- Click Save.
Your agent checks for new mail every two minutes. The page then shows the Account it's reading, Last checked, how Replies go out, and what it Reads.
Mail your agent leaves alone
Click Settings on the connected card to choose:
- Skip no-reply senders (noreply@, mailer-daemon and similar).
- Skip newsletters and bulk mail. Out-of-office replies and Shopify's own notifications are always ignored.
- Never read mail from: one address or domain per line, such as
@supplier.com.
Good to know
- Forwarding keeps working whether or not you connect a mailbox.
- Without a connected mailbox, your agent never emails your buyers from Gmail. Emails to buyers can also go through an email service instead: see Send emails to buyers from your own address.
- Drive and Sheets options appear on this page once you're connected. See Save to Google Drive and Sheets.
- Need help? Click Need help? We'll set it up with you on the page.
Reconnect or disconnect
- If Google stops accepting the sign-in, the page says Sign in again. Click it and sign in.
- To stop, click Disconnect and confirm. Your agent stops reading this mailbox and can no longer answer buyers by email. Orders forwarded to your agent's own address still arrive.
If something goes wrong
- "The sign-in didn't work." Check the Client ID and secret, and that the redirect URI in Google Cloud matches the one in the app exactly.
- Signed out every 7 days (@gmail.com). Your app is still in Testing. In Google Auth Platform → Audience, click Publish app.
- Your browser blocked the sign-in window. Allow pop-ups for the page, then try again.
- More fixes in Email and Google Workspace problems.