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問題的回答、取消/重新排程的網址以及追蹤資料。以程式化方式建立受邀者，代表使用者預約會議（需要付費的 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，以避免與現有的行事曆區塊產生衝突，接著再選取符合使用者可用時間表的空閒時段。