> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atako.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Chat

> Connect Google Chat to your Atako agents — 6 read and 5 write actions.

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`

<Note>
  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](https://developers.google.com/workspace/chat/api/reference/rest).
</Note>

## 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](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.

***

*Last reviewed against the provider API: September 2026.*


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.