> ## 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.

# Tích hợp Google Chat

> Cài đặt CloudThinker trong Google Chat, ánh xạ từng space với một workspace, và đặt câu hỏi, phê duyệt hành động, nhận cảnh báo ngay trong chat.

Thêm CloudThinker vào Google Chat để nhóm của bạn có thể đặt câu hỏi, phê duyệt hành động và nhận cập nhật sự cố mà không cần mở ứng dụng web. Mỗi space hoặc tin nhắn trực tiếp trong Google Chat được ánh xạ với một workspace CloudThinker, là project chứa các kết nối và cuộc hội thoại của bạn.

> [!NOTE]
>
> Google Chat là một tích hợp, không phải [kết nối](https://docs.cloudthinker.io/vi/guide/connections/overview.md): thêm CloudThinker không cấp cho CloudThinker quyền truy cập Gmail, Drive hay dữ liệu Google Workspace khác.

## Điều kiện tiên quyết

* Một [gói hỗ trợ nhắn tin](https://docs.cloudthinker.io/vi/guide/billing/pricing.md#tính-năng-ai-theo-gói): Team, Scale, Scale Plus hoặc Enterprise.
* Một quản trị viên Google Workspace có thể cài đặt ứng dụng trong Google Admin console. Họ chỉ cần làm việc này một lần cho tổ chức của bạn.
* **Vai trò tổ chức:** Owner hoặc Admin của tổ chức để ánh xạ các space dùng chung. Xem [vai trò](https://docs.cloudthinker.io/vi/guide/security/roles.md).
* **Vai trò workspace:** **Developer** hoặc **Admin** để ánh xạ tin nhắn trực tiếp của chính bạn hoặc đặt câu hỏi. **Viewer** không thể chạy chat. Xem [người dùng workspace](https://docs.cloudthinker.io/vi/guide/workspace-users.md).

## Cài đặt CloudThinker

**1. Mở trang thiết lập**

Đăng nhập CloudThinker với tư cách Owner hoặc Admin của tổ chức. Vào **Admin Settings → Integrations → Google Chat**.

Trang này hướng dẫn qua ba bước: **Install CloudThinker**, **Add CloudThinker to a space**, và chọn space nhận thông báo cho từng workspace.

**2. Bật Chat apps trong Google Admin**

Quản trị viên Google Workspace của bạn vào **Apps → Google Workspace → Google Chat → Chat apps** trong Google Admin console và đặt **Allow users to install Chat apps** thành **On**. Trang thiết lập liên kết thẳng đến màn hình này qua **Open Google Chat settings**.

**3. Cài đặt CloudThinker cho tổ chức**

Trong Google Admin console, vào **Apps → Google Workspace Marketplace apps → Apps list** (hoặc nhấn **Open the Apps list** trên trang thiết lập), tìm **CloudThinker** và cài đặt. Cài cho mọi người, hoặc giới hạn trong các đơn vị tổ chức hoặc nhóm cần dùng.

**Trạng thái thành công:** CloudThinker xuất hiện khi mọi người tìm ứng dụng trong Google Chat.

## Ánh xạ một space với một workspace

Làm việc này một lần cho mỗi space dùng chung, và một lần cho mỗi người muốn nhắn tin trực tiếp với CloudThinker. Với space dùng chung, Owner hoặc Admin của tổ chức nên là người thêm và mention CloudThinker, vì chỉ họ mới mở được liên kết cấu hình cho một space chưa được ánh xạ.

**1. Thêm CloudThinker trong Google Chat**

Thêm CloudThinker vào một space dùng chung, hoặc bắt đầu nhắn tin trực tiếp với CloudThinker.

Nếu CloudThinker đã có trong tin nhắn trực tiếp của bạn, hãy gỡ ra rồi thêm lại. Google chỉ gửi sự kiện thiết lập khi thêm mới.

**2. Mở liên kết cấu hình**

CloudThinker trả lời bằng một liên kết cấu hình cá nhân. Trong space dùng chung, Google chỉ hiển thị liên kết cho bạn, nên các thành viên khác không bao giờ thấy. Liên kết hết hạn sau 15 phút và phải được mở bằng tài khoản Google đã nhắn tin cho CloudThinker.

**3. Chọn workspace và xác nhận tài khoản Google**

Chọn workspace CloudThinker mà space này sẽ dùng ở **Workspace**. Sau đó nhấn **Continue with Google** và chọn cùng tài khoản Google đó.

**Trạng thái thành công:** trang hiển thị **Google Chat is ready**. Quay lại **Admin Settings → Integrations → Google Chat**, space xuất hiện trong **Mapped spaces**.

**4. Gửi yêu cầu đầu tiên**

Quay lại Google Chat và mention CloudThinker lần nữa kèm một câu hỏi:

```text theme={null}
@CloudThinker Why did our AWS bill go up this week?
```

**Trạng thái thành công:** CloudThinker trả lời trong cùng thread, dùng các kết nối của workspace đã ánh xạ.

## Làm việc với CloudThinker trong chat

Viết yêu cầu bằng ngôn ngữ thường. Nêu tên kết nối hoặc mô tả dạng đầu ra bằng lời khi cần. Xem [Commands và cú pháp prompt](https://docs.cloudthinker.io/vi/guide/commands.md) để biết cú pháp đầy đủ.

```text theme={null}
@CloudThinker Investigate the latest high-severity incident
@CloudThinker Summarize the open findings for production
@CloudThinker Compare this month's EC2 spend with last month as a dashboard
```

* **Mention:** trong space dùng chung, mention `@CloudThinker` để Google chuyển tin nhắn đến CloudThinker. Trong tin nhắn trực tiếp, chỉ cần nhập yêu cầu.
* **Thread:** trả lời trong cùng thread để tiếp tục cuộc hội thoại. Tin nhắn mới ở cấp cao nhất (ngoài thread) sẽ bắt đầu cuộc hội thoại mới.
* **Lượt chạy dài:** CloudThinker đăng tin nhắn **Working…** trong thread, cập nhật tin nhắn này theo bước hiện tại, rồi đăng câu trả lời trong cùng thread. Nếu người khác gửi tin nhắn trong khi một lượt chạy đang diễn ra, CloudThinker đưa tin nhắn đó vào hàng đợi và chạy dưới danh nghĩa người gửi khi lượt chạy hiện tại kết thúc. Chỉ những tin nhắn vượt qua [các kiểm tra bên dưới](#ai-có-thể-hỏi-và-phê-duyệt-từ-chat) mới được đưa vào hàng đợi, và CloudThinker kiểm tra lại vai trò trước khi bắt đầu: người gửi đã mất quyền truy cập sẽ nhận **Your linked CloudThinker account cannot run agents in this Workspace.**
* **Tệp:** tải lên tối đa 5 tệp vào tin nhắn Google Chat, tổng cộng 20 MB. Ảnh quá lớn sẽ được thu nhỏ; các tệp quá lớn khác bị từ chối kèm một câu trả lời. Các loại được hỗ trợ bao gồm PDF, Word, văn bản và Markdown, CSV và Excel, PowerPoint, JSON và YAML, các định dạng ảnh phổ biến và tệp mã nguồn. CloudThinker không đọc tệp Google Drive, vì thêm CloudThinker không cấp quyền truy cập Drive: hãy tải lên một bản sao hoặc dán phần CloudThinker cần đọc.
* **Phê duyệt:** khi một hành động cần được duyệt theo [quy tắc phê duyệt](https://docs.cloudthinker.io/vi/guide/approvals/overview.md) của bạn, CloudThinker đăng thẻ **CloudThinker needs your approval** với **Approve**, **Approve with reason** (mở hộp thoại để nhập ghi chú) và **Reject**. Dùng **Open in CloudThinker** để xem đầy đủ ngữ cảnh trước.

### Ai có thể hỏi và phê duyệt từ chat

Chỉ là thành viên của space thì chưa đủ. Mỗi tin nhắn được kiểm tra với tài khoản CloudThinker đã liên kết của người gửi trước khi CloudThinker chạy nó:

| Người gửi | Kết quả |
| - | - |
| Tài khoản Google chưa liên kết với CloudThinker | CloudThinker gửi riêng một liên kết: **Link your CloudThinker account to continue**. Câu hỏi không được chạy |
| Đã liên kết, nhưng không phải thành viên của workspace, hoặc là **Viewer** | Trả lời trong thread: **Your linked CloudThinker account cannot run agents in this Workspace.** |
| **Developer** hoặc **Admin** đã liên kết | Câu hỏi chạy dưới danh nghĩa người dùng đó, với quyền truy cập của người dùng đó |

Mỗi lần nhấn phê duyệt đều qua cùng các kiểm tra người phê duyệt như trên ứng dụng web:

| Người nhấn | Kết quả |
| - | - |
| Tài khoản Google chưa liên kết với CloudThinker | CloudThinker gửi riêng một liên kết: **Link your CloudThinker account to continue** |
| Đã liên kết, nhưng không thể chạy agent trong workspace này | Trả lời riêng: **Your linked CloudThinker account cannot run agents in this Workspace.** |
| Đã liên kết, nhưng không phải người phê duyệt được chỉ định (hoặc không thuộc nhóm người phê duyệt) | Vẫn có thể **Reject**. **Approve** nhận câu trả lời riêng nêu tên người có thể phê duyệt |
| Đã bắt đầu lượt chạy cần phê duyệt | Khi [quy tắc hai người](https://docs.cloudthinker.io/vi/guide/approvals/approvers.md#yêu-cầu-người-thứ-hai) bật, một người phê duyệt khác phải phê duyệt. Họ vẫn có thể từ chối |
| Người phê duyệt được phép | Quyết định được áp dụng và thẻ cập nhật để hiển thị quyết định |

Nếu yêu cầu phê duyệt đã được quyết định, trong chat hoặc trên ứng dụng web, người nhấn sẽ thấy **This approval was already decided.**

## Bảo mật và quyền

| Câu hỏi | Trả lời |
| - | - |
| Scope Google API | `chat.bot` để nhận mention và đăng câu trả lời, thẻ. `chat.app.messages.readonly` cho phép CloudThinker đọc các tin nhắn trước đó trong một thread. Quản trị viên Google Workspace phải phê duyệt scope này trong Google Admin console. Cho đến lúc đó, CloudThinker thông báo rằng quản trị viên Google Workspace phải phê duyệt quyền đọc tin nhắn cho CloudThinker |
| Đăng nhập Google | **Continue with Google** chỉ xác nhận bạn dùng tài khoản Google nào. Bước này không yêu cầu quyền truy cập Gmail, Drive hay Calendar |
| Ánh xạ danh tính | Mỗi tài khoản Google liên kết với một người dùng CloudThinker trên mỗi tổ chức. Mọi tin nhắn và lần nhấn đều chạy dưới danh nghĩa người dùng đó, với vai trò workspace của người dùng đó |
| CloudThinker lưu gì | Các tin nhắn bạn gửi cho CloudThinker và câu trả lời của CloudThinker, được lưu thành cuộc hội thoại trong workspace đã ánh xạ, cùng các tệp bạn tải lên trong những tin nhắn đó. Trong space dùng chung, Google chỉ gửi cho CloudThinker các tin nhắn có mention CloudThinker; khi scope đọc tin nhắn đã được phê duyệt, CloudThinker còn đọc được các tin nhắn trước đó trong chính thread của mình |
| Phê duyệt | Lần nhấn trong chat đi qua cùng luồng phê duyệt như ứng dụng web, nên quyết định hiển thị trên cuộc hội thoại trong CloudThinker |

## Gửi thông báo đến một space

Một space dùng chung đã ánh xạ có thể nhận thông báo của workspace, chẳng hạn cập nhật sự cố, yêu cầu phê duyệt và kết quả Review. Mỗi workspace có thiết lập riêng, nên hãy chuyển sang đúng workspace bằng bộ chuyển workspace ở đầu thanh bên trước.

**1. Mở Notifications**

Vào **More → Workspace settings → Notifications**.

**2. Chọn space**

Trên thẻ **Google Chat**, nhấn **Pick a space**, rồi tìm và chọn một space dùng chung đã ánh xạ với workspace này. Bạn cũng có thể đặt từ **Admin Settings → Integrations → Google Chat** bằng **Make notification default** trên dòng của space.

**3. Bật các sự kiện**

Ở **What to notify me about**, bật ô Google Chat cho từng sự kiện mà space cần nhận. Xem [Notifications](https://docs.cloudthinker.io/vi/guide/notifications.md) để biết danh sách đầy đủ.

**Trạng thái thành công:** thẻ **Google Chat** hiển thị tên space, và sự kiện khớp tiếp theo được đăng trong space đó.

Tin nhắn trực tiếp không bao giờ nhận thông báo, nên không xuất hiện trong danh sách đích nhận. Nếu thẻ hiển thị **No Google Chat space is mapped to this Workspace yet**, hãy ánh xạ một space dùng chung với workspace này trước.

## Quản lý các space đã ánh xạ

Vào **Admin Settings → Integrations → Google Chat** để xem mọi space đã ánh xạ và workspace mà từng space sử dụng.

Mở menu hành động (**...**) trên dòng của một space:

| Hành động | Kết quả |
| - | - |
| **Make notification default** | Space trở thành đích thông báo mặc định cho workspace tương ứng. Dòng hiển thị huy hiệu **Notification default** |
| **Change Workspace** | Chuyển space sang một workspace khác trong cùng tổ chức. Tin nhắn mới bắt đầu cuộc hội thoại mới ở đó; các cuộc hội thoại trước vẫn ở workspace ban đầu |
| **Remove** | Dừng CloudThinker hoạt động trong space. Bot vẫn ở trong space, và một mention sẽ nhận **Google Chat is disconnected from this Workspace.** Các cuộc hội thoại trước vẫn ở trong workspace. Để ánh xạ lại space, hãy gỡ CloudThinker khỏi space trong Google Chat rồi thêm lại |

Để ngừng dùng tích hợp cho toàn bộ tổ chức, nhấn **Disconnect Google Chat** ở cuối trang.

Chỉ Owner và Admin của tổ chức mới có thể thay đổi ánh xạ hoặc ngắt kết nối.

## Khắc phục sự cố

> **CloudThinker không gửi liên kết cấu hình**
>
> Mention CloudThinker lần nữa trong cùng cuộc hội thoại. Trong tin nhắn trực tiếp mà CloudThinker đã được thêm từ trước, hãy gỡ ra rồi thêm lại để Google gửi sự kiện thiết lập mới.

> **This Google Chat link expired or is invalid**
>
> Liên kết đã hết hạn hoặc được mở bằng một tài khoản Google khác (xem [bước 2](#ánh-xạ-một-space-với-một-workspace)). Mention CloudThinker lần nữa để nhận liên kết mới.

> **An organization Admin must connect this space**
>
> Chỉ Owner hoặc Admin của tổ chức mới có thể ánh xạ space dùng chung. Hãy nhờ một người trong số họ mention CloudThinker trong cùng space và mở liên kết mới.

> **You cannot run CloudThinker in this Workspace**
>
> Bạn không phải thành viên của workspace đó, hoặc vai trò của bạn là **Viewer**, không thể chạy chat. Hãy xin Admin của workspace vai trò **Developer**. Sau đó mention CloudThinker lần nữa để nhận liên kết mới.

> **Google Chat requires a Team plan**
>
> Tổ chức của bạn đang dùng gói Free. Hãy nhờ Owner của tổ chức [nâng cấp](https://docs.cloudthinker.io/vi/guide/billing/subscription.md), rồi mở lại liên kết.

> **Google Sign-In did not load**
>
> Trình duyệt hoặc một tiện ích mở rộng đã chặn `accounts.google.com`. Cho phép địa chỉ này trên trang CloudThinker, rồi tải lại trang.

> **A Google Chat space needs to be reconnected**
>
> Google Chat đã từ chối tin nhắn của CloudThinker đến space đó, nên CloudThinker ngừng gửi đến đó. Trong Google Chat, hãy gỡ CloudThinker khỏi space rồi thêm lại.

## Bước tiếp theo

> **[Notifications](https://docs.cloudthinker.io/vi/guide/notifications.md)**
>
> Chọn những cập nhật mà từng space dùng chung nhận được

> **[Commands và cú pháp prompt](https://docs.cloudthinker.io/vi/guide/commands.md)**
>
> Viết yêu cầu nêu tên kết nối hoặc chạy một skill

> **[Approvals](https://docs.cloudthinker.io/vi/guide/approvals/overview.md)**
>
> Quyết định hành động nào cần con người duyệt trước khi chạy

> **[Tích hợp Slack](https://docs.cloudthinker.io/vi/guide/slack-integration.md)**
>
> Thiết lập CloudThinker trong một công cụ chat khác


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