Calendly

Calendly 是什么

将 Calendly API 接入 Agent，覆盖用户、事件类型、已排事件、受邀者、可用时段、忙闲、组织成员和 Webhook。

适用场景

适合销售演示、咨询预约、面试排期、客户成功和跨系统日程自动化。

核心能力与工作机制

清单提供 Maton 连接管理、读取事件与邀请人、查询可用时间、创建 invitee、取消事件、忙闲和 availability schedules 等接口示例。

执行流程

配置 MATON_API_KEY 并完成 Calendly OAuth，先读取当前用户和事件类型；查询有效可用时段，写操作前确认目标、时区和影响，再创建或取消并回查。

输入与输出

需要 Maton API Key、OAuth 连接、event type 或 event ID、受邀人资料、时区与期望时间。输出用户、事件类型、预约、受邀者和可用时间；写请求可创建受邀者、取消事件或管理连接。

依赖、账号与权限

依赖网络、Maton 服务、Calendly 账号与 MATON_API_KEY，受 Calendly 权限和限速约束。

副作用、限制与风险

日程与受邀者包含个人信息，时区错误会导致错约；取消或创建会发送真实日程影响。经确认可创建预约、取消事件、建立 Webhook 或删除授权连接。

不适用边界

所有写操作必须明确批准，不能选择无效时段、绕过组织权限或替用户承诺出席。

失败处理与验收

401 检查 Key 和连接，429 退避；创建超时后先查询事件避免重复邀请，时区冲突先重新确认。在 Calendly 和日历端核对事件类型、时间、时区、受邀者、状态与通知。

适合谁使用

适合销售、招聘、顾问、客户成功和自动化开发团队。

来源、版本与许可

本条目依据 SkillHub 热门榜、发布者详情和版本 1.0.4 的完整 SKILL.md 整理，核验日期为 2026 年 9 月 25 日。完整 SKILL.md 未声明许可证，公开可下载不代表可以任意复制、修改或再分发。 SkillHub 当前两套安全扫描状态为 benign、benign；该状态只是平台信号，不能替代对脚本、凭据、网络请求、数据外送与后续版本的人工审查。

常见问题

1. Calendly 主要解决什么问题？

将 Calendly API 接入 Agent，覆盖用户、事件类型、已排事件、受邀者、可用时段、忙闲、组织成员和 Webhook。适合销售演示、咨询预约、面试排期、客户成功和跨系统日程自动化。是否采用它，应以实际任务边界和可核验材料为准，不要因为榜单热度而跳过来源审查。

2. 开始前需要准备什么？

需要 Maton API Key、OAuth 连接、event type 或 event ID、受邀人资料、时区与期望时间。准备阶段不要代替用户猜测关键事实；缺少会改变路线、费用或权限的输入时，应先补齐再执行。

3. 它怎样完成任务并交付结果？

配置 MATON_API_KEY 并完成 Calendly OAuth，先读取当前用户和事件类型；查询有效可用时段，写操作前确认目标、时区和影响，再创建或取消并回查。每个阶段都要保留输入、决策、输出和检查点，不能把计划、预览或排队状态描述成最终交付。

4. 需要哪些工具、账号或权限？

依赖网络、Maton 服务、Calendly 账号与 MATON_API_KEY，受 Calendly 权限和限速约束。凭据应放在安全环境中，并按最小权限授权；账号、网络或本地依赖不满足时应明确停止条件。

5. 它会产生哪些外部操作或副作用？

经确认可创建预约、取消事件、建立 Webhook 或删除授权连接。涉及外部写入、上传、发送、付费或持久配置时，应在实际动作前说明影响范围并取得相应确认。

6. 哪些情况不适合使用？

所有写操作必须明确批准，不能选择无效时段、绕过组织权限或替用户承诺出席。超出来源明确能力、专业资质或授权范围时，应切换到更合适的工具或交给专业人员处理。

7. 失败或结果异常时怎样恢复？

401 检查 Key 和连接，429 退避；创建超时后先查询事件避免重复邀请，时区冲突先重新确认。恢复时优先查询已有任务、日志或备份，避免无上限重试、重复扣费、重复发送或覆盖唯一原件。

8. 如何验收结果并控制风险？

在 Calendly 和日历端核对事件类型、时间、时区、受邀者、状态与通知。验收应基于真实文件、页面、任务终态或权威来源，并把未能实际检查的部分明确标记出来。