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

# Google Chat Integration

> Connect Anna to Google Chat, map spaces to CloudThinker workspaces, and deliver agent conversations and notifications.

Use Google Chat to work with Anna in direct messages or shared spaces and receive configured workspace notifications.

<Note>
  Google Chat is an integration, not a connection, and adding Anna does not grant CloudThinker access to other Google Workspace data.
</Note>

## Prerequisites

* A CloudThinker Team plan.
* A Google Workspace administrator who can install Anna for your organization.
* The Google account that sent the message to Anna.

An organization Owner or Admin must map a shared space. A workspace member with chat access can map their own direct message. Direct messages cannot receive workspace notifications.

## Setup

<Steps>
  <Step title="Review the installation guidance">
    Sign in as a CloudThinker organization Owner or Admin. Go to [**Admin Settings → Integrations → Google Chat**](https://app.cloudthinker.io/admin-settings/integrations/google-chat).

    A Google Workspace administrator installs Anna once for your organization. Google publishes no universal installation link.
  </Step>

  <Step title="Add Anna in Google Chat">
    Open Google Chat, then start a direct message with Anna or add Anna to a shared space.

    If Anna already appears in an existing direct message, remove Anna and add Anna again. Google sends the setup event only after a fresh add.
  </Step>

  <Step title="Open your configuration link">
    Anna replies with a personal configuration link. Open it within 15 minutes.

    An organization Owner or Admin must open the link for an unmapped shared space. A member with chat access can configure their own direct message.
  </Step>

  <Step title="Choose a workspace and verify your identity">
    Select the CloudThinker workspace when prompted. Continue with the same Google account that messaged Anna.

    **Success state:** CloudThinker shows **Google Chat is ready**.
  </Step>

  <Step title="Test the conversation">
    Return to Google Chat and mention Anna again. Anna answers in the mapped workspace and continues the conversation in that thread.
  </Step>
</Steps>

## Ask Anna for work

Mention Anna to start work in a mapped direct message or shared space. Add a specialist alias and tool tag to route the request.

```text theme={null}
@Anna @alex #dashboard summarize this month's cloud costs
@Anna @oliver #report review our critical security findings
@Anna @kai investigate pod failures in production
```

Replies in the same Google Chat thread continue the same CloudThinker conversation. See [CloudThinker Language](/guide/language) for supported aliases and tool tags.

### Send files to Anna

Upload a file directly to the Google Chat message when Anna needs to inspect it. Google Drive attachments are not downloaded because adding Anna does not grant Drive access.

Anna cannot upload generated files back to Google Chat.

## Configure notifications

Mapped shared spaces can receive workspace notifications, including incident updates. Configure the destination for each event in the [notification matrix](/guide/notifications).

Direct messages never appear as notification destinations. If a space is missing, confirm that it is a shared space mapped to the current workspace.

## Manage mapped spaces

Go to [**Admin Settings → Integrations → Google Chat**](https://app.cloudthinker.io/admin-settings/integrations/google-chat) to review every mapped space and its workspace.

An organization Owner or Admin can move a space to another workspace in the same organization. New messages start fresh conversations there; earlier conversations remain in the original workspace.

Disconnect Google Chat from the same page when the organization should stop using the integration.

## Troubleshooting

<Accordion title="Anna does not send a configuration link">
  Mention Anna again in the same Google Chat conversation. For an existing direct message, remove Anna and add Anna again so Google sends a fresh setup event.
</Accordion>

<Accordion title="The configuration link is invalid or unavailable">
  Each link works for 15 minutes. Mention Anna again to create a new link, then open it with the same Google account that sent the message.
</Accordion>

<Accordion title="CloudThinker asks for an organization Admin">
  An organization Owner or Admin must map an unmapped shared space. Ask one to mention Anna in that space and open the new link.
</Accordion>

<Accordion title="CloudThinker says you cannot run Anna in this workspace">
  Ask a workspace administrator to grant you chat access. Then mention Anna again and use the new configuration link.
</Accordion>

<Accordion title="A Google Chat space is missing from notifications">
  Direct messages cannot receive notifications. Confirm that the destination is a shared space mapped to the current workspace, then select it in the notification matrix.
</Accordion>

## Related

<CardGroup cols={2}>
  <Card title="CloudThinker Language" icon="code" href="/guide/language">
    Use agent aliases and tool tags in Google Chat
  </Card>

  <Card title="Notifications" icon="bell" href="/guide/notifications">
    Choose which updates each shared space receives
  </Card>

  <Card title="DRE Integrations" icon="plug" href="/guide/incident/integrations">
    Send incident outcomes to operational platforms
  </Card>

  <Card title="Slack Integration" icon="slack" href="/guide/slack-integration">
    Set up another ChatOps message surface
  </Card>
</CardGroup>