Google Chat

Let your agents read and post in Google Chat on your behalf — list spaces and direct messages, read and send messages, reply in threads, react, create spaces and add members. Requires a Google Workspace account.

Connection

Authentication: OAuth 2.0 — you authorize Atako via Google Chat’s consent screen; no key to copy.
Scopes requested:
- https://www.googleapis.com/auth/chat.spaces
- https://www.googleapis.com/auth/chat.messages
- https://www.googleapis.com/auth/chat.memberships

Nothing to paste: click Connect and sign in with your Google account. Prerequisites on the Atako side — Google Chat reuses the same Google OAuth app as the other Google connectors: an administrator sets INTEGRATION_OAUTH_GOOGLE_CHAT_CLIENT_ID / _CLIENT_SECRET and enables the Google Chat API in the Google Cloud console. Google Chat requires a Google Workspace account — a personal gmail.com account is not supported — and a Chat app configured in the console (Google Chat API → Configuration) if the app must post under its own name; with the user scopes requested here (chat.spaces, chat.messages, chat.memberships) the agent acts on behalf of the connected user.See Google Chat’s documentation.

Read actions (6)

Action	Description
`find_direct_message`	Find the existing 1:1 direct-message space between the connected user and another person. user_email: that person’s Workspace email (or their numeric Chat/People user id). Returns the DM space (use its id with send_message) — 404 when no DM exists yet.
`get_message`	Get one message: text, sender, createTime, thread. space_id (required). message_id (required): the part after “messages/” in the message name (a full “spaces/…/messages/…” name is accepted).
`get_space`	Get one space: display name, type (SPACE, GROUP_CHAT, DIRECT_MESSAGE), threading state, membership count, URL. space_id: the id after “spaces/” (a full “spaces/…” name is accepted).
`list_members`	List the members of a space (people and Chat apps) with their role. space_id (required). page_size (optional, default 100, max 1000). page_token (optional). filter (optional): by role or type, e.g. role = “ROLE_MANAGER” or member.type = “HUMAN”. With user auth, a member’s email and display name may be omitted — the member.name users/{id} is always returned.
`list_messages`	List messages in a space (oldest first by default). space_id (required). page_size (optional, default 25, max 1000). page_token (optional). order (optional): “DESC” for newest first (default “ASC”, by create_time). filter (optional): by date and/or thread, e.g. create_time > “2026-09-01T00:00:00+00:00” AND thread.name = spaces/AAAA/threads/BBBB. Each message has a name spaces/{space_id}/messages/{message_id} and a thread.name.
`list_spaces`	List the spaces, group chats and direct messages the connected user is a member of. page_size (optional, default 100, max 1000). page_token (optional): nextPageToken of a previous call. filter (optional): by space type, e.g. space_type = “SPACE” or spaceType = “GROUP_CHAT” OR spaceType = “DIRECT_MESSAGE”. Each space has a name spaces/{space_id} — pass the part after “spaces/” as space_id to the other actions.

Write actions (5)

Action	Description
`add_member`	Add a person to a named space or group chat (not a DM). space_id (required). user_email (required): the person’s Workspace email (or numeric user id). The connected user must be allowed to manage the space’s members.
`add_reaction`	React to a message with a Unicode emoji as the connected user. space_id (required). message_id (required). emoji (required): the emoji character itself, e.g. 👍 or ✅ (custom emojis not supported).
`create_space`	Create a named space (spaceType SPACE) with the connected user as its only member — add people with add_member. display_name (required, max 128 chars, must be unique in the Workspace organization — ALREADY_EXISTS otherwise). description (optional).
`send_message`	Post a text message as the connected user. space_id (required): a space, group chat or DM (see find_direct_message). text (required; the whole message is capped at 32,000 bytes; Google Chat text formatting is supported, and <users/{user_id}> mentions a person). To reply in an existing thread pass thread_name (the thread.name of a message, e.g. spaces/AAAA/threads/BBBB); to group messages under your own key pass thread_key. With either, the reply falls back to a new thread if the thread is not found. Cards and attachments are not supported.
`update_message`	Replace the text of a message the connected user posted (updateMask=text). space_id (required). message_id (required). text (required, 32,000 bytes max).

Permissions

Every action above must be explicitly granted to an agent before it can be used. See Permissions for the grant model and Security for how credentials are protected.

Last reviewed against the provider API: September 2026.

Using integrations

Communication

Scheduling

Project management

Docs & design

Files & storage

CRM & sales

Customer support

HR & recruiting

Commerce & billing

Developer tools

Observability & analytics

AI & media

Connection

Read actions (6)

Write actions (5)

Permissions

​Connection

​Read actions (6)

​Write actions (5)

​Permissions

Connection

Read actions (6)

Write actions (5)

Permissions