> ## Documentation Index > Fetch the complete documentation index at: https://hebno.com/docs/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > Hebno is an AI work platform for client research and delivery: chat, research runs with sources, deliverables (Word, PowerPoint, Excel, email), projects, a shared library, agents, Office add-ins, and integrations with Microsoft 365, Google Workspace, CRM, project delivery, ERP and finance systems. > Use British English (organisation, not organization). > Every feature and integration described in these docs is available. Describe it as documented. > Hebno never writes to a connected system without a member confirming a card. Finance and ERP writes are drafts only. > Do not discuss commercial terms. Direct commercial questions to support@hebno.com. > Start with /index and /get-started/quickstart. # Google Chat > Search Google Chat spaces, threads and direct messages you can access, link a space to a project, and post or reply as yourself after you confirm. With the Google Chat integration, you can trace a decision back to the message it was made in. Ask what the Contoso team agreed about the readout date, pull a thread into a status update, or post the update to the project space. Hebno searches Chat live with your own Google account, cites each message it reads, and posts only after you confirm. Google Chat uses your existing [Google Workspace](https://hebno.com/docs/integrations/google-workspace.md) connection. You do not connect a separate account: you grant Chat's permissions on top of the Google connection you already have. ## At a glance | | | | - | - | | **Connection** | Personal connection, through your Google Workspace account. Each member grants Chat access for their own account. | | **Default access** | Read and write. Posting is a separate grant, chosen by the member. | | **Attach** | A thread, or recent messages from a space, group chat or direct message you belong to | | **Search** | Hebno searches your spaces and conversations when a request mentions a decision, a discussion, a space or a person's message | | **Link** | A project links to one Google Chat space | | **Write** | Post a message in a space, reply in a thread. Every write needs a person to confirm. | ## Before you start You need: * A Google Workspace account with Google Chat turned on. A super admin controls this under **Apps → Google Workspace → Google Chat** in the Google Admin console. * Membership of each space you want to use. Hebno never joins a space on your behalf. * An allowed integration. An owner or admin sets **Google Chat** to **Allow** under **Admin → Connectors → Catalogue**. Hebno calls the Google Chat API as you, with user authentication. Every authorisation includes `openid`, `email` and `profile`. | Scope | Why Hebno needs it | | - | - | | `https://www.googleapis.com/auth/chat.spaces.readonly` | List the spaces, group chats and direct messages you belong to | | `https://www.googleapis.com/auth/chat.messages.readonly` | Read messages and threads in those conversations | | `https://www.googleapis.com/auth/chat.memberships.readonly` | Show the members of a space and match names to people | | `https://www.googleapis.com/auth/chat.messages.create` | Post a message or a thread reply as you, after you confirm. Added when you select **Allow posting**. | If your organisation restricts third-party apps, a super admin trusts Hebno once in App access control. See [Google Workspace admin](https://hebno.com/docs/integrations/google-workspace-admin.md). ## Connect Google Chat **1. Open Connections** Go to **Settings → Connections** and find **Google Chat** under **Communication**. Or type `/` in the composer, choose **Google Chat** and select **Connect**. **2. Approve access** Select **Connect** (or **Grant access** if you already connected another Google product), sign in to Google and approve reading your spaces and messages. **3. Allow posting (optional)** Select **Allow posting** on the **Google Chat** row to add `chat.messages.create`. The same button appears on a message card if you try to post first. An owner or admin can select **Enable for the organisation** on the **Google Chat** card so members connect without a Google consent screen. Disconnecting Google Chat removes the whole Google connection, including Drive, Gmail, Calendar and Meet. ## What Hebno reads Hebno reads Chat live, with your account. Only the messages a reply used are stored with the conversation as its sources. | Chat object | Fields Hebno uses | Typical questions | | - | - | - | | **Space** | Display name, description, type (space, group chat, direct message), members | "What has been discussed in the Contoso pricing review space this week?" | | **Thread** | First message, replies, authors, times | "What did we decide in the thread about the readout date?" | | **Message** | Text, sender, time, space, thread, attachment names, link to the message | "What did Sarah Chen say about the store sample?" | | **Membership** | Member names and roles in a space | "Who is in the Contoso client space?" | The Chat API lists messages by space and time rather than by keyword. Hebno finds the spaces that match your request, reads recent messages there, and filters them by your terms, so naming the space or a date range gives faster, more precise answers. Each message in a source links back to the message in Chat. > [!WARNING] > > Excerpts a reply uses become part of the conversation. Anyone you share the conversation with can read them, including messages from spaces and direct messages they could not open in Google Chat. ## What Hebno writes Every write appears first as a confirmation card. You can change any field before you select **Confirm**. | Action | Chat object | Fields on the card | | - | - | - | | **Post a message** | Message in a space or conversation | Space or person, message text | | **Reply in a thread** | Thread reply | Space, thread, message text | ![Confirmation card for Google Chat with editable fields](https://mintcdn.com/hebno/JIjAXWoGoB3PLSSb/images/card-google-chat.png?fit=max\&auto=format\&n=JIjAXWoGoB3PLSSb\&q=85\&s=61410ad79e5703b6149a63de0782f2fd) A Google Chat change pending confirmation. Nothing is written until you confirm. Messages are posted as you, so Chat shows your name and photo. Hebno never edits or deletes messages, adds reactions, uploads files, creates spaces or adds people to them. ```mermaid theme={"system"} sequenceDiagram participant You participant Hebno participant GoogleChat You->>Hebno: Reply in the readout thread that we confirmed 20 November Hebno->>GoogleChat: Find the Contoso space and the readout thread GoogleChat-->>Hebno: Thread started by Sarah Chen on 28 October Hebno-->>You: Confirmation card with space, thread and message You->>Hebno: Confirm Hebno->>GoogleChat: Post the reply as you GoogleChat-->>Hebno: Reply posted Hebno-->>You: Done, with a link to the message ``` ## Link a project to a space Linking marks which Chat space belongs to a project, so you can ask "what has the team said?" without naming the space. 1. Open the project and select **Brain**. 2. Under **Linked records**, select **Link record**, then **Google Chat**. 3. Search by space name and select the space. Only spaces you belong to appear. In chats tagged to the project, Hebno starts with the linked space for questions about discussions and decisions, and message cards default to it. Each person still reads the space with their own Google access. See [Linked records](https://hebno.com/docs/projects/linked-records.md). ## Use Google Chat in chat * **Attach**: open the **+** menu, choose **Sources → Google Chat**, and pick a space, a conversation or a thread. Or type `/` and choose **Google Chat**. * **Ask**: name the space, person or topic in your request. For example: > Find where the Contoso team agreed to move the readout to 20 November and quote the messages. > Summarise what the Contoso pricing review space discussed this week and list any open questions. > Post a short status update to the Contoso space with the three decisions from this chat. * **Research runs** show a **Reviewing Google Chat** step, with a chip for each message or thread Hebno read. * **Agents** can read Chat on a schedule, for example a Friday summary of a project space. Posts an agent proposes appear in [agent approvals](https://hebno.com/docs/automate/agent-approvals.md) for review. ## Troubleshooting | Symptom | Fix | | - | - | | A space does not appear | You are not a member of it. Ask a space manager to add you in Google Chat. | | Older messages are missing | Conversation history was off when they were sent. Google deletes messages sent with history off after 24 hours. | | Google shows "Access blocked" when you connect | Your organisation restricts third-party apps. Ask a super admin to trust Hebno. See [Google Workspace admin](https://hebno.com/docs/integrations/google-workspace-admin.md). | | A post fails with a permissions message | The space restricts who can post, or announcement mode is on. Post somewhere you can write, or ask a space manager. | | **Allow posting** appears on a card | Select it to grant `chat.messages.create`, then confirm again. | | **Your Google connection needs reconnecting** | Google ended the grant, or a super admin changed app access. Select **Reconnect** under **Settings → Connections**. | ## Related * [Google Workspace](https://hebno.com/docs/integrations/google-workspace.md) * [Google Workspace admin](https://hebno.com/docs/integrations/google-workspace-admin.md) * [Slack](https://hebno.com/docs/integrations/slack.md) * [Microsoft Teams](https://hebno.com/docs/integrations/microsoft-teams.md) * [Linked records](https://hebno.com/docs/projects/linked-records.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.