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

既知の問題と制限事項

  1. 予定トリガーを使用してフローを作成できるのは予約管理者のみです。 説明: 現時点では、予約管理者 (テナント管理者とは異なります) のみが予定トリガーを作成できます。 管理者ではないユーザー (チーム メンバー、スケジューラ、ビューアー、ゲスト) の場合は、管理者にフローの作成を依頼する必要があります。 または、管理者アクセスを依頼することもできます。

  2. Bookings メールボックスごとに作成できるフローは 5 つだけです。 説明: Booking メールボックスの場合、作成できるフローは 5 つだけです。 これは Bookings メールボックスのレベル制限であり、管理者ごとの制限ではありません。 予定トリガーに対して複数のアクションが必要な場合は、アクションの追加ボタンを使用して、既存のフローの 1 つにアクションを追加できます。 サポートについては、他の予約管理者に問い合わせることができます。

  3. フロー作成中の「このフローは Bookings Business の一部ではありません」、「無効なオーソリティ」というエラー。 説明: ご自身が上記の予約メールボックスのメンバーであり、その管理者であることを確認してください。 スタッフ タブに移動して同じことを確認できます。

  4. 予約パラメーターの一部 - 1:1 予約のキャンセル理由が設定されていません。 説明: 上記のパラメータは現在表示されません。これは間もなく修正されるよう取り組んでいます。

  5. 不正なゲートウェイ エラー - フローを作成するためのバックエンド API に問題がある場合。 502 不正なゲートウェイ エラーが表示されます。 同じことを Microsoft 365 サポートに報告してください。

一般的なエラーと解決策

フロー作成中の HTTP エラー コード:

  1. '401': 接続に認証関連の問題がないか確認してください。
  2. '403': 予定フローを作成できるのは、Bookings 管理者のみです。 既知の問題と制限セクションの (1) を確認してください。
  3. '403': 通知 URL ドメインが許可リストに含まれていません。
  4. '429': ビジネス用に作成された予定フローの予想数を超えています。 既知の問題と制限セクションの (2) を確認してください。
  5. '502': 内部サーバー エラーです。 フロー作成応答のすべてのエラーの詳細とともに、これをサポート エンジニアに報告してください。

よくあるご質問

  1. 自分の予約カレンダーがトリガーのドロップ ダウンに含まれていない場合はどうすればよいですか? 回答: このドロップ ダウンは、ユーザーが管理者である最近アクセスした予約カレンダーに基づいています。予約 Web ページから一度アクセスすると、予約カレンダーが表示されます。 特定のメールボックスだけが表示されない場合は、管理者アクセス権がない可能性もあります。

  2. (1) が機能しない場合、自分が管理者であるカレンダーのフローを作成するにはどうすればよいですか? 回答: カスタム値を入力できます。 ここの値はビジネスの SMTP アドレスになります。予約ページに移動できます。 [統合] タブを探して、Power Automate オプションを選択します。 ここに表示されている SMTP アドレスをコピーして、フローのテキスト ボックスに貼り付けることができます。

  3. 予定トリガー応答から顧客データを取得するにはどうすればよいですか? 回答: これが 1 対 1 の予約の場合、CustomerName、CustomerEmail などのトップ レベルのフィールドを使用できます。 グループ予約の場合、顧客の配列を使用して、displayName などのフィールド (顧客のメール アドレス、顧客の displayName など) を取得できます。これは、Power Automate の "Foreach" オプションで使用できます。

  4. StaffMembers が配列であるのはなぜですか? 回答: 複数のスタッフ メンバーをホストとして割り当てることができます。 サービスのホストとしてスタッフが 1 人しかいない場合、スタッフの詳細はスタッフ メンバー配列に表示されます。

  5. 同じ予定のトリガー間で使用できる共通の ID はありますか? 回答: はい。selfServiceAppointmentId を使用できます。 このフィールドには、オンライン、対面、スタッフ予約、顧客予約など、あらゆる種類の予約が入力されます。 "Id" フィールドは Exchange ID であり、トリガー全体で一意ではありません。

  6. 更新予定トリガー通知の変更内容を取得する方法はありますか? 回答: いいえ。現時点ではできません。

  7. 複数の出席者の予定の通知はどのように機能しますか? 回答: 複数の出席者がいる予定の場合、(最初の顧客の後の) 新しい顧客の追加は、予定の作成ではなく、予定の更新としてトリガーされます。 これは、作成された予約に新しい顧客を追加するということは、本質的に既存の予約の予約エンティティに出席者を追加することを意味するという事実によるものです。 スロットに追加された最初の顧客は、予約予定エンティティが作成される時点で、常に予定作成トリガーをトリガーします。

接続を作成する

このコネクタは、次の認証タイプをサポートしています:

既定 接続を作成するためのパラメーター。 すべての地域 共有不可

既定

適用できるもの: すべての領域

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

調整制限

名前 呼び出し 更新期間
接続ごとの API 呼び出し 100 60 秒

アクション

ユーザーが管理者である予約ビジネスをリストする

アクセスしているユーザーが管理者であるすべてのメールボックスを一覧表示するために使用される操作。

ユーザーが管理者である予約ビジネスをリストする

アクセスしているユーザーが管理者であるすべてのメールボックスを一覧表示するために使用される操作。

戻り値

トリガー

予定が取り消された場合

このトリガーは、予約の予定の取り消しをリッスンするために使用されます。 予約ページを選択するか、予約イベントのキャンセルをリッスンする予定の予約ページの SMTP アドレスを入力します。

予定の作成時

このトリガーは、予約の予定の作成をリッスンするために使用されます。 予約ページを選択するか、予約イベントの作成をリッスンする予定の予約ページの SMTP アドレスを入力します

予約が更新されたとき

このトリガーは、予約予定の更新をリッスンするために使用されます。 予約ページを選択するか、予約イベントの更新をリッスンする予定の予約ページの SMTP アドレスを入力します。

予定が取り消された場合

このトリガーは、予約の予定の取り消しをリッスンするために使用されます。 予約ページを選択するか、予約イベントのキャンセルをリッスンする予定の予約ページの SMTP アドレスを入力します。

パラメーター

名前 キー 必須 説明
予約ページ。
SMTPAddress True string

予約ページを選択する

change_type
change_type True array of string

リッスンの変更

戻り値

予定の作成時

このトリガーは、予約の予定の作成をリッスンするために使用されます。 予約ページを選択するか、予約イベントの作成をリッスンする予定の予約ページの SMTP アドレスを入力します

パラメーター

名前 キー 必須 説明
予約ページ。
SMTPAddress True string

予約ページを選択する

change_type
change_type True array of string

リッスンの変更

戻り値

予約が更新されたとき

このトリガーは、予約予定の更新をリッスンするために使用されます。 予約ページを選択するか、予約イベントの更新をリッスンする予定の予約ページの SMTP アドレスを入力します。

パラメーター

名前 キー 必須 説明
予約ページ。
SMTPAddress True string

予約ページを選択する

change_type
change_type True array of string

リッスンの変更

戻り値

定義

ListMailboxResponse

名前 パス 説明
メールボックス
mailboxes array of MailboxEntity

すべてのメールボックス エンティティ。

MailboxEntity

名前 パス 説明
表示名称
displayName string

メールボックス表示名。

メールボックス SMTP
email 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

名前 パス 説明
メール
Email 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

選択したすべての回答オプション。