Chuyển đến nội dung chính
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ò.

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

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

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

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ố

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.
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.
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.
HubSpot không phản hồi kịp. Chờ một lát và kết nối lại.
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

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

Mọi dịch vụ bạn có thể kết nối với CloudThinker