# Google 日历集成

## 概览

本平台与 Google 日历集成，可在您的预约和日历之间提供**双向同步**。当联系人通过本平台进行预订时，该预约会显示在您的 Google 日历中。当您在 Google 日历中添加事件时，平台会将这些时间段识别为忙碌状态，并不会将其作为可用时段提供。

**为什么这很重要：** 您无需担心重复预订。无论您是在 Google 日历中添加会议，还是联系人通过平台进行预订，您的可用性状态在各处都能保持准确。

**这是必须的吗？** 不是。即使不连接任何日历，预订功能也能正常工作：您可以在事件类型上设置工作时间，AI 会根据这些时间进行预订。连接 Google 日历可添加此处描述的双向同步功能，以及自动生成的 Google Meet 链接。请参阅 [预订系统](booking-system.md#overview)。


---

## 连接 Google 日历

有三种连接方式：

### 从设置中连接（主要方式）

1. 打开**设置**，在侧边栏的**集成**组下点击**预订与日历**。
2. 在**可用**下方找到 **Google 日历**卡片，然后点击**连接**。


3. 系统会打开一个 Google 登录窗口。选择您想要同步的日历所属的账户并授予权限。（如果没有任何窗口弹出，说明您的浏览器拦截了弹窗——请允许此站点的弹窗并再次点击**连接**。）
4. 授予访问权限后，页面会自动更新：Google 日历会移至**已连接**，下方显示您的 Google 账户地址。

### 从事件类型中连接

当您确实需要使用 Google 日历时，应用程序会引导您进行连接：

1. 点击侧边栏中的**预约**（在**互动**下方），切换到**事件类型**选项卡，然后创建或打开一个事件类型。
2. 选择 **Google Meet** 作为会议类型（或尝试开启表单底部的**将预订同步到 Google 日历**）。
3. 如果您的日历尚未连接，会出现一个橙色警告，其中包含**连接 Google 日历**链接：


4. 点击该链接。它会将您带到**设置 → 预订与日历** — 请继续执行上述第 2 步。

### 在引导式入门期间

如果您刚刚设置账户，**引导式入门向导**中会有一个**连接 Google 日历**的步骤——当您在预订选项步骤中选择**由 AI 为我预订**后，该步骤会自动出现。请参阅 [引导式入门](../get-started/onboarding.md#connect-google-calendar-conditional)。

**重要提示：** 双向同步功能需要这些权限。平台仅访问您的日历数据，不会读取您的电子邮件、联系人或任何其他 Google 数据。您可以随时在 Google 账户的安全设置中撤销访问权限。

**提示：** 如果您使用多个 Google 账户（例如一个个人账户和一个工作账户），请确保选择您希望平台同步日历的那个账户。

### 检查连接状态及断开连接

**设置 → 预订与日历**也是您稍后检查连接的地方。当 Google 日历连接成功后，它会出现在**已连接**列表中，旁边有一个**断开连接**按钮。

断开连接将停止将新预订同步到您的日历，并停止 AI 创建 Google Meet 链接。平台中已有的预约将保持原样。

---

## 双向同步说明

双向同步意味着更改会自动在两个方向上流动：

### 从应用程序到 Google 日历

- 当联系人在应用程序中预订预约时，该事件会**自动出现在**您的 Google 日历上。
- 当预约在应用程序中取消时，相应的 Google 日历事件会**更新或删除**。
- 预约的详细信息会自动为您填充到日历事件中（请参阅下表）。

### 同步到 Google 日历的内容

创建预订时，平台会使用您一眼就能看到的所有信息填充 Google 日历事件：

- **预约的日期和时间**。
- **联系人的姓名、电话号码和电子邮件**——这样您就知道您要见谁以及如何联系他们。如果已知其电子邮件地址，该联系人也会被添加为活动的受邀嘉宾，并通过电子邮件收到 Google 日历邀请（包括 Google Meet 链接），以便他们加入会议。（邀请发送与否取决于事件类型中的**向联系人发送预约电子邮件**开关。）
- **会议地点**——即您在事件类型中设置的物理地址，或者如果您在预订过程中收集了客户的地址，则为客户提供的地址（请参阅[在预订过程中收集额外信息](booking-system.md#collecting-extra-information-during-booking)）。
- **会议链接**——根据您为事件选择的**会议类型**，自动生成的 Google Meet 链接或您的自定义链接。
- **AI 在预订过程中收集的任何额外信息**（例如，客人数或参考编号），显示在事件的描述和备注中。

**示例：** 一位联系人预订了“上门咨询”。日历事件会显示他们的姓名、电话和电子邮件，预订时提供的地址作为地点，以防通话转为虚拟会议的 Google Meet 链接，以及 AI 收集的任何备注——所有这些都无需您手动输入任何内容。

### Google 日历与应用同步

- 当您在 Google 日历中添加活动时，平台会**将该时间段识别为忙碌状态**。
- AI **不会提供**与您现有 Google 日历活动冲突的空闲时段。
- 如果您移动或删除 Google 日历中的活动，平台会**相应地进行更新**。

**示例：** 您在 Google 日历中添加了一个中午 12:00 到下午 1:00 的团队午餐。平台会立即将该时间段识别为不可用。当联系人向您的 AI 代理询问可预约的时间时，中午 12:00 到下午 1:00 将不会作为选项出现。

这包含事件类型所允许的任何内容：日历上的忙碌时段会移除相应时间，即使对于支持[每个时段接受多个预订](booking-system.md#letting-multiple-people-book-the-same-slot)的事件类型也是如此，因为这意味着您在那段时间不可用，而不是某个位置已被占用。如果事件类型有多个[房间](booking-system.md#rooms-separate-resources-with-their-own-schedules)，则该忙碌时段仅适用于该日历所属的房间。

---

## 为活动类型开启同步

日历同步是针对每个活动类型的开关：

1. 点击侧边栏中的 **Appointments**（预约），然后切换到 **Event Types**（事件类型）选项卡。
2. 打开您想要同步的事件类型——点击其所在行，或使用右侧的铅笔图标——或者创建一个新的事件类型。


3. 向下滚动到表单底部，找到 **Notifications**（通知）部分。
4. 开启 **Sync bookings to Google Calendar**（将预订同步到 Google 日历）。


5. 点击 **Save**（保存）（如果是新建的活动，则点击 **Create event**（创建活动））。

从那时起，该活动类型的每次预订都会同步到您的 Google 日历，并且 AI 在提供空闲时段之前会检查该日历是否存在冲突。

**选择日历。** 连接 Google 日历后，事件类型的**房间**部分（位于**通知**正上方）会为每个房间提供其专属的 **Google 日历**选择器，并附注“此日历上的忙碌时间会锁定该房间，且该房间的预订会添加到此日历中。”拥有一个房间的事件类型在此处选择一个日历。为每位员工设置一个房间的事件类型会将每个房间指向该员工自己的日历，因此每个房间都会根据其对应的日历进行检查，并将预订写入其中。如果某个房间不需要同步，请将其保留为**无日历**。请参阅[房间](booking-system.md#rooms-separate-resources-with-their-own-schedules)。

**提示：** 如果您有专门用于预约的日历（例如“客户预订”），请连接包含该日历的 Google 账户。一个 Google 账户可以包含多个日历，因此团队通常只需要一个连接，而无需为每个人单独连接。这样可以将您的个人事件与预订日程分开。

---

## 冲突检测与忙碌时间屏蔽

一旦连接了 Google 日历并为活动类型开启了同步：

- **忙碌时间锁定** — 与现有 Google 日历事件重叠的时段会自动从可用时段中移除。您的联系人永远不会被提供与您日历上已有事项冲突的时间。
- **时段清理** — 一旦某个时间被预订（通过应用程序或直接在您的日历上），它将不再被提供。唯一的例外是设置为[每个时段接受多个预订](booking-system.md#letting-multiple-people-book-the-same-slot)的事件类型：该时间会持续提供，直到名额已满。
- **每个房间对应一个日历** — 如果一个事件类型有多个[房间](booking-system.md#rooms-separate-resources-with-their-own-schedules)且每个房间都链接到其自己的日历，则每个房间都会独立地根据其对应的日历进行检查。A 医生的忙碌早晨绝不会导致 B 医生的房间从列表中消失。

**示例：** 您在 Google 日历上有一个下午 2:00 到 3:00 的会议。AI 将不会提供任何与下午 2:00–3:00 重叠的预约时段。

---

## 实时更新

每当您的日程安排发生变化时，平台都会从 Google 日历接收实时通知。这对您意味着：

- 当您在 Google 日历上添加、移动或删除事件时，平台会在**几秒钟内**（而不是几分钟或几小时）更新您的可用性。
- 您无需手动刷新或同步任何内容。这一切都会在后台自动完成。
- 如果平台与 Google 日历之间的连接中断，平台会自动重新建立连接。

**为什么这很重要：** 如果您在上午 10:00 在 Google 日历上屏蔽了时间，那么在上午 10:01 向您的 AI 代理询问可用时间的联系人将直接看到该时间不可用。

---

## 将日历同步事件与您的 AI 结合使用

设置好事件类型后，将其指向您的 AI。

1. 打开 **AI Agents**，打开您的智能体，然后进入其 **AI Abilities** 步骤。
2. 找到 **Bookings** 卡片。
3. 开启 **Let this agent book appointments**，将提供商保留为 **Built-in calendar**，并在 **Choose what people can book** 下选择您的事件类型。


4. 点击 **保存更改 (Save changes)**。

完成后，AI 将执行以下操作：

- 检查您的 Google 日历以获取现有事件。
- 仅提供真正可用的时间段。
- 当联系人预订时，在平台和 Google 日历中同时创建预约。

这意味着即使您的日程在一天中发生变化，您的联系人也能始终看到准确的可用时间。完整的营销活动流程已在 [预约系统](booking-system.md#step-3--turn-on-bookings-for-your-ai) 中逐步介绍。

### 日历是否会消耗额度？

连接 Google 日历和双向同步是免费的——保持日历连接不会产生持续费用，通过预订页面直接进行的预订也是免费的。

额度仅在 AI 在对话中执行操作时消耗。AI 的回复计为一次 AI 操作；当它检查您的可用性或为联系人预订时段时，这些日历步骤中的每一步也计为一次 AI 操作，并按您模型层级的正常单次操作费率计费。因此，一次预订对话总共会消耗几次 AI 操作，而日历本身不会产生额外费用。

---

## 同步问题排查

### 日历未同步

- **检查连接** — 打开 **设置 → 预订与日历**，确认 Google 日历显示为已连接。如果需要（重新）授权，请点击该处的 **断开连接**，然后再次点击 **连接**。
- **重新授予权限** — 如果您之前在 Google 账户设置中移除了平台的访问权限，则需要重新连接并再次授予权限。
- **检查事件类型** — 确保相关事件类型的 **将预订同步到 Google 日历** 开关已开启（位于表单底部）。

### 预约未显示在 Google 日历上

- 验证该事件类型是否已启用 **将预订同步到 Google 日历**。
- 检查您连接的 Google 账户是否为您当前查看的那个账户。
- 请稍等片刻 — 首次连接后的同步可能会有短暂延迟。

### 忙碌时间未被屏蔽

- 确认您连接的 Google 账户中包含您现有事件所在的日历。例如，如果您的会议在工作账户中，但您连接的是个人账户，平台将无法看到这些会议。
- 已连接日历上的每个事件都会屏蔽其时间段 — 包括 Google 端标记为“空闲”的事件。如果某个时段意外不可用，请检查日历中该时间是否有任何事件。
- “全天”事件的处理方式可能会根据您的日历设置而有所不同。

### 如果 Google 失去对您账户的访问权限

如果平台失去了对您 Google 账户的访问权限（例如，您更改了 Google 密码或撤销了应用权限），您的日历事件将停止同步，直到恢复访问权限为止。请通过事件类型的 **连接 Google 日历** 链接重新连接；如果问题仍未解决，请联系支持团队，我们将协助您恢复同步。

---

## 需要帮助？

If you are experiencing persistent sync issues, reach out via our [email support](mailto:hi@youraiconnector.com).