连接应用

集成页面将 Ringhum 与您的团队已在使用的工具连接起来。应用连接后，Ringhum 会在通话、消息、预约和订单发生时实时发送给它。有些应用也会反向提供信息，例如日历的忙碌时间，或您店铺中来电者的订单。每个应用只需为整个工作区连接一次，工作区中的每个助手都可以使用它。

开始之前

• 只有工作区所有者和管理员可以连接、更改或断开应用连接。成员和查看者可以查看该页面，卡片上会显示请联系管理员连接此应用。
• 大多数应用在所有套餐中均可使用。Google Calendar（双向同步）和 Calendly 属于 Team 和 Scale 方案，在其他方案中，其卡片会显示套餐锁定标识，而不是连接按钮。
• 您需要拥有该应用的账户，通常还需要管理员权限才能创建 API 密钥或 webhook。

应用目录

在侧边栏打开集成，使用搜索框或分类按钮查找应用。已连接按钮只会显示您已连接的应用。

如果您使用的工具不在列表中，通常可以通过 Zapier、Make 或 n8n 连接，或在开发者下使用您自己的 webhook 端点。页面顶部的 Webhook 与 API 按钮会带您前往该页面。

三种连接方式

每个应用使用以下三种连接方式之一，卡片和连接对话框会告诉您具体使用哪一种。

有两类应用的连接方式不同。日历订阅源（ICS）卡片会为您提供一个可粘贴到日历应用中的链接，无需连接任何内容。酒店渠道（Booking.com、Airbnb、Vrbo）按房间单独设置：其卡片上有一个在"房间"中设置按钮，会打开房间与价格。

使用密钥或 webhook 网址连接应用

1. 打开集成，找到相应应用。
2. 在其卡片上点击连接，连接对话框会打开，并简要说明在该应用中何处能找到相应凭据，许多应用还带有文档链接。
3. 填写相应字段，例如 API 密钥、子域名、列表或项目 ID，或 webhook 网址。
4. 在发送下，勾选该应用应接收的事件。参见选择发送哪些内容。
5. 如果对话框显示仅需要处理的通话开关，请决定该应用应接收每通电话，还是仅需要处理的通话。
6. 点击连接。

Ringhum 会在保存之前先检查连接是否有效。如果检查失败，不会保存任何内容，对话框会显示无法连接，并给出该应用返回的原因，例如密钥被拒绝。请修正相应字段后重试。

注： 凭据会以加密方式存储，仅在我们的服务器上使用。

通过登录方式连接应用

1. 在卡片上点击连接，您会被转到该服务的页面。
2. 登录并批准所请求的访问权限。
3. 您会返回集成页面，并看到一条确认消息。

部分登录类应用还需要额外一步。对于 Google Sheets，请在卡片上点击设置并粘贴电子表格 ID，在此之前，投递会被跳过并显示"请在集成设置中添加电子表格 ID"。Google Drive 可立即使用，文件会保存到"我的云端硬盘"，除非您在设置中添加了文件夹 ID。

测试连接

已连接的卡片会显示状态徽章：已连接、错误或已暂停，同时显示最近一次投递的时间以及该应用接收的事件。

• 发送测试（消息与自动化应用）会发布一条测试消息，让您能在相应频道或工作流中看到它。
• 测试（其他所有应用）会检查凭据是否仍然有效。

结果会以消息形式显示在屏幕顶部。对于 Zapier 和 Make，请在映射字段之前先发送一次测试事件，以便工作流了解数据结构。

管理连接

已连接的卡片会显示以下部分或全部按钮：

• 设置（需要填写字段的应用）会重新打开对话框以更改凭据或事件，点击保存设置后，连接会在保存更改前再次被检查。
• 重新连接（登录类应用）会重复登录流程，例如在您更改密码或访问权限过期后使用。
• 暂停会停止所有投递但不会丢失设置，恢复会重新开始投递。
• 断开连接会移除该连接及其存储的凭据。

故障排查

没有看到"连接"按钮。 您可能不是所有者或管理员，该应用可能需要更高的套餐（卡片会显示套餐锁定标识），或者某个登录类应用显示需要设置，表示该应用目前不可用。如果该状态持续存在，请联系支持团队。

页面顶部显示"此工作区已关闭原生连接器功能"。 说明您工作区已关闭 CRM、客服工单、任务、电子表格、营销、分析和电商类应用，消息、自动化和日历类应用仍可正常使用。请联系支持团队重新开启。

我的测试通话没有出现在 Slack 或我的 CRM 中。 测试通话的通话更新、收件箱事项和订单不会发送给已连接的应用，请拨打该号码进行一次真实通话。

卡片显示"错误"。 点击卡片上的最近投递记录行，查看具体出了什么问题。参见排查投递问题。