Add Google Chat to your AI agent
Google Chat API integration for messaging and collaboration in Google Workspace
- Things your agent can do in Google Chat
- 46
Things your AI can do in Google Chat
Your FormWise AI can handle any of these in Google Chat — on its own, without you needing to click a button.
Create Space
PopularCreates a named space in Google Chat. The calling user is automatically added as a member and space manager. For a group chat or direct message, use GOOGLE_CHAT_SET_UP_SPACE instead. Use this action when you need to create a discoverable named space for team collaboration or project discussions. For group conversations without a named space, use GOOGLE_CHAT_SET_UP_SPACE. Note: If you receive the error ALREADY_EXISTS when creating a space, try a different displayName. The displayName must be unique within the organization.
List Space Members
PopularLists a page of memberships in a Google Chat space, with optional role or member-type filters and options to include Google Groups or invited members. Use the returned nextPageToken to fetch subsequent pages.
List Messages
PopularLists non-system messages from one Google Chat space, with creation-time or thread filtering and a next-page token. It does not search message text or filter by sender; use GOOGLE_CHAT_SEARCH_MESSAGES for text search. Declared OAuth requirements include a Chat messages scope and directory.readonly.
List Spaces
PopularLists a page of Google Chat spaces the authenticated user belongs to, using the chat.spaces or chat.spaces.readonly OAuth scope. Group chats and direct messages are not listed until the first message is sent.
Search Messages
PopularSearches for messages across Google Chat spaces the caller has access to. Use this action to find messages by keyword, sender, space, attachment presence, or mentions, instead of paging through ListMessages for a single space. Excludes private messages, Chat app messages, messages from blocked users, and messages in muted spaces. Requires user authentication with one of the following core OAuth scopes: - https://www.googleapis.com/auth/chat.messages - https://www.googleapis.com/auth/chat.messages.readonly Some filters and FULL-view metadata require the additional scopes documented on their request fields. Display-name enrichment is best-effort and optional.
Complete Space Import
Completes the import process for an import-mode Google Chat space and makes it visible to users. Use this action at the end of a data migration into Google Workspace, after all messages and memberships have been imported into a space that was created with `importMode: true`. Requires user authentication with domain-wide delegation (service-account flow) and the `chat.import` OAuth scope. Cannot be called with regular user OAuth.
Create Custom Emoji
Creates a custom emoji in Google Chat for use within a Google Workspace organization. An administrator must enable custom emojis for the organization.
Create Space Member
Creates a membership for a user, Chat app, or Google Group in a space. When creating a membership, if the member has auto-accept turned off, they're invited and must accept the invitation before joining. Use this action when you need to add a new member to a Google Chat space. This can be used to invite individual users, add Chat apps, or add Google Groups to a space. If the member requires acceptance, they will receive an invitation. Note: `parent` must be the resource name of a space that already exists - this action does not create one. To start a new direct message with a user, use GOOGLE_CHAT_SET_UP_SPACE instead, which creates the DM space and adds the member in one call. Note: App authentication cannot add users external to the Workspace organization, add Google Groups, or add Chat apps to a space.
Create Message
Creates a message with text or cards in an existing Google Chat space, up to 32,000 bytes, or replies to a thread. Named-thread replies default to failing if the thread is missing; use GOOGLE_CHAT_SET_UP_SPACE to create a direct-message space first.
Create Reaction
Creates an emoji reaction on a Google Chat message. Use this action when you need to add an emoji reaction (like 👍, ❤️, or 🎉) to an existing message in a Google Chat space. Either emoji_unicode or emoji_custom_id is required, but not both. This action is useful for acknowledging messages, voting on ideas, expressing emotions in response to messages, or building interactive message features in Google Chat bots.
Create section
Creates a custom section in Google Chat for organizing conversations in the navigation panel. Use when you need to create a new custom section to organize spaces and direct messages in the user's Chat sidebar.
Delete Custom Emoji
Deletes a custom emoji from Google Chat. By default, users can only delete custom emojis they created. Emoji managers assigned by the administrator can delete any custom emoji in the organization. Use this action when you need to permanently remove a custom emoji that is no longer needed. This action is irreversible — once deleted, the custom emoji cannot be recovered.
Show 34 more things it can do
Delete Member from Space
Removes a user, Google Group, or app membership from a Google Chat space using its membership resource name. The request can use Google Workspace administrator privileges when authorized. A membership that is not found is reported as an error.
Delete Message
Deletes a message from a Google Chat space; with user authentication, the force option can also delete its threaded replies. Deletion is irreversible, and permitted actions depend on the caller's authentication and permissions.
Delete Reaction
Deletes a reaction to a message. Use when you need to remove a reaction that was previously added to a message. Users can only delete their own reactions. This action is irreversible — once the reaction is deleted, it cannot be recovered.
Delete section
Deletes a custom section from Google Chat by its ID. This action is irreversible — once a section is deleted, it cannot be recovered. If the section contains items (such as spaces), they are moved to Google Chat's default sections and are not deleted. Use when you need to remove a custom section that is no longer needed.
Delete space
Deletes a named space from Google Chat. Always performs a cascading delete, which means that the space's child resources like messages and memberships are also deleted. Use this action when you need to permanently remove a Google Chat space and all associated data. This action is irreversible — the space and all its messages and memberships cannot be recovered once deleted.
Download Media
Downloads the bytes of a Google Chat message attachment via the media API. Use this after `get_attachment` to fetch the actual file content for an attachment. The `resource_name` parameter is the `attachmentDataRef.resourceName` returned by `get_attachment`. Returns the downloaded file. The download endpoint adds `?alt=media` automatically, which is required by Google to return raw bytes rather than the JSON Media resource.
Find Direct Message
Returns the existing direct message space with the specified user. Use this action when you need to find an existing DM space with a particular user, such as when checking if a DM already exists before creating one or when you need the space resource name for subsequent operations. If no direct message space exists with the specified user, this action returns a NOT_FOUND (404) error. Note: This only finds existing DM spaces - it does not create a new one. To start a new DM (or safely get-or-create one), use the GOOGLE_CHAT_SET_UP_SPACE action instead.
Find Group Chats
Finds group chat spaces whose human memberships contain exactly the calling user and the specified users. Results are paginated.
Get Attachment
Gets the metadata of a Google Chat message attachment. Returns the attachment's content type, filename, source, and references that can be used to download the file via the media API. To fetch the binary bytes of the attachment, pass the returned `attachmentDataRef.resourceName` to the `download_media` action. Requires Chat app authentication (the `chat.bot` scope) — this endpoint is not callable with regular user OAuth.
Get Custom Emoji
Returns details about a custom emoji in Google Chat. Custom emojis are only available for Google Workspace accounts, and the administrator must turn custom emojis on for the organization. Use this action when you need to retrieve information about a specific custom emoji, such as its name, unique identifier, or temporary image URL. This is useful for displaying emoji details or verifying emoji existence before performing other operations. Note: The `payload` field is only populated when creating or updating custom emojis and is not returned when getting emoji details.
Get Chat Space Member
Returns details about a membership in a space. Use this action when you need to retrieve information about a specific member's relationship with a Google Chat space, including their role, state, and user details.
Get Message
Returns details about a specific message in a Google Chat space. Use this action when you need to retrieve the full content, sender information, thread details, and other metadata for a particular message. Requires user authentication with an appropriate Google Chat OAuth scope.
Get Space
Retrieves details of a specific Google Chat space, including its display name, description, membership count, threading state, and available configuration. Administrator access can be requested when authorized; some response fields depend on the scopes used.
Get Space Event
Returns an event from a Google Chat space. The event payload contains the most recent version of the resource that changed. Use this action when you need to retrieve details about a specific space event, such as a new message, membership change, reaction, or space update. If the resource was modified after the event occurred, the server returns the updated resource in the event payload. Note: The `permissionSettings` field is not returned in the Space object of the Space event.
Get Space Notification Setting
Gets the notification settings for a user in a specific space. Use when you need to retrieve the caller's space notification setting, including whether notifications are muted and what type of notifications are enabled. Requires user authentication with the `https://www.googleapis.com/auth/chat.users.spacesettings` OAuth scope.
Get space read state
Returns details about a user's read state within a space. Use this action when you need to identify which messages in a space have been read or unread by the user.
Get thread read state
Returns details about a user's read state within a thread. Use this action when you need to identify which messages in a specific thread have been read or unread by the user.
List custom emojis
Lists custom emojis visible to the authenticated user in Google Chat. Use this action when you need to retrieve all custom emojis available in Google Chat for the authenticated user. This is useful for displaying available emojis, filtering by creator, or enumerating organization-specific custom emojis. Supports pagination via pageSize and pageToken parameters. By default, returns up to 25 emojis.
List reactions on a message
Lists a page of emoji reactions on a specific Google Chat message. Results can be filtered by emoji type or user, and a page token can be used to retrieve subsequent pages.
List Section Items
Lists all items (such as spaces) within a specified section of a user's Google Chat. Use when you need to retrieve all items grouped under a section in Google Chat, or when implementing pagination to fetch all items across multiple pages. Sections can be system sections like 'default-spaces' or custom sections created by the user. Requires user authentication with the `https://www.googleapis.com/auth/chat.users.sections.readonly` (read-only) or `https://www.googleapis.com/auth/chat.users.sections` (full access) OAuth scope.
List Sections
Lists all sections available to the authenticated user in Google Chat. Use this action when you need to retrieve all sections for organizing conversations in the navigation panel. Sections include custom sections created by the user and system sections like default direct messages, default spaces, and default apps. Requires user authentication with one of the following OAuth scopes: - https://www.googleapis.com/auth/chat.users.sections - https://www.googleapis.com/auth/chat.users.sections.readonly
List Space Events
Lists events from a Google Chat space. Use when you need to retrieve historical events such as new messages, membership changes, or reactions from a specific Google Chat space. The filter parameter is required and must specify event type filters. Note: This action requires specifying event type filters in the filter parameter. Supported event types include message events (created, updated, deleted), membership events (created, updated, deleted), and reaction events.
Move Section Item
Moves a space from one section to another in Google Chat. Use when organizing spaces into different sections, such as moving a space from the default-spaces section to a custom user-created section. The action updates the section membership of the specified space item.
Position Section in Sidebar
Changes the sort order of a section in the Google Chat sidebar. Use when you need to reorder sections in the sidebar. Either sortOrder (absolute position) or relativePosition (START/END) must be provided to specify the new position.
Replace Message (Full)
Updates a Google Chat message using a field mask, with support for text, cards, attachments, and other supplied properties. It can request creation of a missing message using a client-assigned ID.
Search Spaces
Searches Google Chat spaces using filters such as display name, customer, creation time, activity, history state, and space type. Searches can use administrator access across a Workspace organization or user access to spaces the caller belongs to.
Setup Space
Creates a Google Chat named space, group chat, human DM, or calling-app DM and can add initial members. The caller is added automatically. Named spaces require displayName. Group chats require at least two memberships. Human DMs require exactly one HUMAN membership. For a calling-app DM, set singleUserBotDm to true and omit memberships. An existing human DM is returned. Google groups can only join named spaces. This is the only action that creates DIRECT_MESSAGE or GROUP_CHAT spaces; CREATE_SPACE, CREATE_MESSAGE, and CREATE_MEMBER require an existing space. Requires user authentication with one of the following OAuth scopes: - https://www.googleapis.com/auth/chat.spaces - https://www.googleapis.com/auth/chat.spaces.create
Update Member
Updates a user's membership role in a Google Chat space, such as changing between member and manager.
Update Message
Updates a Google Chat message's text, cards, or other supported properties using an update mask. With allowMissing enabled, it can create a message when the specified message is missing; permitted updates depend on authentication and permissions.
Update section
Updates a section's display name in Google Chat. This action uses patch semantics for partial updates. Use when you need to rename an existing custom section in Google Chat. Only sections of type 'CUSTOM_SECTION' can be updated. System sections (like 'default-direct-messages', 'default-spaces', 'default-apps') cannot have their display names modified. Requires user authentication with the 'https://www.googleapis.com/auth/chat.users.sections' scope.
Update Space
Updates an existing Google Chat space's display name, description, guidelines, history state, or predefined permission settings using an update mask. It can request administrator access when authorized.
Update Space Notification Setting
Updates the notification settings for a user in a space. Use when you need to modify how a user receives notifications in a specific space, such as muting a noisy channel or changing the notification level to only important messages. Requires user authentication with the chat.users.spacesettings scope.
Update Space Read State
Updates a user's read state within a space, used to mark messages as read or unread. Use this action when you need to programmatically mark a Google Chat space as read or update the user's read position in a space. Note: To mark a space as unread, set lastReadTime to a value earlier than the latest message timestamp. To mark as read, set it to any value later than the latest message.
Upload Media Attachment
Uploads a file of up to 200 MB as an attachment to a Google Chat space using the multipart media upload endpoint; the returned attachment upload token can be used in a subsequent message. Requires user authentication and either the chat.messages or chat.messages.create scope.
Built for the way you actually work
No code, no engineers
Connect in a few clicks and start using your AI right away. If you can use the apps you already love, you can do this.
Sounds like you, not like a bot
Train your AI on your offer, your voice, and the way you actually talk to clients — it picks up where you leave off.
Plugs into the stack you already use
No need to rip out your CRM, your scheduler, or your email tool. Your AI works inside the apps running your business today.
Your data stays yours
Client conversations, lists, and credentials are scoped to your workspace. Nothing gets shared, sold, or used to train anyone else’s AI.
What you can do once Google Chat is connected
Onboard new clients without lifting a finger
When someone signs up, your AI greets them, sets up their next step in Google Chat, and keeps the momentum going — even at 2am.
Reply to leads in seconds, not days
Your AI watches Google Chat for new inquiries, answers questions in your voice, and books the call before they cool off.
Get your weekends back
Hand off the repetitive Google Chat work — follow-ups, reminders, updates, simple admin — and stop being the bottleneck in your own business.
How to connect Google Chat to your agent
- 1
Start using FormWise for free
Sign up in under a minute.
- 2
Find Google Chat in your connected apps
Inside FormWise, open Connectors and look for Google Chat.
- 3
Hit "Connect"
Click "Connect Google Chat" and log in like you normally would. We only ask for the permissions your AI actually needs.
- 4
Tell your AI what to do in Google Chat
Build a quick AI Agent (it's like writing instructions, not code), and pick the Google Chat actions you want your AI to handle.
- 5
Watch it run
Send it a real-world task and watch your AI take care of Google Chat for you. Tweak the wording until it feels just right.
Powered by the AI you already trust
Your Google Chat workflow runs on the same world-class AI used by ChatGPT, Claude, and Gemini. We handle the technical part — you just tell your AI what to do, in plain English.
- OpenAI
- Anthropic Claude
- Google Gemini
Questions other Google Chat users had before signing up
Do I need to know how to code?
Not even a little. If you can use Google Chat today, you can set this up. You'll connect Google Chat, tell your AI what it should help with, and you're live. The whole thing is built for coaches, course creators, agencies, and operators — not engineers.
Will my clients know they're talking to an AI?
Only if you want them to. Your FormWise AI is trained on your voice, your offer, and the way you actually communicate — so it sounds like a thoughtful team member, not a clunky chatbot. Most people can't tell.
Can I make it sound like me?
Yes. You can give your AI examples of how you write, the questions you usually ask new clients, the way you handle objections, and the language you use about your offer. The more you give it, the more it sounds like you wrote it.
What if I want to take over a conversation?
You're always in control. You can step in at any point, take over from your AI, or stop it from sending messages until you've reviewed them. Think of it as a teammate, not a replacement.
Is my client data safe?
Yes. Your Google Chat login and client information stay scoped to your workspace. We don't sell it, we don't share it, and we don't use your data to train anyone else's AI. You can disconnect Google Chat or delete everything any time.
What happens when Google Chat updates their app?
We handle it. When Google Chat adds new features or changes how something works, we update the integration in the background. You don't have to do anything — your AI just keeps working.
How fast can I actually get this running?
Most people are up and running the same day they sign up. Connecting Google Chat takes a few minutes. Teaching your AI to handle the work the way you'd want it done is the part worth slowing down for.
What is FormWise?
FormWise is the AI agent builder for coaches, course creators, and agencies. You connect the apps you already use — like Google Chat — train your AI on your offer and voice, and let it handle the work you've been doing manually: onboarding, follow-ups, support, admin. No code, no developers, no engineering team required.
Can I sell AI agents to my clients?
Yes. A lot of FormWise users build AI assistants and sell them as part of their offer — done-for-you AI setups, white-label assistants for client businesses, custom GPTs trained on a client's brand. You can charge a setup fee, a monthly retainer, or both.
Can I embed my AI on my website or in my course?
Yes. Every AI you build in FormWise can be embedded on your site, dropped into your course platform, or shared as a standalone link. Your clients and students just open it like any other web page — no app to download, no login hoops.
Do I need to know anything about AI to use this?
No. If you can describe what you want your AI to do in plain English — "greet new clients, ask these 3 questions, book them a call" — FormWise can build it. We handle the models, the prompts, the connections. You handle the part you already know: what your business actually needs.
About Google Chat on FormWise
Google Chat API integration for messaging and collaboration in Google Workspace
Connect Google Chat once and your FormWise AI gets 46 things it can do inside it. That means your AI can handle the Google Chat work in your business — the messages, the updates, the follow-ups, the admin — the way you would, just faster and around the clock.
You don't need to know how any of it works under the hood. We take care of keeping the connection alive, retrying if something fails, and making sure your data only ever moves where you tell it to.
New to Google Chat? Take a look at chat.google.com.
More Productivity integrations
Ambiguous MCP
Operate an Ambiguous workspace through its provider-hosted MCP server, including documents, spreadsheets, tasks, CRM, calendar, mail, chat, and administration. Uses the connected account’s workspace-scoped API key. Some tools send external messages, delete data, change access, or consume the workspace action allowance.
Lark
Enterprise collaboration platform with messaging, video conferencing, calendar, and document management
Procore Resource Management
Manage Procore equipment, materials, resource planning, and telematics data.
Procore Field Operations
Manage Procore field productivity, daily logs, schedules, and scheduling workflows.
Phrase
Phrase Strings provides APIs for software localization projects, locales, keys, translations, files, jobs, and automation.
Teamleader Focus
Teamleader Focus is a work management platform that combines CRM, project management, and invoicing for small businesses and freelancers.
Stop doing the Google Chat work yourself
Hand it off to an AI assistant that sounds like you, works around the clock, and never forgets a follow-up. Free to start.
