跳到主要内容
DocumentationAPI ReferenceVideo Tutorials

Google 日历

连接 Google 日历,让您的 AI 语音代理在来电者还在线时检查可用性并预约真实约会。一旦连接,您账户上的每个代理都可以使用该日历——无需对每个代理重新授权。

适用于所有套餐

Google 日历适用于所有套餐,包括免费套餐。无额外费用——日历查询和事件创建每个回合仅使用几个词的 LLM 输出,按您的常规分钟费率计费。

功能介绍​

  • 可用性检查 — 代理读取您的日历以确认所请求的时间段是否空闲。
  • 事件创建 — 代理将确认的约会作为新的日历事件预约,包含来电者的姓名、电话以及通话中捕获的任何备注。
  • 取消链接 — 每次预约都包含一个自助取消链接,来电者通过电子邮件或短信收到,因此他们可以更改计划而无需回拨。

代理不会读取其他人的事件详情、编辑无关事件或暴露日历内容——仅访问回答来电者所需的时间段。

连接您的 Google 账户​

  1. 在侧边栏中打开集成并点击连接 Google 日历。
  2. 您将被重定向到 Google 的标准同意屏幕。
  3. 使用拥有您要使用的日历的 Google 账户登录。
  4. 查看请求的权限——查看和编辑您日历上的事件——并点击允许。
  5. 您将返回 HANC,集成卡片显示已连接以及所使用的电子邮件地址。

请求的范围​

HANC 请求单个 OAuth 范围:https://www.googleapis.com/auth/calendar.events。

这是一个敏感范围(非受限),这意味着:

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

账户范围,而非每个代理​

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

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

每个代理的工具配置​

将 Google 连接到您的 HANC 账户使工具可用。要实际使用它,请将 Google 日历工具添加到代理的动作选项卡并进行配置。

设置功能
日历代理读取和写入哪个连接的日历
时区代理报价的每个时间段使用的时区(见下文)
工作时间代理将提供的天数和时间范围(例如周一至周五,09:00–18:00)
时段时长默认约会长度(例如 30 分钟)
缓冲连续约会之间的填充(例如 15 分钟)

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

完整的设置演示(包括 Outlook 等效项),请参阅集成 → Google 日历。

时区处理​

所有时段报价、确认和创建的事件都使用代理日历工具上配置的时区(例如 Europe/Vienna、Europe/Berlin、America/New_York)。代理在提供时段时会大声说出时区——例如,"周二下午三点维也纳时间,可以吗?"——这样来电者就不必猜测。

如果您的来电者在不同的时区,请配置代理在预约前口头确认当地等效时间。创建的 Google 日历事件始终以配置的时区存储时间;Google 会在每个参与者的本地时区显示。

断开连接和重新连接​

您可以随时从集成页面断开 Google 日历。

断开连接时:

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

当您重新连接(或连接不同的 Google 账户)时,先前停用的工具会自动重新激活,保留旧的工作时间、时段时长和时区设置——您不必在每个代理上重新添加工具。

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

HANC 中已预约的约会​

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

相关​