Cal Com

Cal.comは、予約、イベントタイプ、チームの空き状況を簡単に管理できる、柔軟なスケジューリングプラットフォームです。

Cal.comでは、次のことができます。

スケジューリングの自動化: ユーザーが空き時間を確認し、メールのやり取りなしで自動的にミーティングを予約できます。
イベントの管理: 1対1またはグループミーティングのイベントタイプ、期間、ルールを作成およびカスタマイズできます。
カレンダーの統合: Google、Outlook、Appleなどのカレンダープロバイダーとシームレスに接続し、二重予約を回避できます。
参加者とゲストの管理: 参加者情報を収集し、ゲストを管理し、招待状やリマインダーを送信できます。
空き状況の制御: カスタム勤務時間、バッファ時間、キャンセル/再予約ルールを定義できます。
ワークフローの強化: 予約が作成、キャンセル、または再スケジュールされたときに、Webhookを介してカスタムアクションをトリガーできます。

Aptlystarでは、Cal.com統合により、エージェントがミーティングを予約し、空き状況を確認し、イベントタイプを管理し、スケジューリングタスクをプログラムで自動化できます。これにより、エージェントはミーティングを調整し、ユーザーに代わって予約を送信し、スケジュールを確認し、予約イベントに応答できます。すべて手動介入なしで実行されます。AptlystarとCal.comを接続することで、より広範な自動化ニーズとシームレスに統合できる、高度に自動化されたインテリジェントなスケジューリングワークフローを実現できます。

パラメータ	型	必須	説明
`eventTypeId`	number	はい	予約するイベントタイプのID
`start`	string	はい	UTC ISO 8601形式の開始時刻（例：2024-01-15T09:00:00Z）
`attendee`	object	はい	参加者情報オブジェクト（name、email、timeZone、およびオプションのphoneNumberを含む、個別の参加者フィールドから構築）
`guests`	array	いいえ	ゲストのメールアドレスの配列
`items`	string	いいえ	ゲストのメールアドレス
`lengthInMinutes`	number	いいえ	予約の時間（分単位、イベントタイプのデフォルトを上書き）
`metadata`	object	いいえ	予約に添付するカスタムメタデータ

出力

パラメータ	型	説明
`status`	string	レスポンスステータス
`data`	object	作成された予約の詳細
↳ `eventType`	object	イベントタイプの詳細
↳ `id`	number	イベントタイプID
↳ `slug`	string	イベントタイプのスラッグ
↳ `attendees`	array	参加者のリスト
↳ `name`	string	参加者名
↳ `email`	string	参加者の実際のメールアドレス
↳ `displayEmail`	string	公開表示されるメール（実際のメールと異なる場合あり）
↳ `timeZone`	string	参加者のタイムゾーン（IANA形式）
↳ `phoneNumber`	string	参加者の電話番号
↳ `language`	string	参加者の言語設定（ISOコード）
↳ `absent`	boolean	参加者が欠席したかどうか
↳ `hosts`	array	ホストのリスト
↳ `id`	number	ホストのユーザーID
↳ `name`	string	ホストの表示名
↳ `email`	string	ホストの実際のメールアドレス
↳ `displayEmail`	string	公開表示されるメール（実際のメールと異なる場合あり）
↳ `username`	string	ホストのCal.comユーザー名
↳ `timeZone`	string	ホストのタイムゾーン（IANA形式）
↳ `id`	number	数値の予約ID
↳ `uid`	string	予約の一意識別子
↳ `title`	string	予約のタイトル
↳ `status`	string	予約ステータス（例：accepted、pending、cancelled）
↳ `start`	string	ISO 8601形式の開始時刻
↳ `end`	string	ISO 8601形式の終了時刻
↳ `duration`	number	時間（分単位）
↳ `eventTypeId`	number	イベントタイプID
↳ `meetingUrl`	string	ミーティングに参加するためのURL
↳ `location`	string	予約の場所
↳ `absentHost`	boolean	ホストが欠席したかどうか
↳ `guests`	array	ゲストのメールアドレス
↳ `bookingFieldsResponses`	json	カスタム予約フィールドの回答（イベントタイプの設定に基づく動的キー）
↳ `metadata`	json	予約に添付されたカスタムメタデータ（動的なキーと値のペア）
↳ `icsUid`	string	ICSカレンダーUID
↳ `createdAt`	string	予約が作成された日時

