SuperAPI AI 工具集

cal-com

办公与效率

查看项目

更新于 10-16 07:29

技能介绍

用途

Cal.com 是一个开源日程安排平台,用于构建预约与会议预订系统。本技能为开发者提供集成指导,帮助将 Cal.com 的嵌入组件、REST API 和 Webhook 接入自己的应用,从而添加日程安排能力。

主要能力

嵌入组件(Embed Widget)

可在任意网站添加预约组件。资料给出 React 示例:使用 @calcom/embed-react 的 Cal 组件与 getCalApi,可配置主题、品牌色、布局(month_view、week_view、column_view)、是否隐藏事件类型详情,并可通过 config 预填访客姓名、邮箱与备注。还提供浮动按钮(floatingButton)示例,可设置按钮文字、颜色、文字颜色与位置。

REST API 集成

资料给出服务端 API 客户端示例,基础地址为 https://api.cal.com/v2,通过 Authorization: Bearer 与 cal-api-version 请求头调用。示例函数包括:创建事件类型(标题、slug、时长、描述、地点、自定义预订字段)、查询可用时段(按事件类型、起止时间、时区)、创建预订、取消预订、改期预订。

Webhook

可实时响应预订事件。资料给出 Next.js 路由示例,使用 x-cal-signature-256 请求头与 HMAC-SHA256 校验签名,并处理 BOOKING_CREATED、BOOKING_CANCELLED、BOOKING_RESCHEDULED、MEETING_ENDED 等事件,示例中演示了写入 CRM 与发送 Slack 通知。

团队可用性管理

资料给出团队排班配置示例:创建团队事件类型,设置 schedulingType: "ROUND_ROBIN" 轮询分配,配置 hosts(含固定参与成员)、会前/会后缓冲时间、最短预订提前量、时段间隔、地点(如自动创建 Zoom 会议);并通过 /schedules 设置工作时间、时区、默认排班与日期覆盖(如节假日不可用、特定日期仅上午可用)。

使用方式

安装:React 嵌入使用 npm install @calcom/embed-react;自托管 Cal.com(Docker)使用 git clone https://github.com/calcom/cal.com.git,进入目录后 cp .env.example .env,再执行 docker compose up -d。

资料中的指南建议:公开预约使用嵌入组件(自动处理时区、可用性与确认);固定 API 版本(携带 cal-api-version 请求头)以避免破坏性变更;始终校验 Webhook 签名;设置会前会后缓冲时间;预填已知数据;通过 metadata 传递归因信息;处理全部 Webhook 事件(取消与改期也需清理);如需数据驻留合规(GDPR、HIPAA)可自托管。

适用场景

适合需要在网站或应用中嵌入预约功能、以编程方式管理预订与可用性、对预订事件做实时响应(如同步 CRM、通知团队)、以及配置团队轮询排班的开发者。

限制

资料未提供具体收费、价格、平台支持范围、性能指标或效果承诺等信息,这些内容暂未提供。