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

# HubSpot

> Kết nối HubSpot bằng OAuth để agent tìm kiếm contact, company, deal và ticket, và tóm tắt pipeline bán hàng của bạn

Kết nối HubSpot để các agent CloudThinker tra cứu contact, company, deal và ticket, theo dõi liên kết giữa chúng, và tóm tắt pipeline bán hàng bằng ngôn ngữ thông thường. Kết nối dùng **OAuth** (bạn đăng nhập HubSpot và chấp thuận quyền truy cập), nên không cần tạo hay dán API key. Agent chạy qua MCP server do HubSpot lưu trữ (Model Context Protocol, một chuẩn để agent gọi công cụ của một dịch vụ) và chỉ thấy những gì người dùng HubSpot đã ủy quyền thấy được.

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

* Một **tài khoản HubSpot** bạn đăng nhập được, có quyền truy cập các bản ghi mà agent cần đọc.
* Quyền ủy quyền app trong tài khoản HubSpot đó. Kết nối đầu tiên từ một tài khoản HubSpot phải do HubSpot admin thực hiện, bằng cách hoàn tất các bước bên dưới một lần. Sau đó, những người dùng khác trong tài khoản có thể kết nối.
* Trình duyệt cho phép popup từ CloudThinker, vì HubSpot mở trong cửa sổ mới.
* Vai trò **Admin** trong workspace CloudThinker, có quyền thêm và sửa kết nối. Xem [Vai trò](https://docs.cloudthinker.io/vi/guide/security/roles.md).

## Thiết lập

**1. Mở kết nối HubSpot**

Trong thanh bên, nhấn **More → Workspace settings → Connections**. Ở tab **Builtin Connections**, tìm **HubSpot** và nhấn **Connect**.

**2. Đăng nhập HubSpot**

Trong hộp thoại **Connect HubSpot**, nhấn **Open HubSpot**. HubSpot mở trong cửa sổ mới.

**3. Chọn tài khoản và cấp quyền**

Chọn tài khoản HubSpot cần kết nối, xem lại các quyền HubSpot liệt kê và ủy quyền. Các quyền đó dựa trên chính người dùng HubSpot của bạn.

**4. Quay lại CloudThinker**

Cửa sổ HubSpot và hộp thoại tự đóng khi HubSpot xác nhận.

**Trạng thái thành công:** kết nối HubSpot hiển thị **Connected**.

## Chi tiết kết nối

Không có trường nào cần điền. CloudThinker lưu access token và refresh token mà HubSpot cấp và tự gia hạn token mà không hỏi lại bạn.

## Quyền yêu cầu

HubSpot không cho bạn tự chọn scope trong OAuth. Những gì agent tiếp cận được do hai yếu tố quyết định:

| Yếu tố | Quyết định điều gì |
| - | - |
| **Quyền HubSpot của người ủy quyền** | Agent chỉ xem được các bản ghi mà người dùng đó vốn xem được, không bao giờ nhiều hơn. |
| **Thuộc tính Sensitive Data** | Không bao giờ được hiển thị qua kết nối này. |
| **Dữ liệu hoạt động** (cuộc gọi, email, cuộc họp, ghi chú, task, hội thoại) | Bị HubSpot chặn khi tài khoản bật Sensitive Data trong cài đặt quản lý dữ liệu HubSpot. |

> [!TIP]
>
> Ủy quyền bằng một người dùng HubSpot có quyền chỉ bao phủ các bản ghi agent cần thấy, ví dụ một người dùng giới hạn trong pipeline của nhóm Sales. CloudThinker không thể thu hẹp quyền thấp hơn mức người dùng đó có.

## Khả năng của agent

| Khả năng | Agent có thể làm gì |
| - | - |
| **Thông tin tài khoản** | Hiển thị người dùng HubSpot đã kết nối, tài khoản và các đối tượng CRM khả dụng |
| **Contact và company** | Tìm theo tên, email hoặc tên miền và mở một bản ghi với các thuộc tính bạn yêu cầu |
| **Deal** | Tìm deal và báo cáo giá trị, stage và ngày chốt |
| **Ticket** | Tìm ticket hỗ trợ và mở một ticket theo ID |
| **Liên kết** | Theo dõi liên kết giữa các bản ghi, chẳng hạn company của một contact hoặc các deal đang mở của một company |
| **Đối tượng CRM khác** | Đọc quote, product, line item, order, invoice, cart và subscription nếu gói HubSpot của bạn có |

Thao tác đọc chạy mà không hỏi. Các công cụ đến từ MCP server của HubSpot, nên HubSpot quyết định công cụ nào tồn tại. Mọi công cụ thay đổi dữ liệu CRM đều được tính là thao tác ghi, và [Approvals](https://docs.cloudthinker.io/vi/guide/approvals/overview.md) quyết định công cụ đó được chạy, chờ người duyệt hay bị từ chối.

### Xác minh kết nối

```text theme={null}
Show which HubSpot account CloudThinker is connected to and which CRM objects I can read
```

Kết nối hoạt động sẽ nêu tên người dùng và tài khoản HubSpot của bạn và liệt kê các đối tượng như contact, company và deal. Lỗi xác thực có nghĩa là ủy quyền đã hết hạn hoặc bị thu hồi: hãy kết nối lại.

### Ví dụ prompt

```text theme={null}
List open HubSpot deals closing this quarter with amount, stage, and close date
Find the HubSpot contact for buyer@example.com and the company they belong to
Summarize the last five HubSpot tickets for Example Corp and flag any still open
Which deals in the "Decision Maker Bought In" stage have no close date set?
```

> [!NOTE]
>
> Nêu các thuộc tính bạn cần, chẳng hạn amount hoặc stage. Yêu cầu hẹp trả về nhanh hơn và giữ câu trả lời tập trung.

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

> **Popup blocked. Please allow popups for this site.**
>
> Trình duyệt đã chặn cửa sổ HubSpot. Cho phép popup từ CloudThinker, rồi nhấn **Open HubSpot** lần nữa.

> **HubSpot không cho tôi ủy quyền**
>
> Chưa có HubSpot admin nào kết nối tài khoản HubSpot này. Nhờ một HubSpot admin hoàn tất thiết lập ở trên một lần, rồi thử lại bằng người dùng của bạn.

> **Connection is taking longer than expected. Refresh to check its status.**
>
> CloudThinker không thấy quá trình ủy quyền hoàn tất. Làm mới trang và kiểm tra kết nối HubSpot. Nếu chưa **Connected**, hãy bắt đầu kết nối lại.

> **The provider rejected these credentials. Update them, then connect again.**
>
> HubSpot từ chối ủy quyền đã lưu, ví dụ vì ủy quyền đã hết hạn hoặc có người thu hồi app trong HubSpot. Mở kết nối HubSpot, bắt đầu kết nối lại và ủy quyền lại.

> **This connection did not respond in time. Try connecting again.**
>
> HubSpot không phản hồi kịp. Chờ một lát và kết nối lại.

> **Agent không thấy một bản ghi hoặc một loại dữ liệu**
>
> Quyền HubSpot của người ủy quyền quyết định những gì hiển thị, và một số đối tượng phụ thuộc vào gói HubSpot của bạn. Kiểm tra xem người dùng đó có mở được bản ghi trong HubSpot không. Nếu Sensitive Data đang bật, dữ liệu hoạt động như email và ghi chú bị HubSpot chặn. HubSpot chỉ cấp scope mới khi bạn ủy quyền lại. Nếu thiếu một khả năng được liệt kê ở trên, mở **HubSpot** trong **More → Workspace settings → Connections**, nhấn biểu tượng thùng rác (**Disconnect**) trên hàng của tài khoản và kết nối lại.

## Bảo mật

* **Quyền tối thiểu** — chỉ cấp các quyền mà agent cần cho trường hợp sử dụng của bạn; bắt đầu với quyền chỉ đọc và mở rộng sau.
* **Chỉ đọc theo mặc định** — sử dụng thông tin xác thực chỉ đọc trừ khi bạn muốn agent thực hiện thay đổi qua kết nối này.
* **Xoay vòng thông tin xác thực** — xoay vòng khóa và token theo lịch trình thông thường của bạn; CloudThinker sẽ lấy giá trị mới khi bạn cập nhật kết nối.
* **Thu hồi khi bàn giao** — xóa thông tin xác thực tại nhà cung cấp khi bạn xóa một kết nối hoặc khi đồng nghiệp rời nhóm.

- **Ủy quyền bằng đúng người dùng.** Kết nối hoạt động với quyền HubSpot của người dùng đó, nên hãy chọn tài khoản chỉ tiếp cận những gì agent cần.
- **Thu hồi từ phía nào cũng được.** Trong CloudThinker, nhấn biểu tượng thùng rác (**Disconnect**) trên hàng của tài khoản. Trong HubSpot, mở **Settings → Integrations → Connected Apps** và gỡ cài đặt app.

## Liên quan

> **[Approvals](https://docs.cloudthinker.io/vi/guide/approvals/overview.md)**
>
> Quyết định thay đổi nào được chạy, chờ người duyệt hoặc bị từ chối

> **[Kết nối](https://docs.cloudthinker.io/vi/guide/connections/overview.md)**
>
> Mọi dịch vụ bạn có thể kết nối với CloudThinker


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