`calcom_get_booking`

UIDによる特定の予約の詳細を取得

入力

パラメータ	型	必須	説明
`bookingUid`	string	はい	予約の一意識別子（UID）

出力

パラメータ	型	説明
`status`	string	レスポンスステータス
`data`	object	予約の詳細
↳ `eventType`	object	イベントタイプの詳細
↳ `id`	number	イベントタイプID
↳ `slug`	string	イベントタイプスラッグ
↳ `attendees`	array	参加者のリスト
↳ `name`	string	参加者名
↳ `email`	string	参加者の実際のメールアドレス
↳ `displayEmail`	string	公開表示されるメール（実際のメールと異なる場合がある）
↳ `timeZone`	string	参加者のタイムゾーン（IANA形式）
↳ `phoneNumber`	string	参加者の電話番号
↳ `language`	string	参加者の言語設定（ISOコード）
↳ `absent`	boolean	参加者が欠席したかどうか
↳ `hosts`	array	ホストのリスト
↳ `id`	number	ホストのユーザーID
↳ `name`	string	ホストの表示名
↳ `email`	string	ホストの実際のメールアドレス
↳ `displayEmail`	string	公開表示されるメール（実際のメールと異なる場合がある）
↳ `username`	string	ホストのCal.comユーザー名
↳ `timeZone`	string	ホストのタイムゾーン（IANA形式）
↳ `id`	number	数値の予約ID
↳ `uid`	string	予約の一意識別子
↳ `title`	string	予約のタイトル
↳ `description`	string	予約の説明
↳ `status`	string	予約ステータス（例：承認済み、保留中、キャンセル済み）
↳ `start`	string	ISO 8601形式の開始時刻
↳ `end`	string	ISO 8601形式の終了時刻
↳ `duration`	number	所要時間（分）
↳ `eventTypeId`	number	イベントタイプID
↳ `meetingUrl`	string	ミーティングに参加するためのURL
↳ `location`	string	予約の場所
↳ `absentHost`	boolean	ホストが欠席したかどうか
↳ `guests`	array	ゲストのメールアドレス
↳ `bookingFieldsResponses`	json	カスタム予約フィールドの回答（イベントタイプの設定に基づく動的キー）
↳ `metadata`	json	予約に添付されたカスタムメタデータ（動的なキーと値のペア）
↳ `rating`	number	予約の評価
↳ `icsUid`	string	ICSカレンダーUID
↳ `cancellationReason`	string	キャンセルされた場合のキャンセル理由
↳ `reschedulingReason`	string	再スケジュールされた場合の再スケジュール理由
↳ `rescheduledFromUid`	string	この予約が再スケジュールされた場合の元の予約UID
↳ `rescheduledToUid`	string	再スケジュール後の新しい予約UID
↳ `cancelledByEmail`	string	予約をキャンセルした人のメール
↳ `rescheduledByEmail`	string	予約を再スケジュールした人のメール
↳ `createdAt`	string	予約が作成された日時
↳ `updatedAt`	string	予約が最後に更新された日時

`calcom_list_bookings`

すべての予約を一覧表示（オプションでステータスフィルタ可能）

入力

パラメータ	型	必須	説明
`status`	string	いいえ	ステータスで予約をフィルタ: upcoming、recurring、past、cancelled、unconfirmed
`take`	number	いいえ	返す予約の数（ページネーション制限）
`skip`	number	いいえ	スキップする予約の数（ページネーションオフセット）

出力

