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

# 连接应用（Google、Slack、HubSpot 等）

> 只需点击几下，无需编写代码，即可让您的智能体真正具备能力——查看日历、更新您的 CRM、向 Slack 发布消息。

应用连接可让语音智能体在对话过程中直接使用您的团队已在使用的工具：查看日历可用时间、在 CRM 中查找来电者、将潜在客户添加到电子表格、将摘要发布到 Slack。您只需在 **连接 → 应用**
(`/dashboard/app-connections`) 下连接一次账户，选择允许智能体执行的操作，然后在其构建器中将该连接附加到任意智能体。

目前提供六种应用：

| 应用                  | 您的智能体可以执行的操作           |
| ------------------- | ---------------------- |
| **Google Calendar** | 查看可用时间并管理日历活动。         |
| **Google Sheets**   | 将潜在客户详情和通话结果添加到表格中。    |
| **Slack**           | 查找频道、搜索消息，并在获得许可后发布消息。 |
| **HubSpot**         | 查找联系人、更新记录并添加备注。       |
| **Salesforce**      | 搜索记录、更新潜在客户并记录活动。      |
| **Cal.com**         | 查看可用时间并管理预约。           |

如需连接此列表中未包含的内容，请构建自定义
[API 连接](/zh/guides/api-connections)或添加
[MCP 服务器](/zh/guides/mcp-servers)。

## 连接账户

<Steps>
  <Step title="打开连接 → 应用，然后点击添加应用">
    选择器会显示六种应用。您可以连接同一应用的多个账户——连接后，每个应用都会显示“已连接”数量。
  </Step>

  <Step title="授权账户">
    大多数应用使用 OAuth：系统会打开弹出窗口，您登录服务提供商并批准访问权限，随后连接会显示在页面上。**Cal.com 是例外**——它改用 API 密钥连接。粘贴密钥并点击 **验证并连接**；系统会先根据 Cal.com 验证密钥，然后再将其加密并保存。
  </Step>

  <Step title="仅 Google Sheets：选择电子表格">
    Sheets 连接需要知道要写入哪个电子表格和标签页。连接后会立即打开配置面板——粘贴电子表格的 URL（或其 ID），点击 **检查电子表格**，然后选择标签页。面板会确认找到的列。在完成此操作前，连接卡片会显示 **需要配置**。
  </Step>
</Steps>

<Note>
  ThunderPhone 的 Google OAuth 验证目前正在审核中，因此在为 Google Calendar 和 Google Sheets 授权时，Google 会显示“未经验证的应用”警告。**添加应用** 对话框会引导您通过两次点击继续（**高级 → 前往 ThunderPhone**）。
</Note>

连接和管理应用连接需要组织中的 **管理员** 或 **所有者** 角色。

## 控制智能体可执行的操作

每个连接都提供按操作划分的权限开关——打开连接卡片即可管理。读取类操作默认启用；会写入或更改您数据的操作默认**关闭**，直到您手动启用：

| 应用              | 默认启用               | 默认关闭          |
| --------------- | ------------------ | ------------- |
| Google Calendar | 查看活动和可用时间、创建活动     | 更新活动、取消活动     |
| Google Sheets   | 添加行                | —             |
| Slack           | 查看频道和最近消息、搜索消息     | 发布消息          |
| HubSpot         | 搜索和读取联系人及公司        | 创建或更新联系人并添加备注 |
| Salesforce      | 搜索和读取潜在客户、联系人及商机   | 创建或更新记录并记录活动  |
| Cal.com         | 列出活动类型并查看可用时间、创建预约 | 重新安排或取消预约     |

您禁用的操作将无法供智能体使用——相应工具绝不会在通话中提供给它。

## 智能体可用的工具

连接附加到智能体后，已启用的操作会在对话期间显示为可调用工具：

* **Google Calendar** —— `calendar_list_events`, `calendar_check_availability`,
  `calendar_create_event`, `calendar_update_event`, `calendar_cancel_event`
* **Google Sheets** —— `sheets_append_row`（写入您配置的电子表格和标签页）
* **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`

您无需为这些工具编写架构——ThunderPhone 会定义工具，并通过已连接的账户路由调用。

## 将连接附加到智能体

在智能体使用连接之前，连接不会执行任何操作。在构建器中打开智能体（[构建智能体](/zh/guides/build-an-agent)），然后在其 **已连接的应用** 部分添加连接。应用页面上的连接卡片会显示已启用的操作数量，以及正在使用该连接的智能体数量。

## 断开连接

打开连接卡片，然后从中断开连接。正在使用该连接的智能体会在下一次通话时失去这些工具。

## 后续步骤

<CardGroup cols={2}>
  <Card title="将任何 API 转换为智能体操作" icon="plug" href="/zh/guides/api-connections">
    为没有原生连接的服务提供粘贴 cURL 向导。
  </Card>

  <Card title="添加 MCP 服务器" icon="server" href="/zh/guides/mcp-servers">
    通过 Streamable HTTP 接入您自己的工具服务器。
  </Card>
</CardGroup>
