Microsoft Bookings (プレビュー)
Microsoft Bookings はスケジュール ツールであり、Microsoft Office 製品ファミリの一部です。 ユーザーと組織が予約ページを作成できるようにし、顧客が簡単に予約できるようにします。
このコネクタは、次の製品および地域で利用可能です:
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure China の地域 - 米国国防総省 (DoD) |
| Power Automate | Standard | 以下を除くすべての Power Automate 地域 : - US Government (GCC) - US Government (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| Power Apps | 標準 | 以下を除くすべての Power Apps 地域 : - US Government (GCC) - US Government (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| お問い合わせ先 | |
|---|---|
| 件名 | Microsoft 365 サポート |
| [URL] | https://support.microsoft.com/en-us/contactus# |
| Connector Metadata | |
|---|---|
| 発行者 | Microsoft Corporation |
| Web サイト | https://book.ms |
| プライバシー ポリシー | https://docs.microsoft.com/en-us/microsoft-365/bookings/bookings-faq?view=o365-worldwide#privacy |
| カテゴリ | ビジネス管理;コラボレーション |
Microsoft Bookings コネクタは、Power Platform が提供する他の機能で Booking の予定を拡張することを目的として構築されています。 例えば、予定と Zoom 会議の予約、Sripe を使用した支払い方法の統合、顧客データの CRM システムへのアップロード、ウェルカム メールの送信など、顧客があなたのビジネスとの予定を入れるときに、顧客のために構築したいカスタム ワークフローを探したことはありますか? Booking コネクタは、これらの質問に対するソリューションです。 このコネクタでは、Bookings の作成/更新/削除など、すべての予定の予約アクションを公開しています。
前提条件
Bookings コネクタを使用する顧客は、このコネクタを使用するための Bookings Business License を持っている必要があります。 Microsoft Bookings は これらの ライセンスで利用できます。
資格情報の入手方法
Microsoft Bookings は Microsoft Entra の ID 認証を使用します。 有効な O365 アカウントを持っていると、Bookings コネクタを使用するために認証されます。 予定ベース フローを作成するには、サインイン ユーザーである必要があります。
コネクタの使用を開始する
Bookings の予定をトリガーとして使用してカスタム フローを作成するには、予約ビジネス の SMTP アドレスを知っている必要があります。 予約の予定が、作成/更新/取り消されるフローをトリガーとして構築できます。 ここでは、構築できる一般的なフローの一部を示します:
Stripe との統合
Stripe を使用すると、個人や企業がインターネット経由で支払を受けることができます。 顧客、注文、請求書などを追跡できます; 詳細についてはストライプ | Microsoft Power Automate
Zoom との統合
このコネクタは、Zoom Meeting の操作を自動化するのに役立ちます; 詳細については Zoom Meetings (独立系発行元) | Microsoft Power Automate
Dynamic 365 との統合
Dynamics 365 Sales Insights は、AI を活用したインサイトを利用して売り上げを促進します。インサイトは、パーソナライズされたエンゲージメントと積極的な意思決定を推進してリレーションシップの構築を支援します。 ; 詳細については Dynamics 365 Sales Insights | Microsoft Power Automate
コネクタのすべての一覧は次のとおりです: サポートされているコネクタのリスト | Microsoft Power Automate
既知の問題と制限事項
予定トリガーを使用してフローを作成できるのは予約管理者のみです。 説明: 現時点では、予約管理者 (テナント管理者とは異なります) のみが予定トリガーを作成できます。 管理者ではないユーザー (チーム メンバー、スケジューラ、ビューアー、ゲスト) の場合は、管理者にフローの作成を依頼する必要があります。 または、管理者アクセスを依頼することもできます。
Bookings メールボックスごとに作成できるフローは 5 つだけです。 説明: Booking メールボックスの場合、作成できるフローは 5 つだけです。 これは Bookings メールボックスのレベル制限であり、管理者ごとの制限ではありません。 予定トリガーに対して複数のアクションが必要な場合は、アクションの追加ボタンを使用して、既存のフローの 1 つにアクションを追加できます。 サポートについては、他の予約管理者に問い合わせることができます。
フロー作成中の「このフローは Bookings Business の一部ではありません」、「無効なオーソリティ」というエラー。 説明: ご自身が上記の予約メールボックスのメンバーであり、その管理者であることを確認してください。 スタッフ タブに移動して同じことを確認できます。
予約パラメーターの一部 - 1:1 予約のキャンセル理由が設定されていません。 説明: 上記のパラメータは現在表示されません。これは間もなく修正されるよう取り組んでいます。
不正なゲートウェイ エラー - フローを作成するためのバックエンド API に問題がある場合。 502 不正なゲートウェイ エラーが表示されます。 同じことを Microsoft 365 サポートに報告してください。
一般的なエラーと解決策
フロー作成中の HTTP エラー コード:
- '401': 接続に認証関連の問題がないか確認してください。
- '403': 予定フローを作成できるのは、Bookings 管理者のみです。 既知の問題と制限セクションの (1) を確認してください。
- '403': 通知 URL ドメインが許可リストに含まれていません。
- '429': ビジネス用に作成された予定フローの予想数を超えています。 既知の問題と制限セクションの (2) を確認してください。
- '502': 内部サーバー エラーです。 フロー作成応答のすべてのエラーの詳細とともに、これをサポート エンジニアに報告してください。
よくあるご質問
自分の予約カレンダーがトリガーのドロップ ダウンに含まれていない場合はどうすればよいですか? 回答: このドロップ ダウンは、ユーザーが管理者である最近アクセスした予約カレンダーに基づいています。予約 Web ページから一度アクセスすると、予約カレンダーが表示されます。 特定のメールボックスだけが表示されない場合は、管理者アクセス権がない可能性もあります。
(1) が機能しない場合、自分が管理者であるカレンダーのフローを作成するにはどうすればよいですか? 回答: カスタム値を入力できます。 ここの値はビジネスの SMTP アドレスになります。予約ページに移動できます。 [統合] タブを探して、Power Automate オプションを選択します。 ここに表示されている SMTP アドレスをコピーして、フローのテキスト ボックスに貼り付けることができます。
予定トリガー応答から顧客データを取得するにはどうすればよいですか? 回答: これが 1 対 1 の予約の場合、CustomerName、CustomerEmail などのトップ レベルのフィールドを使用できます。 グループ予約の場合、顧客の配列を使用して、displayName などのフィールド (顧客のメール アドレス、顧客の displayName など) を取得できます。これは、Power Automate の "Foreach" オプションで使用できます。
StaffMembers が配列であるのはなぜですか? 回答: 複数のスタッフ メンバーをホストとして割り当てることができます。 サービスのホストとしてスタッフが 1 人しかいない場合、スタッフの詳細はスタッフ メンバー配列に表示されます。
同じ予定のトリガー間で使用できる共通の ID はありますか? 回答: はい。selfServiceAppointmentId を使用できます。 このフィールドには、オンライン、対面、スタッフ予約、顧客予約など、あらゆる種類の予約が入力されます。 "Id" フィールドは Exchange ID であり、トリガー全体で一意ではありません。
更新予定トリガー通知の変更内容を取得する方法はありますか? 回答: いいえ。現時点ではできません。
複数の出席者の予定の通知はどのように機能しますか? 回答: 複数の出席者がいる予定の場合、(最初の顧客の後の) 新しい顧客の追加は、予定の作成ではなく、予定の更新としてトリガーされます。 これは、作成された予約に新しい顧客を追加するということは、本質的に既存の予約の予約エンティティに出席者を追加することを意味するという事実によるものです。 スロットに追加された最初の顧客は、予約予定エンティティが作成される時点で、常に予定作成トリガーをトリガーします。
接続を作成する
このコネクタは、次の認証タイプをサポートしています:
| 既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| ユーザーが管理者である予約ビジネスをリストする |
アクセスしているユーザーが管理者であるすべてのメールボックスを一覧表示するために使用される操作。 |
ユーザーが管理者である予約ビジネスをリストする
トリガー
| 予定が取り消された場合 |
このトリガーは、予約の予定の取り消しをリッスンするために使用されます。 予約ページを選択するか、予約イベントのキャンセルをリッスンする予定の予約ページの SMTP アドレスを入力します。 |
| 予定の作成時 |
このトリガーは、予約の予定の作成をリッスンするために使用されます。 予約ページを選択するか、予約イベントの作成をリッスンする予定の予約ページの SMTP アドレスを入力します |
| 予約が更新されたとき |
このトリガーは、予約予定の更新をリッスンするために使用されます。 予約ページを選択するか、予約イベントの更新をリッスンする予定の予約ページの SMTP アドレスを入力します。 |
予定が取り消された場合
このトリガーは、予約の予定の取り消しをリッスンするために使用されます。 予約ページを選択するか、予約イベントのキャンセルをリッスンする予定の予約ページの SMTP アドレスを入力します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
予約ページ。
|
SMTPAddress | True | string |
予約ページを選択する |
|
change_type
|
change_type | True | array of string |
リッスンの変更 |
戻り値
- Body
- AppointmentData
予定の作成時
このトリガーは、予約の予定の作成をリッスンするために使用されます。 予約ページを選択するか、予約イベントの作成をリッスンする予定の予約ページの SMTP アドレスを入力します
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
予約ページ。
|
SMTPAddress | True | string |
予約ページを選択する |
|
change_type
|
change_type | True | array of string |
リッスンの変更 |
戻り値
- Body
- AppointmentData
予約が更新されたとき
このトリガーは、予約予定の更新をリッスンするために使用されます。 予約ページを選択するか、予約イベントの更新をリッスンする予定の予約ページの SMTP アドレスを入力します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
予約ページ。
|
SMTPAddress | True | string |
予約ページを選択する |
|
change_type
|
change_type | True | array of string |
リッスンの変更 |
戻り値
- Body
- AppointmentData
定義
ListMailboxResponse
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
メールボックス
|
mailboxes | array of MailboxEntity |
すべてのメールボックス エンティティ。 |
MailboxEntity
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
表示名称
|
displayName | string |
メールボックス表示名。 |
|
メールボックス SMTP
|
string |
予約メールボックスの SMTP。 |
AppointmentData
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Additional Info
|
AdditionalInfo | string |
予約に関する追加情報。 |
|
Customer Email
|
CustomerEmail | string |
1 対 1 の予約の場合の顧客のメール アドレス。 |
|
CustomerId
|
CustomerId | string |
1 対 1 の予約の場合の顧客 ID。 |
|
場所の表示名
|
CustomerLocation.DisplayName | string |
顧客場所の表示名。 1 対 1 予約の C2 ページから場所が入力されました。 |
|
都市
|
CustomerLocation.PhysicalAddress.City | string |
1 対 1 の予約で顧客が属する都市。 |
|
CountryOrRegion
|
CustomerLocation.PhysicalAddress.CountryOrRegion | string |
1 対 1 の予約の顧客の国または地域。 |
|
PostalCode
|
CustomerLocation.PhysicalAddress.PostalCode | string |
1 対 1 の予約の顧客の郵便番号。 |
|
State
|
CustomerLocation.PhysicalAddress.State | string |
1 対 1 の予約で顧客が属する都道府県。 |
|
Street
|
CustomerLocation.PhysicalAddress.Street | string |
1 対 1 の予約で顧客が属する番地。 |
|
CustomerName
|
CustomerName | string |
1 対 1 の予約の顧客名。 |
|
CustomerNotes
|
CustomerNotes | string |
1 対 1 の予約の顧客メモ。 |
|
CustomQuestionAnswers
|
CustomQuestionAnswers | array of CustomQuestion |
1:1 予約に関するすべてのカスタム質問と回答。 |
|
CustomerPhone
|
CustomerPhone | string |
1 対 1 の予約の顧客の電話。 |
|
CustomerTimeZone
|
CustomerTimeZone | string |
1 対 1 の予約の顧客タイム ゾーン。 |
|
Customers
|
Customers | array of CustomerData |
1 対 N の予約の顧客リスト |
|
長さ
|
Duration | integer |
予定の期間 |
|
EndTime
|
EndTime | string |
予定の終了時刻。 |
|
FilledAttendeesCount
|
FilledAttendeesCount | integer |
この予定スロットを予約した参加者の数。 |
|
Id
|
Id | string |
[非推奨] - 予約予約の一意の識別子として selfServiceAppointmentId を使用します。 |
|
IsSMSNotificationsEnabled
|
IsSMSNotificationsEnabled | boolean |
予定の SMS 通知が有効になっているかどうかを確認するフィールド。 |
|
JoinWebURL
|
JoinWebURL | string |
このオンライン予定に参加するための URL。 |
|
MaxAttendeesCount
|
MaxAttendeesCount | integer |
この予定で許可される最大参加者数。 |
|
SelfServiceAppointmentId
|
SelfServiceAppointmentId | string |
予約予定の予約 ID。 |
|
ServiceId
|
ServiceId | string |
一意のサービス識別子。 |
|
ServiceName
|
ServiceName | string |
予約サービスの名前。 |
|
ServiceNotes
|
ServiceNotes | string |
スタッフと管理者向けのサービス レベルのメモ。 |
|
StaffMembers
|
StaffMembers | array of StaffMemberData |
スタッフの一覧 |
|
Start Time
|
StartTime | string |
予定の開始時間。 |
|
Tracking Data
|
TrackingData | string |
キャンペーン追跡データ。 |
|
Cancel Reason
|
CancelReason | string |
この予約の予定の取り消し理由 |
CustomerData
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
メール
|
string |
グループ予約の顧客のメールアドレス。 |
|
|
Id
|
Id | string |
グループ予約の顧客の一意 ID。 |
|
場所の表示名
|
Location.DisplayName | string |
顧客場所の表示名。 グループ予約の C2 ページから場所が入力されました。 |
|
都市
|
Location.PhysicalAddress.City | string |
グループ予約で顧客が属する都市。 |
|
Country Or Region
|
Location.PhysicalAddress.CountryOrRegion | string |
グループ予約の顧客の国または地域。 |
|
Postal Code
|
Location.PhysicalAddress.PostalCode | string |
グループ予約の顧客の郵便番号。 |
|
状態
|
Location.PhysicalAddress.State | string |
グループ予約で顧客が属する都道府県。 |
|
Street
|
Location.PhysicalAddress.Street | string |
グループ予約で顧客が属する番地。 |
|
Display Name
|
Name | string |
グループ予約の顧客の表示名。 |
|
ノート
|
Notes | string |
グループ予約の顧客のメモ。 |
|
Timezone
|
TimeZone | string |
グループ予約の顧客のタイムゾーン。 |
|
Answers
|
Answers | array of CustomQuestion |
すべてのカスタムの質問と回答。 |
StaffMemberData
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
DisplayName
|
DisplayName | string |
この予定に割り当てられたスタッフの表示名。 |
|
EmailAddress
|
EmailAddress | string |
この予定に割り当てられたスタッフのメール アドレス。 |
|
Id
|
Id | string |
一意のスタッフ識別子。 |
CustomQuestion
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
Answer
|
Answer | string |
このカスタム質問に対する回答。 |
|
AnswerOptions
|
AnswerOptions | array of string |
すべての回答オプション。 |
|
IsRequired
|
IsRequired | boolean |
この質問への回答が必須かどうかを示します。 |
|
Question
|
Question | string |
回答する質問。 |
|
QuestionID
|
QuestionID | string |
回答する質問の一意識別子。 |
|
SelectedOptions
|
SelectedOptions | array of integer |
選択したすべての回答オプション。 |