パラメータ	型	説明
`status`	string	レスポンスステータス
`data`	array	予約の配列
↳ `eventType`	object	イベントタイプの詳細
↳ `id`	number	イベントタイプID
↳ `slug`	string	イベントタイプスラッグ
↳ `attendees`	array	参加者のリスト
↳ `name`	string	参加者名
↳ `email`	string	参加者の実際のメールアドレス
↳ `displayEmail`	string	公開表示されるメール（実際のメールと異なる場合あり）
↳ `timeZone`	string	参加者のタイムゾーン（IANA形式）
↳ `phoneNumber`	string	参加者の電話番号
↳ `language`	string	参加者の言語設定（ISOコード）
↳ `absent`	boolean	参加者が欠席したかどうか
↳ `hosts`	array	ホストのリスト
↳ `id`	number	ホストユーザーID
↳ `name`	string	ホスト表示名
↳ `email`	string	ホストの実際のメールアドレス
↳ `displayEmail`	string	公開表示されるメール（実際のメールと異なる場合あり）
↳ `username`	string	ホストのCal.comユーザー名
↳ `timeZone`	string	ホストのタイムゾーン（IANA形式）
↳ `id`	number	数値の予約ID
↳ `uid`	string	予約の一意識別子
↳ `title`	string	予約のタイトル
↳ `description`	string	予約の説明
↳ `status`	string	予約ステータス（例: accepted、pending、cancelled）
↳ `start`	string	ISO 8601形式の開始時刻
↳ `end`	string	ISO 8601形式の終了時刻
↳ `duration`	number	分単位の期間
↳ `eventTypeId`	number	イベントタイプID
↳ `meetingUrl`	string	ミーティングに参加するURL
↳ `location`	string	予約の場所
↳ `absentHost`	boolean	ホストが欠席したかどうか
↳ `guests`	array	ゲストのメールアドレス
↳ `bookingFieldsResponses`	json	カスタム予約フィールドの回答（イベントタイプ設定に基づく動的キー）
↳ `metadata`	json	予約に添付されたカスタムメタデータ（動的なキーと値のペア）
↳ `rating`	number	予約の評価
↳ `icsUid`	string	ICSカレンダーUID
↳ `cancellationReason`	string	キャンセルされた場合のキャンセル理由
↳ `cancelledByEmail`	string	予約をキャンセルした人のメール
↳ `reschedulingReason`	string	再スケジュールされた場合の再スケジュール理由
↳ `rescheduledByEmail`	string	予約を再スケジュールした人のメール
↳ `rescheduledFromUid`	string	この予約が再スケジュールされた場合の元の予約UID
↳ `rescheduledToUid`	string	再スケジュール後の新しい予約UID
↳ `createdAt`	string	予約が作成された日時
↳ `updatedAt`	string	予約が最後に更新された日時
`pagination`	object	ページネーションメタデータ
↳ `totalItems`	number	アイテムの総数
↳ `remainingItems`	number	現在のページ以降の残りアイテム数
↳ `returnedItems`	number	このレスポンスで返されたアイテム数
↳ `itemsPerPage`	number	ページあたりのアイテム数
↳ `currentPage`	number	現在のページ番号
↳ `totalPages`	number	ページの総数
↳ `hasNextPage`	boolean	次のページがあるかどうか
↳ `hasPreviousPage`	boolean	前のページがあるかどうか

`calcom_cancel_booking`

既存の予約をキャンセルする

入力

パラメータ	型	必須	説明
`bookingUid`	string	はい	キャンセルする予約の一意識別子（UID）
`cancellationReason`	string	いいえ	予約をキャンセルする理由

出力

パラメータ	型	説明
`status`	string	レスポンスステータス
`data`	object	キャンセルされた予約の詳細
↳ `eventType`	object	イベントタイプの詳細
↳ `id`	number	イベントタイプID
↳ `slug`	string	イベントタイプスラッグ
↳ `attendees`	array	参加者のリスト
↳ `name`	string	参加者名
↳ `email`	string	参加者の実際のメールアドレス
↳ `displayEmail`	string	公開表示されるメール（実際のメールと異なる場合がある）
↳ `timeZone`	string	参加者のタイムゾーン（IANA形式）
↳ `phoneNumber`	string	参加者の電話番号
↳ `language`	string	参加者の言語設定（ISOコード）
↳ `absent`	boolean	参加者が欠席したかどうか
↳ `hosts`	array	ホストのリスト
↳ `id`	number	ホストのユーザーID
↳ `name`	string	ホストの表示名
↳ `email`	string	ホストの実際のメールアドレス
↳ `displayEmail`	string	公開表示されるメール（実際のメールと異なる場合がある）
↳ `username`	string	ホストのCal.comユーザー名
↳ `timeZone`	string	ホストのタイムゾーン（IANA形式）
↳ `id`	number	数値の予約ID
↳ `uid`	string	予約の一意識別子
↳ `title`	string	予約のタイトル
↳ `cancellationReason`	string	キャンセルされた場合のキャンセル理由
↳ `cancelledByEmail`	string	予約をキャンセルした人のメール
↳ `start`	string	ISO 8601形式の開始時刻
↳ `end`	string	ISO 8601形式の終了時刻
↳ `duration`	number	分単位の所要時間
↳ `eventTypeId`	number	イベントタイプID
↳ `location`	string	予約の場所
↳ `metadata`	json	予約に添付されたカスタムメタデータ（動的なキーと値のペア）
↳ `createdAt`	string	予約が作成された日時
↳ `status`	string	予約ステータス（キャンセル済みである必要がある）

