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

# Kết nối ứng dụng (Google, Slack, HubSpot và hơn thế nữa)

> Trang bị cho tác nhân AI của bạn khả năng thực tế — kiểm tra lịch, cập nhật CRM, đăng lên Slack — chỉ với vài lượt nhấp, không cần code.

Kết nối ứng dụng cho phép tác nhân AI thực hiện hành động trong các công cụ mà đội ngũ của bạn đã sử dụng, ngay trong cuộc trò chuyện: kiểm tra thời gian trống trên lịch, tìm người gọi trong CRM, thêm khách hàng tiềm năng vào bảng tính, đăng bản tóm tắt lên Slack. Bạn kết nối tài khoản một lần tại **Kết nối → Ứng dụng**
(`/dashboard/app-connections`), chọn những việc tác nhân được phép thực hiện, rồi
gắn kết nối đó với bất kỳ tác nhân nào trong trình tạo của tác nhân đó.

Hiện có sáu ứng dụng:

| Ứng dụng            | Tác nhân của bạn có thể làm gì với ứng dụng đó                          |
| ------------------- | ----------------------------------------------------------------------- |
| **Google Calendar** | Xem thời gian trống và quản lý sự kiện lịch.                            |
| **Google Sheets**   | Thêm thông tin khách hàng tiềm năng và kết quả cuộc gọi vào bảng tính.  |
| **Slack**           | Tìm kênh, tìm kiếm tin nhắn và đăng tin nhắn khi được cấp quyền.        |
| **HubSpot**         | Tìm liên hệ, cập nhật hồ sơ và thêm ghi chú.                            |
| **Salesforce**      | Tìm kiếm hồ sơ, cập nhật khách hàng tiềm năng và ghi nhật ký hoạt động. |
| **Cal.com**         | Kiểm tra thời gian trống và quản lý đặt lịch.                           |

Với bất kỳ nội dung nào không có trong danh sách này, hãy tạo một
[kết nối API](/vi/guides/api-connections) tùy chỉnh hoặc thêm một
[máy chủ MCP](/vi/guides/mcp-servers).

## Kết nối tài khoản

<Steps>
  <Step title="Mở Kết nối → Ứng dụng rồi nhấp Thêm ứng dụng">
    Bộ chọn hiển thị sáu ứng dụng. Bạn có thể kết nối nhiều tài khoản
    của cùng một ứng dụng — mỗi ứng dụng sẽ hiển thị số lượng "đã kết nối" sau khi bạn có ít nhất một tài khoản.
  </Step>

  <Step title="Ủy quyền tài khoản">
    Hầu hết ứng dụng dùng OAuth: một cửa sổ bật lên sẽ mở, bạn đăng nhập vào nhà cung cấp và
    phê duyệt quyền truy cập, rồi kết nối xuất hiện trên trang. **Cal.com là
    ngoại lệ** — ứng dụng này kết nối bằng khóa API. Dán khóa
    rồi nhấp **Xác thực và kết nối**; khóa được kiểm tra với Cal.com
    trước khi được mã hóa và lưu.
  </Step>

  <Step title="Chỉ Google Sheets: chọn bảng tính">
    Kết nối Sheets cần biết bảng tính và tab nào để ghi dữ liệu
    vào. Ngay sau khi kết nối, một bảng cấu hình sẽ mở — dán
    URL của bảng tính (hoặc ID của bảng tính), nhấp **Kiểm tra bảng tính**, rồi
    chọn tab. Bảng này xác nhận các cột đã tìm thấy. Cho đến khi hoàn tất,
    ô kết nối sẽ hiển thị **Cần cấu hình**.
  </Step>
</Steps>

<Note>
  Quy trình xác minh OAuth của Google cho ThunderPhone hiện đang được xem xét, vì vậy
  Google hiển thị cảnh báo "ứng dụng chưa được xác minh" trong lúc cấp quyền cho Google
  Calendar và Google Sheets. Hộp thoại **Thêm ứng dụng** sẽ hướng dẫn bạn
  qua hai lần nhấp để tiếp tục (**Nâng cao → Chuyển đến ThunderPhone**).
</Note>

