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

イベント タイプに対して再確認が有効になっていると仮定すると、再確認が要求されると、このオブジェクトは created_at これは、再確認通知がいつ送信されたかを反映しています。 招待者が再確認した後、confirmed_at 属性は null アクションを実行した時間を反映するタイムスタンプから変わります。

定義

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 email

ユーザーの電子メール アドレスです。

event_guests
event_guests array of Guest

招待者によってイベントに追加された人

キャンセル
cancellation Cancellation

イベント中止に関するデータを提供します

カレンダーのイベント
calendar_event LegacyCalendarEvent

カレンダープロバイダーからのカレンダーイベントに関する情報。

キャンセル

イベント中止に関するデータを提供します

名前 パス 説明
キャンセル者
canceled_by string

キャンセルした人の名前。

キャンセルの理由
reason string

キャンセルが発生した理由。

キャンセルした人の種類
canceler_type string

イベントが "主催者" または "招待者" によってキャンセルされたかどうかを示します。

ゲスト

招待者がイベントのゲスト出席者として招待した個人

名前 パス 説明
イベント ゲストのメール
email email

イベント ゲストのメール。

イベント ゲストが作成された時間
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

招待者が出席を確認したとき。