`calcom_reschedule_booking`

既存の予約を新しい時間に変更する

入力

パラメータ	型	必須	説明
`bookingUid`	string	はい	変更する予約の一意識別子（UID）
`start`	string	はい	UTC ISO 8601形式の新しい開始時刻（例：2024-01-15T09:00:00Z）
`reschedulingReason`	string	いいえ	予約を変更する理由

出力

パラメータ	型	説明
`status`	string	レスポンスステータス
`data`	object	変更された予約の詳細
↳ `eventType`	object	イベントタイプの詳細
↳ `id`	number	イベントタイプID
↳ `slug`	string	イベントタイプスラッグ
↳ `attendees`	array	参加者のリスト
↳ `name`	string	参加者名
↳ `email`	string	参加者の実際のメールアドレス
↳ `displayEmail`	string	公開表示されるメール（実際のメールと異なる場合がある）
↳ `timeZone`	string	参加者のタイムゾーン（IANA形式）
↳ `phoneNumber`	string	参加者の電話番号
↳ `language`	string	参加者の言語設定（ISOコード）
↳ `absent`	boolean	参加者が欠席したかどうか
↳ `hosts`	array	ホストのリスト
↳ `id`	number	ホストのユーザーID
↳ `name`	string	ホストの表示名
↳ `email`	string	ホストの実際のメールアドレス
↳ `displayEmail`	string	公開表示されるメール（実際のメールと異なる場合がある）
↳ `username`	string	ホストのCal.comユーザー名
↳ `timeZone`	string	ホストのタイムゾーン（IANA形式）
↳ `id`	number	数値の予約ID
↳ `title`	string	予約のタイトル
↳ `status`	string	予約ステータス（例：accepted、pending、cancelled）
↳ `reschedulingReason`	string	変更された場合の変更理由
↳ `rescheduledFromUid`	string	この予約が変更された場合の元の予約UID
↳ `rescheduledByEmail`	string	予約を変更した人のメール
↳ `duration`	number	所要時間（分）
↳ `eventTypeId`	number	イベントタイプID
↳ `meetingUrl`	string	ミーティングに参加するためのURL
↳ `location`	string	予約の場所
↳ `guests`	array	ゲストのメールアドレス
↳ `metadata`	json	予約に添付されたカスタムメタデータ（動的なキーと値のペア）
↳ `icsUid`	string	ICSカレンダーUID
↳ `createdAt`	string	予約が作成された日時
↳ `uid`	string	新しい予約の一意識別子
↳ `start`	string	ISO 8601形式の新しい開始時刻
↳ `end`	string	ISO 8601形式の新しい終了時刻

`calcom_confirm_booking`

確認が必要な保留中の予約を確定する

入力

パラメータ	型	必須	説明
`bookingUid`	string	はい	確定する予約の一意識別子(UID)

出力

パラメータ	型	説明
`status`	string	レスポンスステータス
`data`	object	確定された予約の詳細
↳ `eventType`	object	イベントタイプの詳細
↳ `id`	number	イベントタイプID
↳ `slug`	string	イベントタイプスラッグ
↳ `attendees`	array	参加者のリスト
↳ `name`	string	参加者名
↳ `email`	string	参加者の実際のメールアドレス
↳ `displayEmail`	string	公開表示されるメール(実際のメールと異なる場合がある)
↳ `timeZone`	string	参加者のタイムゾーン(IANA形式)
↳ `phoneNumber`	string	参加者の電話番号
↳ `language`	string	参加者の言語設定(ISOコード)
↳ `absent`	boolean	参加者が欠席したかどうか
↳ `hosts`	array	ホストのリスト
↳ `id`	number	ホストのユーザーID
↳ `name`	string	ホストの表示名
↳ `email`	string	ホストの実際のメールアドレス
↳ `displayEmail`	string	公開表示されるメール(実際のメールと異なる場合がある)
↳ `username`	string	ホストのCal.comユーザー名
↳ `timeZone`	string	ホストのタイムゾーン(IANA形式)
↳ `id`	number	数値の予約ID
↳ `uid`	string	予約の一意識別子
↳ `title`	string	予約のタイトル
↳ `start`	string	ISO 8601形式の開始時刻
↳ `end`	string	ISO 8601形式の終了時刻
↳ `duration`	number	所要時間(分)
↳ `eventTypeId`	number	イベントタイプID
↳ `meetingUrl`	string	ミーティングに参加するためのURL
↳ `location`	string	予約の場所
↳ `guests`	array	ゲストのメールアドレス
↳ `metadata`	json	予約に添付されたカスタムメタデータ(動的なキーと値のペア)
↳ `icsUid`	string	ICSカレンダーUID
↳ `createdAt`	string	予約が作成された日時
↳ `status`	string	予約ステータス(承認済み/確定済みである必要がある)

