将预约连接到其他系统

连接功能让其他系统操作预约，让团队成员在自己的日历应用查看来访，并在预约变化时通知您的系统。

开始之前

• 只有拥有 Set up bookings 权限的所有者可以创建和撤销连接。

步骤

创建 API 密钥：

1. 打开 Bookings → View → Connections。
2. 在 API keys 下填写 Name 和 Validity in days（1 至 730 天）。
3. 勾选密钥允许执行的操作：查看、管理或报表。
4. 创建密钥后立即复制密钥值，只会显示一次。

为团队成员提供日历订阅：

1. 在 Team calendar subscription 下填写 Name 并选择团队成员。
2. 创建链接并复制显示的地址。
3. 在其日历应用中将该地址添加为订阅日历。

添加 webhook：

1. 在 Webhooks 下填写接收端的 HTTPS URL，选择 Add。
2. 复制仅显示一次的签名密钥，交给接收端运维人员。

注意事项

• 请立即复制密钥：持有人拥有您选定的访问权限。选择 Revoke 可停用密钥、日历链接或 webhook。
• 密钥适用于一个分支，可查看、创建、改期和更改预约状态及读取报表，不能修改设置、客户、导入或其他密钥。
• 最多可同时启用 50 个密钥和日历链接。
• 日历订阅显示该成员过去 30 天和未来 90 天的预约编号及时间，不含客户姓名、电话或备注。
• 创建、修改、取消或结算预约时会发送 webhook，包含预约编号、时间及状态，不含客户资料。使用您的密钥签名，接收端可验证消息来自 Kluvan。
• 只接受使用 443 端口的公开 HTTPS 地址。
• 持续失败的 webhook 最多重试八次，然后显示 Delivery stopped after repeated failures 和 Retry 按钮。
• 连接仅使用测试接收端验证过，尚未与实际外部系统验证。依赖它之前，请测试您的接收端。