Skip to main content

Gmail

Connect Gmail to BotDojo so agents can search, read, draft, and send email from a connected Google account.

Before You Start

You will need:

  • A Google account with Gmail access
  • Access to BotDojo's Integrations page
  • Permission to approve the Gmail OAuth scopes during connect

Connect Gmail in BotDojo

  1. Open Integrations in BotDojo.
  2. Find Gmail in the Agent Tools section.
  3. Click Connect.
  4. Sign in with your Google account and approve the requested Gmail permissions.
  5. Wait for BotDojo to finish the OAuth flow and save the integration.

Supported Actions

Gmail supports these agent actions:

  • Search messages
  • List messages
  • Get a message by ID
  • Send a message
  • Create a draft
  • Add labels to a message
  • Remove labels from a message
  • Create a label
  • Mark a message as read
  • Mark a message as unread
  • List labels

Troubleshooting

  • Connect fails: make sure you approved the Gmail scopes during OAuth.
  • Missing messages or labels: confirm the connected Google account is the one that owns the mailbox you want to use.
  • Send actions fail: check that the account has Gmail send permission and that the OAuth grant was completed again after any scope changes.