`calcom_decline_booking`

保留中の予約リクエストを拒否する

入力

パラメータ	型	必須	説明
`bookingUid`	string	はい	拒否する予約の一意識別子（UID）
`reason`	string	いいえ	予約を拒否する理由

出力

パラメータ	型	説明
`status`	string	レスポンスステータス
`data`	object	拒否された予約の詳細
↳ `eventType`	object	イベントタイプの詳細
↳ `id`	number	イベントタイプID
↳ `slug`	string	イベントタイプスラッグ
↳ `attendees`	array	参加者のリスト
↳ `name`	string	参加者名
↳ `email`	string	参加者の実際のメールアドレス
↳ `displayEmail`	string	公開表示されるメール（実際のメールと異なる場合がある）
↳ `timeZone`	string	参加者のタイムゾーン（IANA形式）
↳ `phoneNumber`	string	参加者の電話番号
↳ `language`	string	参加者の言語設定（ISOコード）
↳ `absent`	boolean	参加者が欠席したかどうか
↳ `hosts`	array	ホストのリスト
↳ `id`	number	ホストのユーザーID
↳ `name`	string	ホストの表示名
↳ `email`	string	ホストの実際のメールアドレス
↳ `displayEmail`	string	公開表示されるメール（実際のメールと異なる場合がある）
↳ `username`	string	ホストのCal.comユーザー名
↳ `timeZone`	string	ホストのタイムゾーン（IANA形式）
↳ `id`	number	数値の予約ID
↳ `uid`	string	予約の一意識別子
↳ `title`	string	予約のタイトル
↳ `cancellationReason`	string	キャンセルされた場合のキャンセル理由
↳ `start`	string	ISO 8601形式の開始時刻
↳ `end`	string	ISO 8601形式の終了時刻
↳ `duration`	number	分単位の期間
↳ `eventTypeId`	number	イベントタイプID
↳ `location`	string	予約の場所
↳ `metadata`	json	予約に添付されたカスタムメタデータ（動的なキーと値のペア）
↳ `createdAt`	string	予約が作成された日時
↳ `status`	string	予約ステータス（キャンセル済み/拒否済みである必要がある）

`calcom_create_event_type`

Cal.comで新しいイベントタイプを作成する

入力

パラメータ	型	必須	説明
`title`	string	はい	イベントタイプのタイトル
`slug`	string	はい	イベントタイプURLの一意のスラッグ
`lengthInMinutes`	number	はい	イベントの所要時間(分)
`description`	string	いいえ	イベントタイプの説明
`slotInterval`	number	いいえ	予約可能な時間枠の間隔(分)
`minimumBookingNotice`	number	いいえ	予約前に必要な最小通知時間(分)
`beforeEventBuffer`	number	いいえ	イベント前のバッファ時間(分)
`afterEventBuffer`	number	いいえ	イベント後のバッファ時間(分)
`scheduleId`	number	いいえ	空き状況に使用するスケジュールのID
`disableGuests`	boolean	いいえ	予約にゲストを追加できないようにするかどうか

出力

パラメータ	型	説明
`status`	string	レスポンスステータス
`data`	object	作成されたイベントタイプの詳細
↳ `id`	number	イベントタイプID
↳ `title`	string	イベントタイプのタイトル
↳ `slug`	string	イベントタイプのスラッグ
↳ `description`	string	イベントタイプの説明
↳ `lengthInMinutes`	number	所要時間(分)
↳ `slotInterval`	number	時間枠の間隔(分)
↳ `minimumBookingNotice`	number	最小予約通知時間(分)
↳ `beforeEventBuffer`	number	イベント前のバッファ(分)
↳ `afterEventBuffer`	number	イベント後のバッファ(分)
↳ `scheduleId`	number	スケジュールID
↳ `disableGuests`	boolean	ゲストが無効かどうか
↳ `createdAt`	string	作成日時のISOタイムスタンプ
↳ `updatedAt`	string	最終更新日時のISOタイムスタンプ

