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日間対応。

スケジュールされたイベントの招待者を一覧表示および確認できます。確認できる情報には、受付質問への回答、キャンセル・再スケジュールURL、トラッキングデータなどが含まれます。ユーザーの代わりにミーティングを予約するために、プログラムで招待者を作成することも可能です（Calendlyの有料プランが必要です）。

ユーザーまたは組織にスコープされたWebhookサブスクリプションの作成、一覧表示、および削除を行います。サポートされているイベントには、invitee.created、invitee.canceled、および routing_form_submission.created が含まれます（Calendlyの有料プランが必要です）。

1つのMATON_API_KEYで複数のCalendly OAuth接続を管理できます。Maton-Connectionヘッダーを使用してリクエストごとに特定の接続を指定するか、ゲートウェイがデフォルトのアクティブな接続を使用するように設定できます。

エージェントがユーザーの今後5日間の空き Calendly スロットを確認し、チャットインターフェース上で選択肢を提示します。そして、ユーザーが会話を離れることなく、招待者を作成することで選択したスロットを予約します。

日次の自動化により、営業チームのすべてのアクティブな予定イベントを取得し、招待者の詳細と受付回答で情報を補完した上で、構造化されたブリーフィングをSlackまたはCRMに投稿します。

組織の invitee.created および invitee.canceled イベントに対してWebhookを登録し、予約が変更されるたびに下流のアクション（確認メールの送信、データベースの更新、Slackチャンネルへの通知）をトリガーします。

定期的なタスクやリマインダーを自動スケジュールする前に、エージェントは user_busy_times を照会して既存のカレンダーブロックとの競合を回避し、ユーザーの空き時間スケジュールに合った空き枠を選択します。