Việc kết nối và quản lý kết nối ứng dụng yêu cầu vai trò **quản trị viên** hoặc **chủ sở hữu**
trong tổ chức.

## Kiểm soát những việc tác nhân được phép thực hiện

Mỗi kết nối có nút bật/tắt quyền theo từng thao tác — mở ô kết nối
để quản lý các quyền này. Các thao tác dạng đọc được bật sẵn; các thao tác
ghi hoặc thay đổi dữ liệu của bạn sẽ mặc định **tắt** cho đến khi bạn bật:

| Ứng dụng        | Bật theo mặc định                                             | Tắt theo mặc định                                |
| --------------- | ------------------------------------------------------------- | ------------------------------------------------ |
| Google Calendar | Xem sự kiện & thời gian trống, Tạo sự kiện                    | Cập nhật sự kiện, Hủy sự kiện                    |
| Google Sheets   | Thêm hàng                                                     | —                                                |
| Slack           | Xem kênh & tin nhắn gần đây, Tìm kiếm tin nhắn                | Đăng tin nhắn                                    |
| HubSpot         | Tìm kiếm & đọc liên hệ và công ty                             | Tạo hoặc cập nhật liên hệ và thêm ghi chú        |
| Salesforce      | Tìm kiếm & đọc khách hàng tiềm năng, liên hệ và cơ hội        | Tạo hoặc cập nhật hồ sơ và ghi nhật ký hoạt động |
| Cal.com         | Liệt kê loại sự kiện & kiểm tra thời gian trống, Tạo đặt lịch | Đổi lịch hoặc hủy đặt lịch                       |

Thao tác bạn tắt sẽ không khả dụng với tác nhân — các
công cụ tương ứng sẽ không bao giờ được cung cấp cho tác nhân trong cuộc gọi.

## Các công cụ mà tác nhân AI của bạn có

Sau khi một kết nối được gắn với tác nhân AI, các thao tác đã bật sẽ xuất hiện
dưới dạng công cụ có thể gọi trong cuộc trò chuyện:

* **Google Calendar** — `calendar_list_events`, `calendar_check_availability`,
  `calendar_create_event`, `calendar_update_event`, `calendar_cancel_event`
* **Google Sheets** — `sheets_append_row` (ghi vào bảng tính và tab
  mà bạn đã cấu hình)
* **Slack** — `slack_list_channels`, `slack_search_messages`,
  `slack_post_message`
* **HubSpot** — `hubspot_search_contacts`, `hubspot_get_contact`,
  `hubspot_upsert_contact`, `hubspot_add_note`
* **Salesforce** — `salesforce_search_records`, `salesforce_get_record`,
  `salesforce_upsert_lead`, `salesforce_log_activity`
* **Cal.com** — `calcom_list_event_types`, `calcom_check_availability`,
  `calcom_create_booking`, `calcom_cancel_booking`

Bạn không cần viết schema cho bất kỳ công cụ nào trong số này — ThunderPhone xác định các công cụ
và định tuyến lệnh gọi qua tài khoản đã kết nối.

## Gắn kết nối với tác nhân AI

Kết nối không thực hiện gì cho đến khi một tác nhân AI sử dụng chúng. Mở tác nhân AI trong
trình xây dựng ([Xây dựng tác nhân AI](/vi/guides/build-an-agent)) và thêm kết nối
trong phần **Ứng dụng đã kết nối**. Thẻ của một kết nối trên trang Ứng dụng
cho biết số thao tác được bật và số tác nhân AI đang sử dụng kết nối đó.

## Ngắt kết nối

Mở thẻ kết nối và ngắt kết nối từ đó. Các tác nhân AI đang
sử dụng kết nối sẽ mất các công cụ đó ở cuộc gọi tiếp theo.

## Bước tiếp theo

<CardGroup cols={2}>
  <Card title="Biến bất kỳ API nào thành hành động của tác nhân AI" icon="plug" href="/vi/guides/api-connections">
    Trình hướng dẫn dán cURL cho các dịch vụ không có kết nối gốc.
  </Card>

  <Card title="Thêm máy chủ MCP" icon="server" href="/vi/guides/mcp-servers">
    Mang máy chủ công cụ của riêng bạn qua Streamable HTTP.
  </Card>
</CardGroup>