`calcom_get_event_type`

特定のイベントタイプに関する詳細情報を取得

入力

パラメータ	型	必須	説明
`eventTypeId`	number	はい	取得するイベントタイプID

出力

パラメータ	型	説明
`status`	string	レスポンスステータス
`data`	object	イベントタイプの詳細
↳ `id`	number	イベントタイプID
↳ `title`	string	イベントタイプのタイトル
↳ `slug`	string	イベントタイプのスラッグ
↳ `description`	string	イベントタイプの説明
↳ `lengthInMinutes`	number	所要時間(分)
↳ `slotInterval`	number	スロット間隔(分)
↳ `minimumBookingNotice`	number	最小予約通知時間(分)
↳ `beforeEventBuffer`	number	イベント前のバッファ時間(分)
↳ `afterEventBuffer`	number	イベント後のバッファ時間(分)
↳ `scheduleId`	number	スケジュールID
↳ `disableGuests`	boolean	ゲストが無効かどうか
↳ `createdAt`	string	作成日時のISOタイムスタンプ
↳ `updatedAt`	string	最終更新日時のISOタイムスタンプ

`calcom_list_event_types`

すべてのイベントタイプのリストを取得

入力

パラメータ	型	必須	説明
`sortCreatedAt`	string	いいえ	作成日でソート:"asc"または"desc"

出力

パラメータ	型	説明
`status`	string	レスポンスステータス
`data`	array	イベントタイプの配列
↳ `id`	number	イベントタイプID
↳ `title`	string	イベントタイプのタイトル
↳ `slug`	string	イベントタイプのスラッグ
↳ `description`	string	イベントタイプの説明
↳ `lengthInMinutes`	number	所要時間(分)
↳ `slotInterval`	number	スロット間隔(分)
↳ `minimumBookingNotice`	number	最小予約通知時間(分)
↳ `beforeEventBuffer`	number	イベント前のバッファ時間(分)
↳ `afterEventBuffer`	number	イベント後のバッファ時間(分)
↳ `scheduleId`	number	スケジュールID
↳ `disableGuests`	boolean	ゲストが無効かどうか
↳ `createdAt`	string	作成日時(ISO形式)
↳ `updatedAt`	string	最終更新日時(ISO形式)

`calcom_update_event_type`

Cal.comで既存のイベントタイプを更新する

入力

パラメータ	型	必須	説明
`eventTypeId`	number	はい	更新するイベントタイプID(例: 12345)
`title`	string	いいえ	イベントタイプのタイトル
`slug`	string	いいえ	イベントタイプURLの一意のスラッグ
`lengthInMinutes`	number	いいえ	イベントの所要時間(分)
`description`	string	いいえ	イベントタイプの説明
`slotInterval`	number	いいえ	予約可能なスロット間の間隔(分)
`minimumBookingNotice`	number	いいえ	予約前に必要な最小通知時間(分)
`beforeEventBuffer`	number	いいえ	イベント前のバッファ時間(分)
`afterEventBuffer`	number	いいえ	イベント後のバッファ時間(分)
`scheduleId`	number	いいえ	空き状況に使用するスケジュールのID
`disableGuests`	boolean	いいえ	予約にゲストを追加できないようにするかどうか

出力

パラメータ	型	説明
`status`	string	レスポンスステータス
`data`	object	更新されたイベントタイプの詳細
↳ `id`	number	イベントタイプID
↳ `title`	string	イベントタイプのタイトル
↳ `slug`	string	イベントタイプのスラッグ
↳ `description`	string	イベントタイプの説明
↳ `lengthInMinutes`	number	所要時間(分)
↳ `slotInterval`	number	スロット間隔(分)
↳ `minimumBookingNotice`	number	最小予約通知時間(分)
↳ `beforeEventBuffer`	number	イベント前のバッファ時間(分)
↳ `afterEventBuffer`	number	イベント後のバッファ時間(分)
↳ `scheduleId`	number	スケジュールID
↳ `disableGuests`	boolean	ゲストが無効かどうか
↳ `createdAt`	string	作成日時(ISO形式)
↳ `updatedAt`	string	最終更新日時(ISO形式)

