跳到主要内容
DocumentationAPI ReferenceVideo Tutorials

Google Calendar

连接 Google Calendar，让您的语音代理可以在来电者还在线时查询可用时间并预约真实约会。连接后，您账户中的每个代理都可以使用该日历——无需为每个代理重新授权。

所有套餐均可使用

Google Calendar 在包括 Free 在内的所有套餐上均可使用。没有额外费用——日历查询和事件创建每轮只消耗几个词的 LLM 输出，按您正常的每分钟费率计费。

功能说明​

  • 可用时间查询 — 代理读取您的日历，确认所请求的时段是否空闲。
  • 事件创建 — 代理将已确认的预约作为新的日历事件预约下来，并附上来电者的姓名、电话以及通话中采集的任何备注。
  • 取消链接 — 每次预约都包含一个自助取消链接，来电者会通过电子邮件或短信收到，这样他们无需回电即可更改计划。

代理不会读取他人的事件详情、编辑无关事件或暴露日历内容——只会读取回应来电者所需的那些时段。

需要更丰富的预约功能？

如果您通过专门的预约系统处理约会，请连接 eTermin（服务、改期、取消、防重复预约保护），或者对于餐厅餐桌，改用 resmio。这些集成会直接预约到您团队已经在使用的系统中。

连接您的 Google 账户​

  1. 在侧边栏中打开 Integrations，点击 Connect Google Calendar。
  2. 您会被重定向到 Google 的标准授权同意界面。
  3. 使用拥有您想使用的日历的 Google 账户登录。
  4. 查看所请求的权限——查看和编辑您日历上的事件——并点击 Allow。
  5. 您会返回到 HANC，集成卡片会显示 Connected 以及所使用的电子邮件地址。

请求的权限范围​

HANC 请求单一的 OAuth 权限范围：https://www.googleapis.com/auth/calendar.events。

这是一个 Sensitive 范围（而非 Restricted），这意味着：

  • HANC 可以读取和创建事件，但不能读取您的完整日历列表、共享设置，或访问任何其他 Google 服务（无 Gmail、无 Drive、无联系人）。
  • Google 对此范围不要求安全评估，也没有年度重新验证。

账户级，而非每代理级​

连接位于 HANC 账户级别。令牌只存储一次，存放在共享存储中，并提供给您账户中的每个语音代理。您只需授权一次，然后就可以在任意数量的代理上启用日历工具。

这与提示词、知识库或语音等每代理级设置不同——那些是在每个代理上单独配置的。

每个代理的工具配置​

将 Google 连接到您的 HANC 账户会使该工具可用。要实际使用它，请将 Google Calendar 工具添加到代理的 Actions 标签页并进行配置。

设置作用
Calendar代理从哪个已连接的日历读取和写入
Timezone代理报出每个时段所使用的时区（见下文）
Work hours代理会提供的日期和时间范围（例如周一至周五，09:00–18:00）
Slot duration默认预约时长（例如 30 分钟）
Buffer连续预约之间的间隔（例如 15 分钟）

您账户中的每个代理都可以独立配置这些设置——当一个代理预约 30 分钟的销售演示，而另一个代理从同一日历预约 90 分钟的咨询时，这会很有用。

关于包括 Outlook 对应版本在内的完整设置演练，请参见 集成 → Google Calendar。

时区处理​

所有时段的提供、确认和创建的事件都使用代理日历工具上配置的时区（例如 Europe/Vienna、Europe/Berlin、America/New_York）。代理在提供某个时段时会把时区说出来——例如 "周二下午三点，维也纳时间，可以吗？"——这样来电者无需猜测。

如果您的来电者处于不同的时区，请配置代理在预约前口头确认当地对应时间。创建的 Google Calendar 事件始终以配置的时区存储时间；Google 会按每位参与者的本地时区显示。

断开连接与重新连接​

您可以随时在 Integrations 页面断开 Google Calendar。

断开连接时：

  • 存储的令牌会被移除。
  • 您账户中每个代理上的每个 Google Calendar 工具都会被停用——工具仍保留在每个代理上，但在通话中不再触发。
  • Google 中已预约的现有事件不会被删除或更改。

当您重新连接（或连接另一个 Google 账户）时，之前被停用的工具会自动重新激活，并沿用其原有的工作时间、时段时长和时区设置——您无需在每个代理上重新添加工具。

您也可以在 Google 账户的安全设置中撤销 HANC 的访问权限。其效果与在 HANC 内部断开连接相同；下一次尝试使用该日历的通话会干净利落地失败，工具会在下次同步时停用。

HANC 中已预约的约会​

代理创建的每个事件也会与任何 Outlook 预约一起显示在 CRM → Calendar 中，并带有指向来电者联系人记录的链接。统一视图请参见 CRM → Calendar。

相关内容​