Calendly

• 您希望 AI 智能体在建议会议时间之前检查用户的 Calendly 可用性。
• 您需要以编程方式列出、检索或取消已安排的活动，作为工作流的一部分。
• 您正在构建一个自动化流程，通过设置或管理 Calendly Webhook（invitee.created、invitee.canceled）来响应预订活动。
• 您需要通过针对已知活动类型创建受邀者来以编程方式预订会议（需要付费的 Calendly 计划）。

• 您需要创建或修改事件类型 — Calendly API 不支持此功能，此技能也不支持。
• 您需要在单次请求中获取超过 7 天的可用时间窗口 — 可用性端点强制执行此限制。
• 您使用的是 Calendly 免费计划，并且需要 Webhook 或排程（受邀者创建）API — 这些功能需要付费计划。

所有请求均通过 gateway.maton.ai 进行代理，该网关会自动注入您的 Calendly OAuth 令牌。您只需使用 MATON_API_KEY 完成一次身份验证，无需自行管理 OAuth 刷新流程。

列出、检索和取消已计划的事件，支持按状态、受邀者邮箱、时间范围和用户进行丰富的筛选。使用 page_token 对大量结果集进行分页浏览。

查询特定事件类型的可用时间段（/event_type_available_times），或获取用户的忙碌时间段（/user_busy_times）及已配置的可用性日程安排——每次请求最多支持 7 天的数据。

列出并查看任何已安排活动的受邀者信息，包括他们对intake问题的回答、取消/重新安排的URL以及跟踪数据。以编程方式创建受邀者，代表用户预约会议（需要付费 Calendly 计划）。

创建、列出和删除限定于用户或组织范围的 Webhook 订阅。支持的事件包括 invitee.created、invitee.canceled 和 routing_form_submission.created（需要付费 Calendly 计划）。

在一个 MATON_API_KEY 下管理多个 Calendly OAuth 连接。通过 Maton-Connection 请求头为每个请求指定特定连接，或让网关使用默认活动连接。

一个智能代理会检查用户在未来 5 天内的 Calendly 可用时间段，在聊天界面中展示可选选项，并通过创建受邀者来预订所选时间段——整个过程无需用户离开对话界面。

每日自动化流程会拉取销售团队的所有活跃已排期活动，并以受邀者详情和预约问卷答案对其进行丰富，然后将结构化简报发布至 Slack 或 CRM。

为组织注册 invitee.created 和 invitee.canceled 事件的 Webhook，然后在预约发生变更时触发下游操作（发送确认邮件、更新数据库、通知 Slack 频道）。

在自动调度周期性任务或提醒之前，代理会查询 user_busy_times 以避免与现有日历块发生冲突，然后选择符合用户可用时间安排的空闲时间窗口。