`calcom_delete_event_type`

Cal.comからイベントタイプを削除する

入力

パラメータ	型	必須	説明
`eventTypeId`	number	はい	削除するイベントタイプID

出力

パラメータ	型	説明
`status`	string	レスポンスステータス
`data`	object	削除されたイベントタイプの詳細
↳ `id`	number	イベントタイプID
↳ `lengthInMinutes`	number	所要時間(分)
↳ `title`	string	イベントタイプのタイトル
↳ `slug`	string	イベントタイプのスラッグ

`calcom_create_schedule`

Cal.comで新しい空き時間スケジュールを作成する

入力

パラメータ	型	必須	説明
`name`	string	はい	スケジュールの名前
`timeZone`	string	はい	スケジュールのタイムゾーン（例：America/New_York）
`isDefault`	boolean	はい	このスケジュールをデフォルトにするかどうか
`availability`	array	いいえ	スケジュールの空き時間間隔
`items`	object	いいえ	空き時間間隔
`properties`	array	いいえ	曜日（月曜日、火曜日、水曜日、木曜日、金曜日、土曜日、日曜日）
`days`	array	いいえ	曜日（月曜日、火曜日、水曜日、木曜日、金曜日、土曜日、日曜日）
`startTime`	string	いいえ	HH:MM形式の開始時刻
`endTime`	string	いいえ	HH:MM形式の終了時刻

出力

パラメータ	型	説明
`status`	string	レスポンスステータス
`data`	object	作成されたスケジュールデータ
↳ `id`	number	スケジュールID
↳ `ownerId`	number	所有者ユーザーID
↳ `name`	string	スケジュール名
↳ `timeZone`	string	タイムゾーン（例：America/New_York）
↳ `isDefault`	boolean	デフォルトスケジュールかどうか
↳ `availability`	array	空き時間ウィンドウ
↳ `days`	array	曜日（月曜日、火曜日など）
↳ `startTime`	string	HH:MM形式の開始時刻
↳ `endTime`	string	HH:MM形式の終了時刻
↳ `overrides`	array	日付固有の空き時間オーバーライド
↳ `date`	string	YYYY-MM-DD形式の日付
↳ `startTime`	string	HH:MM形式の開始時刻
↳ `endTime`	string	HH:MM形式の終了時刻

`calcom_get_schedule`

Cal.comから特定のスケジュールをIDで取得

入力

パラメータ	型	必須	説明
`scheduleId`	string	はい	取得するスケジュールのID

出力

パラメータ	型	説明
`status`	string	レスポンスステータス
`data`	object	スケジュールデータ
↳ `id`	number	スケジュールID
↳ `ownerId`	number	オーナーユーザーID
↳ `name`	string	スケジュール名
↳ `timeZone`	string	タイムゾーン（例：America/New_York）
↳ `isDefault`	boolean	デフォルトスケジュールかどうか
↳ `availability`	array	空き時間枠
↳ `days`	array	曜日（月曜日、火曜日など）
↳ `startTime`	string	HH:MM形式の開始時刻
↳ `endTime`	string	HH:MM形式の終了時刻
↳ `overrides`	array	日付固有の空き時間上書き
↳ `date`	string	YYYY-MM-DD形式の日付
↳ `startTime`	string	HH:MM形式の開始時刻
↳ `endTime`	string	HH:MM形式の終了時刻

`calcom_list_schedules`

Cal.comからすべての空き時間スケジュールを一覧表示

入力

パラメータ	型	必須	説明

出力

パラメータ	型	説明
`status`	string	レスポンスステータス
`data`	array	スケジュールオブジェクトの配列
↳ `id`	number	スケジュールID
↳ `ownerId`	number	オーナーユーザーID
↳ `name`	string	スケジュール名
↳ `timeZone`	string	タイムゾーン（例：America/New_York）
↳ `isDefault`	boolean	デフォルトスケジュールかどうか
↳ `availability`	array	空き時間枠
↳ `days`	array	曜日（月曜日、火曜日など）
↳ `startTime`	string	HH:MM形式の開始時刻
↳ `endTime`	string	HH:MM形式の終了時刻
↳ `overrides`	array	日付固有の空き時間上書き
↳ `date`	string	YYYY-MM-DD形式の日付
↳ `startTime`	string	HH:MM形式の開始時刻
↳ `endTime`	string	HH:MM形式の終了時刻

