配置集成

Cal.com

将 ElevenLabs 智能体与 Cal.com 日程安排连接。

概述

将 ElevenLabs AI 智能体与 Cal.com 连接，管理日程安排和日历预订。通过此集成，智能体可通过自然对话查询可用时间、预约、取消或重新安排会议，以及查找现有预订。

功能

功能支持情况
零保留模式（ZRM）不支持
工具中的附件不支持 — 工具仅处理文本

设置

此集成使用 Cal.com API 密钥进行身份验证（而非 OAuth 应用）。

1

在 Cal.com 中生成 API 密钥

在 Cal.com 账户中前往 Settings > Developer > API Keys，然后点击 New。请立即复制生成的密钥 — 之后将不会再次显示。

2

使用正式密钥

Cal.com 会生成两种密钥 — 测试密钥（以 cal_ 开头）和正式密钥（以 cal_live_ 开头）。请使用正式密钥，以便智能体访问真实日历数据。

3

在 ElevenLabs 中连接

在 ElevenLabs 集成设置中，将 Cal.com API 密钥粘贴到 API Key 字段。

演示

此演示使用旧版 webhook 工具。如果你使用原生 Cal.com 集成，工具会自动配置， 无需手动设置 webhook。

Cal.com 集成演示

工作原理

智能体通过工具调用逐步完成预约流程。以下标签页展示高级概览和详细系统提示词。

1

初步咨询与会议详情

智能体会询问会议目的、首选日期和时间以及时长，以收集日程安排信息。

2

查询日历可用时间

智能体会通过以下方式查询日历可用时间：

  • 使用 get_available_slots 工具获取空闲时段。
  • 确认请求的时间是否可用。
  • 如果请求的时间不可用，建议其他时间。
  • 与来电者确认所选时间。
3

收集联系信息

确定时间后，智能体会：

  • 收集并验证参会者全名。
  • 核实邮箱地址是否准确。
  • 确认时区信息。
  • 收集 Cal.com 事件类型所需的其他字段。
4

创建会议

智能体会：

  • 验证所有信息后调用 book_meeting 工具。
  • 遵循预约模板结构。
  • 向参会者确认会议已创建。
  • 告知对方将收到日历邀请。

手动设置 webhook

如果使用原生 Cal.com 集成，工具会自动配置。以下步骤 仅适用于手动设置 webhook。

1

存储 Cal.com 密钥

发起经过身份验证的请求前，请安全存储 API 密钥。如果尚未生成，请新建一个 Cal.com API 密钥。

Cal.com API 要求使用以下身份验证标头：

Cal 请求标头结构
'Authorization': 'Bearer YOUR_API_KEY'

将密钥存储在智能体的密钥存储中，确保安全，并在发起请求时可访问。

为匹配 Cal.com 所需的身份验证结构，创建密钥时请记得在 API 密钥前添加 Bearer 。

工具密钥

2

向智能体添加工具

创建以下两个工具以启用日历预约：

  1. get_available_slots：当用户询问 “Louis 周二上午 10:30 有空吗？” 时，智能体会使用 Cal.com 的“获取可用时段”端点检查空闲时段。

  2. book_meeting：确定合适的时间后，智能体会使用 Cal.com 的“创建预约”端点预约会议。

前往控制台的 Tools 部分并选择 Add Tool。选择 Webhook 作为工具类型，然后填写以下部分：

智能体用于确定何时调用工具的元数据：

字段值
名称get_available_slots
描述此工具用于检查日历中特定时段是否可用。
方法GET
URLhttps://api.cal.com/v2/slots

智能体用于确定何时调用工具的元数据：

字段值
名称book_meeting
描述确定时间后，此工具会在日历中预约会议。
方法POST
URLhttps://api.cal.com/v2/bookings

点击 Test AI agent 按钮测试智能体。按需调整系统提示词。

3

添加日期和时间感知

默认情况下，智能体不知道当前日期或时间。使用以下任一方法：

  1. 创建时间获取工具：添加一个获取当前日期和时间的工具。

  2. Overrides：使用 overrides 功能，在每次对话开始时将当前日期和时间注入系统提示词。

安全注意事项

  • 所有 webhook 调用均使用 HTTPS 端点。
  • 使用 ElevenLabs Secrets Manager 将敏感值存储为密钥。
  • 验证所有授权标头是否采用所需格式（Bearer YOUR_API_KEY）。
  • 绝不向来电者透露事件类型 ID 或 API 详情。

实用链接