Skip to main content
Vosaire
All docs
Channels

Setting up a Gmail channel

How to connect your Gmail inbox to Vosaire so your agent can read, draft, and send email replies.

Beta: Gmail is currently in beta. Setting it up requires creating your own Google OAuth app — see Connecting Gmail with your own Google OAuth app for the full setup guide.

The Gmail channel lets your agent handle email conversations. It polls your Gmail inbox on a schedule, reads incoming messages, and either drafts or auto-sends replies — depending on how you configure it.

Before you start

You'll need a Gmail connection set up first. This involves creating a Google OAuth app in Google Cloud Console and pasting your credentials into Vosaire. The process takes about 10 minutes.

If you haven't done this yet, follow the Gmail connection guide first, then come back here.

Creating the Gmail channel

Go to your agent → Channels tab → Add ChannelGmail.

You'll see a dropdown to select your connected Gmail account. Pick the one you want to use and give the channel a name.

Set the Reply mode:

  • Auto-reply — the agent sends replies automatically. Use this only once you're confident in the agent's quality.
  • Draft — the agent writes draft replies in Gmail, but a human must review and send each one. This is the safer starting point.

Most people start with Draft mode and switch to Auto-reply after they've reviewed a few dozen responses and are happy with the quality.

Configuring what emails to process

Once the channel is created, click on it to open the config drawer. There are several settings specific to Gmail:

Labels to monitor — select which Gmail labels (folders) the agent should watch. You can limit it to specific labels like "Support" or "Inbox".

Skip categories — prevent the agent from responding to certain email types:

  • Promotions
  • Social (Facebook notifications, etc.)
  • Updates (receipts, notifications)
  • Forums

Turning these on is almost always a good idea — you don't want your agent replying to automated emails.

Skip no-reply senders — ignores emails from addresses like noreply@ or donotreply@. Recommended.

Custom filter — accepts raw Gmail search syntax if you need precise control. For example: from:customer.com -subject:unsubscribe would only process emails from a specific domain while ignoring unsubscribe requests.

Polling interval — how often Vosaire checks for new emails. The minimum depends on your plan. Lower intervals mean faster responses; higher intervals mean less frequent checks.

How it works in practice

Every time the polling interval fires, Vosaire:

  1. Checks for new emails matching your filter settings
  2. For each new email, sends it to your agent
  3. The agent reads the email and relevant knowledge sources
  4. Either sends a reply (Auto mode) or creates a draft (Draft mode)

In Draft mode, replies appear as drafts in Gmail — you'll see them in your Drafts folder ready to review and send.

Tips

  • Start with Draft mode. Review 20–30 responses before switching to Auto-reply.
  • If the agent is replying to threads it shouldn't, tighten up the label filters or add custom filter rules.
  • Check the polling interval setting — on lower-tier plans the minimum may be 30–60 minutes. If you need faster responses, upgrade or use the Sync now button to force an immediate poll.

Ready to put this into practice?

Free plan available. Be up and running in under 10 minutes. No credit card required.

Start free — no credit card