`calcom_update_schedule`

Cal.comで既存のスケジュールを更新する

入力

パラメータ	型	必須	説明
`scheduleId`	string	はい	更新するスケジュールのID
`name`	string	いいえ	スケジュールの新しい名前
`timeZone`	string	いいえ	スケジュールの新しいタイムゾーン（例：America/New_York）
`isDefault`	boolean	いいえ	このスケジュールをデフォルトにするかどうか
`availability`	array	いいえ	スケジュールの新しい利用可能時間帯
`items`	object	いいえ	利用可能時間帯
`properties`	array	いいえ	曜日（月曜日、火曜日、水曜日、木曜日、金曜日、土曜日、日曜日）
`days`	array	いいえ	曜日（月曜日、火曜日、水曜日、木曜日、金曜日、土曜日、日曜日）
`startTime`	string	いいえ	HH:MM形式の開始時刻
`endTime`	string	いいえ	HH:MM形式の終了時刻

出力

パラメータ	型	説明
`status`	string	レスポンスステータス
`data`	object	更新されたスケジュールデータ
↳ `id`	number	スケジュールID
↳ `ownerId`	number	所有者のユーザーID
↳ `name`	string	スケジュール名
↳ `timeZone`	string	タイムゾーン（例：America/New_York）
↳ `isDefault`	boolean	これがデフォルトのスケジュールかどうか
↳ `availability`	array	利用可能時間帯
↳ `days`	array	曜日（月曜日、火曜日など）
↳ `startTime`	string	HH:MM形式の開始時刻
↳ `endTime`	string	HH:MM形式の終了時刻
↳ `overrides`	array	日付固有の利用可能時間の上書き
↳ `date`	string	YYYY-MM-DD形式の日付
↳ `startTime`	string	HH:MM形式の開始時刻
↳ `endTime`	string	HH:MM形式の終了時刻

`calcom_delete_schedule`

Cal.comからスケジュールを削除

入力

パラメータ	型	必須	説明
`scheduleId`	string	はい	削除するスケジュールのID

出力

パラメータ	型	説明
`status`	string	レスポンスステータス（成功またはエラー）

`calcom_get_default_schedule`

Cal.comからデフォルトの空き時間スケジュールを取得

入力

パラメータ	型	必須	説明

出力

パラメータ	型	説明
`status`	string	レスポンスステータス
`data`	object	デフォルトスケジュールデータ
↳ `id`	number	スケジュールID
↳ `ownerId`	number	所有者ユーザーID
↳ `name`	string	スケジュール名
↳ `timeZone`	string	タイムゾーン（例：America/New_York）
↳ `isDefault`	boolean	これがデフォルトスケジュールかどうか
↳ `availability`	array	空き時間枠
↳ `days`	array	曜日（月曜日、火曜日など）
↳ `startTime`	string	HH:MM形式の開始時刻
↳ `endTime`	string	HH:MM形式の終了時刻
↳ `overrides`	array	日付固有の空き時間上書き
↳ `date`	string	YYYY-MM-DD形式の日付
↳ `startTime`	string	HH:MM形式の開始時刻
↳ `endTime`	string	HH:MM形式の終了時刻

`calcom_get_slots`

Cal.comのイベントタイプで、指定した時間範囲内の予約可能なスロットを取得します

入力

パラメータ	型	必須	説明
`start`	string	はい	UTC ISO 8601形式での時間範囲の開始時刻（例：2024-01-15T00:00:00Z）
`end`	string	はい	UTC ISO 8601形式での時間範囲の終了時刻（例：2024-01-22T00:00:00Z）
`eventTypeId`	number	いいえ	直接検索用のイベントタイプID
`eventTypeSlug`	string	いいえ	イベントタイプのスラッグ（usernameの設定が必要）
`username`	string	いいえ	個人用イベントタイプのユーザー名（eventTypeSlug使用時は必須）
`timeZone`	string	いいえ	返されるスロットのタイムゾーン（デフォルトはUTC）
`duration`	number	いいえ	スロットの長さ（分単位）

出力

パラメータ	型	説明
`status`	string	レスポンスステータス
`data`	json	日付ごとにグループ化された利用可能な時間スロット（YYYY-MM-DD形式のキー）。各日付は、開始時刻、オプションの終了時刻、および座席制イベント情報を含むスロットオブジェクトの配列にマッピングされます。

Cal Com

On this page