Calendly (プレビュー)
Calendly のコネクタを使用すると、スケジュールされたイベントを自動化し、自動化されたワークフローを通じて生産性を向上させ、効率を最適化できます。
このコネクタは、次の製品および地域で利用可能です:
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure 中国の地域 - 国防総省 (DoD) |
| Power Automate | プレミアム | 以下を除くすべての Power Automate 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運用する中国のクラウド - 国防総省 (DoD) |
| Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - 米国政府 (GCC) - 米国政府 (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| お問い合わせ先 | |
|---|---|
| 件名 | Calendly のサポート |
| [URL] | https://help.calendly.com/hc/en-us |
| メール | support@calendly.com |
| Connector Metadata | |
|---|---|
| 発行者 | カレンドリー |
| Web サイト | https://calendly.com |
| プライバシー ポリシー | https://calendly.com/privacy |
| カテゴリー | 生産性 |
接続を作成する
コネクタは、次の認証タイプをサポートしています:
| 既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 件名 | タイプ | Description | Required |
|---|---|---|---|
| 個人用アクセス トークン | securestring | この API のための個人用アクセス トークン | True |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| イベントの種類を取得する |
特定のイベントの種類に関する情報を返します。 |
| イベントの種類を取得する |
組織に関連付けられたイベントの種類をすべて返します。 |
| 招待者欠席を作成する |
招待者を欠席としてマークします。 |
| 招待者欠席を削除する |
招待者を欠席とマークした操作を元に戻す |
イベントの種類を取得する
特定のイベントの種類に関する情報を返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
イベントの種類 UUID
|
uuid | True | string |
要求されるイベントの種類の UUID |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
resource
|
resource | EventType |
イベントの種類を取得する
組織に関連付けられたイベントの種類をすべて返します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
アクティブです
|
active | boolean |
true の場合はアクティブなイベント タイプのみを返し、false の場合は非アクティブなイベント タイプのみを返し、このパラメータが省略された場合はすべてのイベント タイプを返します。 |
|
|
数
|
count | integer |
返す行数。 |
|
|
ページ トークン
|
page_token | string |
コレクションの次または前の部分を取得するために渡すトークン。 |
|
|
管理者管理
|
admin_managed | boolean |
true の場合は管理者管理のイベント タイプのみを返し、false の場合は管理者管理のイベント タイプを除外し、このパラメーターが省略された場合はすべてのイベント タイプを含めます。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
収集
|
collection | array of EventType |
収集 |
|
改ページ数
|
pagination.count | integer |
返す行数。 |
|
次のページの URI
|
pagination.next_page | string |
順序付きリストの次のページを返す URI (「null」は追加の結果が利用できないことを示します)。 |
|
前のページの URI
|
pagination.previous_page | string |
順序付きリストの前のページを返す URI (「null」は追加の結果が利用できないことを示します)。 |
|
次のページのトークン
|
pagination.next_page_token | string |
順序付きリストの次のページを返すトークン (「null」は追加の結果が利用できないことを示します)。 |
|
前のページのトークン
|
pagination.previous_page_token | string |
順序付きリストの前のページを返すトークン (「null」は追加の結果が利用できないことを示します)。 |
招待者欠席を作成する
招待者を欠席としてマークします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
招待者の URL
|
invitee | True | string |
スケジュールされたイベントに対して欠席としてマークされている招待者の URI |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
欠席 URI
|
resource.uri | string |
欠席の正規参照 (一意の識別子) |
|
招待者の URL
|
resource.invitee | string |
関連招待者の正規参照 (一意の識別子) |
|
作成日
|
resource.created_at | string |
欠席が作成された瞬間 |
招待者欠席を削除する
招待者を欠席とマークした操作を元に戻す
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
招待者欠席 UUID
|
uuid | True | string |
欠席レコードが削除される招待者の UUID |
戻り値
欠席が正常に削除されました
- 204
- string
トリガー
| Webhook サブスクリプションの作成 (ルーティング フォームの送信) |
ルーティング フォームが送信されたときにトリガーされる、組織の Webhook サブスクリプションを作成します。 |
| Webhook サブスクリプションの作成 (招待者) |
イベントがスケジュールされたとき、キャンセルされたときにトリガーされる、組織の Webhook サブスクリプションを作成します。 |
Webhook サブスクリプションの作成 (ルーティング フォームの送信)
ルーティング フォームが送信されたときにトリガーされる、組織の Webhook サブスクリプションを作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
events
|
events | True | array of string |
events |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Webhook が作成された時間
|
created_at | string |
Webhook が作成された瞬間 (例: "2020-01-02T03:04:05.678123Z")。 |
|
Webhook 作成者 URL
|
created_by | string |
Webhook サブスクリプションを作成したユーザーへの参照。 |
|
Webhook イベント
|
event | string |
webhook が発生する原因となったイベント。 |
|
フォーム送信 URL ルーティング
|
payload.uri | string |
ルーティング フォーム送信の正規参照 (一意の識別子)。 |
|
ルーティング フォーム URI
|
payload.routing_form | string |
送信に関連付けられたルーティング フォームの URI。 |
|
questions_and_answers
|
payload.questions_and_answers | array of object |
questions_and_answers |
|
質問 UUID
|
payload.questions_and_answers.question_uuid | string |
ルーティング フォーム質問の一意識別子。 |
|
Question
|
payload.questions_and_answers.question | string |
質問名 (人間が判読できる形式)。 |
|
Answer
|
payload.questions_and_answers.answer | string |
フォームの送信時に回答者が提供した回答。 |
|
UTM キャンペーン
|
payload.tracking.utm_campaign | string |
キャンペーンの追跡に使用される UTM パラメータ。 |
|
UTM ソース
|
payload.tracking.utm_source | string |
ソース (トラフィックの発信元のプラットフォーム) を識別する UTM パラメータ。 |
|
UTM 媒体
|
payload.tracking.utm_medium | string |
入力のタイプを識別する UTM パラメータ (クリック単価 (CPC)、ソーシャル メディア、アフィリエイト、QR コードなど)。 |
|
UTM コンテンツ
|
payload.tracking.utm_content | string |
UTM コンテンツ追跡パラメーター。 |
|
UTM 用語
|
payload.tracking.utm_term | string |
キーワードの追跡に使用される UTM パラメータ。 |
|
Salesforce UUID
|
payload.tracking.salesforce_uuid | string |
Salesforce レコードの一意識別子。 |
|
結果の種類
|
payload.result.type | string |
ルーティング フォームの送信の結果がカスタム メッセージ、イベント タイプ、または外部 URL のいずれになったかを示します。 |
|
送信者 URI
|
payload.submitter | string |
フォーム送信をルーティングする際の招待者リソースへの参照により、スケジュールされたミーティングが行われます。 |
|
送信者の種類
|
payload.submitter_type | string |
フォームを送信し、ミーティングをスケジュールした回答者リソースのタイプ。 |
|
ルーティング フォームの送信作成場所
|
payload.created_at | string |
ルーティング フォームが送信された瞬間。 |
|
ルーティング フォームの送信更新場所
|
payload.updated_at | string |
ルーティング フォームの送信が最後に更新された瞬間。 |
Webhook サブスクリプションの作成 (招待者)
イベントがスケジュールされたとき、キャンセルされたときにトリガーされる、組織の Webhook サブスクリプションを作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
events
|
events | True | array of string |
events |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Webhook が作成された時間
|
created_at | string |
Webhook が作成された瞬間 (例: "2020-01-02T03:04:05.678123Z")。 |
|
Webhook 作成者 URL
|
created_by | string |
Webhook サブスクリプションを作成したユーザーへの参照。 |
|
Webhook イベント
|
event | string |
webhook が発生する原因となったイベント。 |
|
イベント URL のキャンセル
|
payload.cancel_url | string |
招待者のイベントをキャンセルするためのリンク。 |
|
招待者が作成された時間
|
payload.created_at | string |
イベントが作成された瞬間 (例: "2020-01-02T03:04:05.678123Z")。 |
|
招待者のメール
|
payload.email | string |
招待者の電子メール アドレス。 |
|
イベントの URI
|
payload.event | string |
イベントへの参照です。 |
|
招待者名
|
payload.name | string |
招待客の名前。 |
|
招待者の名
|
payload.first_name | string |
名と姓に別々のフィールドを使用するようにイベント タイプが設定されている場合、イベントを予約した招待者の 名。 イベント タイプが名前に単一のフィールドを使用するように構成されている場合は null。 |
|
招待者の姓
|
payload.last_name | string |
名と姓に別々のフィールドを使用するようにイベント タイプが設定されている場合、イベントを予約した招待者の姓。 イベント タイプが名前に単一のフィールドを使用するように構成されている場合は null。 |
|
新しい招待者の URI
|
payload.new_invitee | string |
再スケジュール後の新しい招待者へのリンク。 |
|
古い招待者 URI
|
payload.old_invitee | string |
再スケジュールされた古い招待者インスタンスへの参照。 |
|
イベント予約確認フォームの質問に対する招待者の回答をまとめたもの
|
payload.questions_and_answers | array of object |
イベント予約確認フォームの質問に対する招待者の回答をまとめたもの。 |
|
Question
|
payload.questions_and_answers.question | string |
招待者の予約フォームに関する質問。 |
|
Answer
|
payload.questions_and_answers.answer | string |
質問に対する招待者の答え。 |
|
質問の立場
|
payload.questions_and_answers.position | number |
予約フォーム上の他の質問に対する質問の位置。 |
|
イベント URL の再スケジュール
|
payload.reschedule_url | string |
招待者のイベントを再スケジュールするためのリンク。 |
|
招待者は再スケジュールされたか?
|
payload.rescheduled | boolean |
スケジュール済み |
|
招待者の状況
|
payload.status | string |
ステータス |
|
招待者テキストリマインダー番号
|
payload.text_reminder_number | string |
text_reminder_number |
|
招待者のタイムゾーン
|
payload.timezone | string |
タイムゾーン |
|
UTM キャンペーン
|
payload.tracking.utm_campaign | string |
キャンペーンの追跡に使用される UTM パラメータ。 |
|
UTM ソース
|
payload.tracking.utm_source | string |
ソース (トラフィックの発信元のプラットフォーム) を識別する UTM パラメータ。 |
|
UTM 媒体
|
payload.tracking.utm_medium | string |
入力のタイプを識別する UTM パラメータ (クリック単価 (CPC)、ソーシャル メディア、アフィリエイト、QR コードなど)。 |
|
UTM コンテンツ
|
payload.tracking.utm_content | string |
UTM コンテンツ追跡パラメーター。 |
|
UTM 用語
|
payload.tracking.utm_term | string |
キーワードの追跡に使用される UTM パラメータ。 |
|
Salesforce UUID
|
payload.tracking.salesforce_uuid | string |
Salesforce レコードの一意識別子。 |
|
招待者の URL
|
payload.uri | string |
招待者の正規参照 (一意の識別子)。 |
|
フォーム送信 URL ルーティング
|
payload.routing_form_submission | string |
招待者を予約ページにリダイレクトするルーティング フォーム送信への参照。 |
|
scheduled_event
|
payload.scheduled_event | ScheduledEvent | |
|
キャンセル
|
payload.cancellation | Cancellation |
イベント中止に関するデータを提供します |
|
支払
|
payload.payment | Payment |
招待者の支払い |
|
no_show
|
payload.no_show | NoShow |
招待者の関連するノーショウに関するデータを提供します。 |
|
再確認
|
payload.reconfirmation | Reconfirmation |
イベント タイプに対して再確認が有効になっていると仮定すると、再確認が要求されると、このオブジェクトは |
定義
ScheduledEvent
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
イベントの URI
|
uri | uri |
リソースの招待者の正規参照 (一意の識別子)。 |
|
Event Name
|
name | string |
イベント名。 |
|
イベント ステータス
|
status | string |
イベントが "アクティブ" か "キャンセル" かを示します。 |
|
イベント開始時刻
|
start_time | date-time |
イベントの開始が UTC 時間でスケジュールされた瞬間 (例: "2020-01-02T03:04:05.678123Z")。 |
|
イベントの終了時刻
|
end_time | date-time |
イベントの終了が UTC 時間でスケジュールされた瞬間 (例: "2020-01-02T03:04:05.678123Z") |
|
イベント種類 URL
|
event_type | uri |
このイベントに関連付けられたイベントの種類 |
|
location
|
location | Location |
Calendly がサポートするイベント場所の多態性基本タイプ |
|
招待者の合計
|
invitees_counter.total | number |
イベントの招待者の合計 (キャンセルした招待者を含む) |
|
アクティブな招待者の合計
|
invitees_counter.active | number |
キャンセルしなかった招待者の合計。 |
|
イベントの最大招待者数
|
invitees_counter.limit | number |
イベントを予約できるアクティブな招待者の最大数。 |
|
イベントが作成された時間
|
created_at | date-time |
イベントが作成された瞬間 (例: "2020-01-02T03:04:05.678123Z") |
|
イベントが作成された時間
|
updated_at | date-time |
イベントが最後に更新された瞬間 (例: "2020-01-02T03:04:05.678123Z") |
|
event_memberships
|
event_memberships | array of object |
イベントのメンバーシップ リスト |
|
イベント メンバー URL
|
event_memberships.user | uri |
ユーザーの正規参照 (一意の識別子)。 |
|
イベントメンバーのメール
|
event_memberships.user_email |
ユーザーの電子メール アドレスです。 |
|
|
event_guests
|
event_guests | array of Guest |
招待者によってイベントに追加された人 |
|
キャンセル
|
cancellation | Cancellation |
イベント中止に関するデータを提供します |
|
カレンダーのイベント
|
calendar_event | LegacyCalendarEvent |
カレンダープロバイダーからのカレンダーイベントに関する情報。 |
キャンセル
イベント中止に関するデータを提供します
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
キャンセル者
|
canceled_by | string |
キャンセルした人の名前。 |
|
キャンセルの理由
|
reason | string |
キャンセルが発生した理由。 |
|
キャンセルした人の種類
|
canceler_type | string |
イベントが "主催者" または "招待者" によってキャンセルされたかどうかを示します。 |
ゲスト
招待者がイベントのゲスト出席者として招待した個人
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
イベント ゲストのメール
|
イベント ゲストのメール。 |
||
|
イベント ゲストが作成された時間
|
created_at | date-time |
イベント ゲストが作成された時間。 |
|
イベント ゲストの更新時刻
|
updated_at | date-time |
イベント ゲストが最後に更新された時間。 |
場所
Calendly がサポートするイベント場所の多態性基本タイプ
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
場所の種類
|
type | string |
イベントの場所のタイプを示します。 |
|
Web 会議の状況
|
status | string |
このフィールドは、zoom_conference、webex_conference、google_conference、gotomeeting、Microsoft_teams_conference の場所の種類にのみ適用されます。 |
|
Web 会議 ミーティング URL
|
join_url | uri |
このフィールドは、zoom_conference、webex_conference、google_conference、gotomeeting、Microsoft_teams_conference の場所の種類にのみ適用されます。 |
|
イベントの場所
|
location | string |
このフィールドは、outbound_call、inbound_call、physical、ask_invitee、およびカスタムの場所のタイプにのみ適用されます。 |
LegacyCalendarEvent
カレンダープロバイダーからのカレンダーイベントに関する情報。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
カレンダーイベントの種類
|
kind | string |
イベントが属するカレンダープロバイダーを示します。 |
|
外部カレンダーイベント ID
|
external_id | string |
このカレンダー イベントに対してカレンダー プロバイダーから提供された ID。 |
支払い
招待者の支払い
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
支払の外部 ID
|
external_id | string |
支払の一意識別子。 |
|
支払プロバイダー
|
provider | string |
支払プロバイダー。 |
|
支払金額
|
amount | float |
支払のの金額。 |
|
支払通貨
|
currency | string |
支払をおこなう通貨フォーマット。 |
|
支払条件
|
terms | string |
支払いの契約条件。 |
|
支払い完了？
|
successful | boolean |
支払が正常に処理されたかどうかを示します。 |
NoShow
招待者の関連するノーショウに関するデータを提供します。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
欠席 URI
|
uri | string |
欠席の正規参照 (一意の識別子) |
|
欠席が作成された時間
|
created_at | date-time |
欠席が作成された瞬間。 |
EventType
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
イベント種類 URL
|
uri | string |
イベントの種類の招待者の正規参照 (一意の識別子)。 |
|
イベントの種類名
|
name | string |
イベントの種類名 (人間が判読できる形式)。 |
|
アクティブです
|
active | boolean |
イベントがアクティブかどうかを示します。 |
|
予約方法
|
booking_method | string |
イベントの種類が投票用かインスタント予約用かを示します。 |
|
Slug
|
slug | string |
特定の Web ページを識別するイベントの種類の URL の部分 (人間が判読できる形式)。 |
|
スケジュール URL
|
scheduling_url | string |
招待者がこのイベントの種類を予約するユーザーのスケジュール サイトの URL。 |
|
長さ
|
duration | integer |
このイベントの種類で予約されたセッションの長さ。 |
|
種類
|
kind | string |
イベントのタイプが「ソロ」(個々のユーザーに属する) か「グループ」かを示します。 |
|
投票の種類
|
pooling_type | string |
イベントの種類が「ラウンド ロビン」(主催者間で交互に行われる)、「集合」(招待者はすべての参加者が参加可能な時間を選択する)、または「null」(イベントの種類はグループ参加者の参加可能性を考慮しない) であるかどうかを示します。 |
|
タイプ
|
type | string |
イベントの種類が「AdhocEventType」 (アドホック イベント) か「StandardEventType」 (標準イベント タイプ) かを示します。 |
|
カラー
|
color | string |
イベントの種類のスケジュール ページの 16 進数のカラー値。 |
|
作成日
|
created_at | string |
イベントの種類が作成された瞬間 (例: "2020-01-02T03:04:05.678123Z")。 |
|
更新日
|
updated_at | string |
イベントの種類が最後に更新された瞬間 (例: "2020-01-02T03:04:05.678123Z")。 |
|
内部メモ
|
internal_note | string |
イベントの種類に関連付けられている可能性のあるメモの内容。 |
|
説明 (プレーン)
|
description_plain | string |
イベントの種類の説明 (書式設定されていないテキスト)。 |
|
説明 (HTML)
|
description_html | string |
イベントの種類の説明 (HTML で書式設定)。 |
|
プロファイル種類
|
profile.type | string |
プロファイルが「ユーザー」 (個人) と「チーム」のどちらに属しているかを示します。 |
|
プロファイル名
|
profile.name | string |
イベントの種類に関連付けられたユーザーのプロファイルの人間が判読できる名前。 |
|
プロファイル所有者 URI
|
profile.owner | string |
プロファイルに関連付けられているユーザーの一意参照です。 |
|
Secret
|
secret | boolean |
イベントの種類が所有者のメイン スケジュール ページで非表示になっているかどうかを示します。 |
|
Deleted At
|
deleted_at | string |
イベントの種類が削除された瞬間 (例: "2020-01-02T03:04:05.678123Z")。 |
|
管理者管理
|
admin_managed | boolean |
このイベントの種類が組織管理者によって管理されているかどうかを示します。 |
|
custom_questions
|
custom_questions | array of object |
custom_questions |
|
カスタム質問名
|
custom_questions.name | string |
名称 |
|
カスタム質問の種類
|
custom_questions.type | string |
タイプ |
|
カスタム質問の位置
|
custom_questions.position | integer |
職位 |
|
カスタム質問を有効にする
|
custom_questions.enabled | boolean |
enabled |
|
カスタム質問必須
|
custom_questions.required | boolean |
required |
|
カスタム質問の回答の選択肢
|
custom_questions.answer_choices | array of string |
answer_choices |
|
その他を含む
|
custom_questions.include_other | boolean |
include_other |
再確認
イベント タイプに対して再確認が有効になっていると仮定すると、再確認が要求されると、このオブジェクトは created_at これは、再確認通知がいつ送信されたかを反映しています。 招待者が再確認した後、confirmed_at 属性は null アクションを実行した時間を反映するタイムスタンプから変わります。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
再確認が作成された時間
|
created_at | date-time |
再確認が作成されたとき。 |
|
招待者が確認された時間
|
confirmed_at | date-time |
招待者が出席を確認したとき。 |