Microsoft Bookings (預覽版)
Microsoft Bookings 是一種排程工具,是 Microsoft Office 系列產品的一部分。 它允許用戶和組織創建預訂頁面並幫助他們的客戶輕鬆預約。
此連接器適用於以下產品和區域:
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 標準 | 除下列區域外的所有 Power Automate 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域, 但下列區域除外: - Azure Government 區域 - Azure 中國區域 - 美國國防部 (DoD) |
| Power Apps | 標準 | 除下列區域外的所有 Power Apps 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| Power Automate(自動化服務) | 標準 | 除下列區域外的所有 Power Automate 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 連絡人 | |
|---|---|
| 名稱 | Microsoft 365 支援 |
| URL | https://support.microsoft.com/en-us/contactus# |
| 連接器中繼資料 | |
|---|---|
| Publisher | Microsoft公司 |
| 網站 | 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 系統、發送歡迎電子郵件? 預訂連接器是這些要求的解決方案。 使用此連接器,我們會公開所有約會預約動作,例如建立/更新/刪除預約。
先決條件
嘗試使用 Bookings 連接器的客戶應該擁有 Bookings 商務授權,才能使用此連接器。 Microsoft Bookings 將與 這些 授權一起提供。
如何取得認證
Microsoft Bookings 會使用 Microsoft Entra ID 驗證。 擁有有效的 O365 帳戶可確保您已通過驗證以使用 Bookings 連接器。 您應該是登入的使用者,才能建立約會型流程。
開始使用連接器
若要建立以 Bookings 應用程式作為觸發程式的自定義流程,您必須知道 Booking 企業的 SMTP 位址。 您可以建立流程,並將建立/更新/取消預約作為觸發器。 以下是您可以建置的一些常見流程:
與 Stripe 集成
Stripe 允許個人和企業透過網路接受付款。 您可以跟踪客戶、訂單、發票等;如需更多資訊 ,請瀏覽 Stripe |Microsoft Power Automate
與 Zoom 集成
此連接器將有助於自動化 Zoom 會議操作;欲了解更多信息 ,請訪問 Zoom Meetings(獨立出版商)|Microsoft Power Automate
與 Dynamic 365 整合
Dynamics 365 Sales Insights 借助 AI 驅動的見解來幫助增加您的銷售額,這些見解促進個性化參與和主動決策,以幫助建立關係。 ;如需詳細資訊,請 Dynamics 365 Sales Insights |Microsoft Power Automate
以下是所有連接器清單: 支援的連接器清單 |Microsoft Power Automate
已知問題與限制
只有 Bookings 系統管理員可以使用約會觸發程式建立流程。 描述:目前只有 Bookings 系統管理員 (與租用戶系統管理員不同) 可以建立約會觸發程式。 如果您是非管理員 (團隊成員、排程器、檢視者、訪客) 的使用者,您應該要求管理員建立流程。 或者,您也可以要求管理員存取權。
每個 Bookings 信箱只能建立 5 個流程。 描述:對於預約信箱,只能建立 5 個流程。 這是 Bookings 信箱層級限制,而不是每個系統管理員限制。 如果您要尋找約會觸發程式的多個動作,您可以使用新增動作按鈕在其中一個現有流程中新增該動作。 您可以聯絡其他預訂管理員尋求支援。
建立流程時,出現錯誤,顯示「員工不屬於 Bookings Business」、「無效的授權單位」。 描述:請確保您是上述 Bookings 郵箱的一部分,並且您是該郵箱的管理員。 您可以轉到員工選項卡並驗證相同的內容。
部分 Bookings 參數 - 1:1 Bookings 的取消原因不會填入。 描述:上述參數現在不出現,我們正在努力盡快解決此問題。
錯誤閘道錯誤 - 如果後端 API 中發生建立流程的問題。 502 看到錯誤的閘道錯誤。 請向 Microsoft 365 支援人員報告相同的情況。
常見錯誤和補救措施
建立流程時的 HTTP 錯誤碼:
- '401':檢查連線中是否存在驗證相關問題。
- '403':只有 Bookings 系統管理員可以建立約會流程。 檢查 (1) 在 已知問題和限制 區段。
- '403':通知 URL 網域不屬於允許清單的一部分。
- '429':為企業建立的約會流程數量超過預期。 檢查 (2) 在 已知問題和限制 部分。
- '502':這是內部伺服器錯誤。 請向您的支援工程師報告此情況,並在流程建立回應中提供所有錯誤詳細資訊。
FAQ
如果我的預訂日曆不在觸發器下拉式選單中,我該怎麼辦? 答案: 此下拉式清單是以最近存取的預約行事曆為基礎,其中使用者是系統管理員。您可以從 Bookings 網頁流覽它一次,這應該可確保 Bookings 行事曆出現。 如果您沒有看到特定信箱,您可能也沒有管理員存取權。
如果 (1) 不起作用,如何為我作為管理員的行事曆建立流程? 回答: 您可以輸入自訂值。 這裡的值將是企業的 SMTP 地址/您可以前往您的預訂頁面。 尋找 [整合] 索引標籤,然後選取 [Power Automate] 選項。 您可以複製此處顯示的 SMTP 位址,並將其貼到流程的文字方塊中。
如何從約會觸發器回應中取得客戶資料? 回答: 如果這是 1:1 預訂,則可以使用 CustomerName、CustomerEmail 等頂級欄位。 如果是群組預訂,客戶陣列可用於取得 displayName (客戶電子郵件、客戶 displayName 等) 等欄位,可與 Power Automate 的「Foreach」選項搭配使用。
為什麼 StaffMembers 是陣列? 回答: 您將能夠分配多個工作人員作為主持人。 如果您的服務只有一名員工作為主持人,則員工詳細資料將顯示在員工陣列中。
是否有一個通用的 ID 可以跨觸發器用於同一約會? 回答: 是的,您可以使用 selfServiceAppointmentId。 此欄位將針對所有類型的約會填入 - 無論是線上或 In-Person,或員工預約或客戶預約。 「Id」欄位是交換ID,在觸發器之間不是唯一的。
有沒有辦法取得更新約會觸發通知中的變更內容? 回答: 不,這今天是不可能的。
多出席者約會的通知如何運作? 答:如果有多個出席者的約會,則新增新客戶(在第一個出席者之後)會作為更新約會觸發,而不是作為建立約會觸發。 這是因為將新客戶新增至已建立的預約本質上意味著將出席者新增至現有預約的約會實體。 新增至位置的第一個客戶一律會觸發約會建立觸發程序,因為這是建立預約約會實體的時間點。
正在建立連線
連接器支援下列驗證類型:
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用:所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 列出使用者是管理員的預訂企業 |
用來列出存取使用者為管理員的所有信箱的作業。 |
列出使用者是管理員的預訂企業
觸發程序
| 建立約會時 |
此觸發器用於接聽以建立預約約會。 選取預約頁面,或輸入您期待監聽的預約頁面的 SMTP 位址建立約會事件 |
| 更新約會時 |
此觸發器用於接聽預訂約會的更新。 選取預約頁面,或輸入您期待監聽更新約會事件的預約頁面的 SMTP 位址。 |
| 當預約被取消時 |
此觸發器用於監聽取消預約約會。 選取預約頁面,或輸入您期待監聽取消約會事件的預約頁面的 SMTP 位址。 |
建立約會時
此觸發器用於接聽以建立預約約會。 選取預約頁面,或輸入您期待監聽的預約頁面的 SMTP 位址建立約會事件
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
預訂頁面。
|
SMTPAddress | True | string |
選擇預訂頁面 |
|
change_type
|
change_type | True | array of string |
要監聽的變更 |
傳回
更新約會時
此觸發器用於接聽預訂約會的更新。 選取預約頁面,或輸入您期待監聽更新約會事件的預約頁面的 SMTP 位址。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
預訂頁面。
|
SMTPAddress | True | string |
選擇預訂頁面 |
|
change_type
|
change_type | True | array of string |
要監聽的變更 |
傳回
當預約被取消時
此觸發器用於監聽取消預約約會。 選取預約頁面,或輸入您期待監聽取消約會事件的預約頁面的 SMTP 位址。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
預訂頁面。
|
SMTPAddress | True | string |
選擇預訂頁面 |
|
change_type
|
change_type | True | array of string |
要監聽的變更 |
傳回
定義
ListMailbox回應
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
郵箱
|
mailboxes | array of MailboxEntity |
所有信箱實體。 |
MailboxEntity
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
顯示名稱
|
displayName | string |
信箱 顯示名稱。 |
|
信箱 SMTP
|
string |
預約信箱的 SMTP。 |
預約數據
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
其他資訊
|
AdditionalInfo | string |
有關預訂的其他信息。 |
|
客戶電子郵件
|
CustomerEmail | string |
1:1 預訂時的客戶電子郵件地址。 |
|
顧客ID
|
CustomerId | string |
如果是 1:1 預訂,則為客戶 ID。 |
|
位置顯示名稱
|
CustomerLocation.DisplayName | string |
客戶位置顯示名稱。 位置從 C2 頁面填寫,可進行 1:1 預訂。 |
|
城市
|
CustomerLocation.PhysicalAddress.City | string |
客戶所屬的城市,以 1:1 預訂。 |
|
國家或地區
|
CustomerLocation.PhysicalAddress.CountryOrRegion | string |
客戶的國家或地區,用於 1:1 預訂。 |
|
郵遞區號
|
CustomerLocation.PhysicalAddress.PostalCode | string |
1:1 預訂的客戶郵遞區號。 |
|
State
|
CustomerLocation.PhysicalAddress.State | string |
說明客戶在 1:1 預約中所屬的位置。 |
|
街道
|
CustomerLocation.PhysicalAddress.Street | string |
客戶在 1:1 預訂中所屬的街道。 |
|
客戶名稱
|
CustomerName | string |
1:1 預訂的客戶名稱。 |
|
客戶說明
|
CustomerNotes | string |
1:1 預訂的客戶說明。 |
|
自訂問題答案
|
CustomQuestionAnswers | array of CustomQuestion |
1:1 預訂的所有自定義問題和答案。 |
|
客戶電話
|
CustomerPhone | string |
客戶電話進行 1:1 預訂。 |
|
客戶時區
|
CustomerTimeZone | string |
1:1 預訂的客戶時區。 |
|
客戶
|
Customers | array of CustomerData |
1:N 預訂中的客戶名單 |
|
持續時間
|
Duration | integer |
預約期限 |
|
EndTime
|
EndTime | string |
約會的結束時間。 |
|
已填滿出席者計數
|
FilledAttendeesCount | integer |
預訂此預約時段的與會者人數。 |
|
Id
|
Id | string |
[已取代] - 使用 selfServiceAppointmentId 作為預約約會的唯一識別碼。 |
|
IsSMSNotifications已啟用
|
IsSMSNotificationsEnabled | boolean |
用於檢查是否已為約會啟用簡訊通知的欄位。 |
|
加入WebURL
|
JoinWebURL | string |
用於加入此線上約會的 URL。 |
|
最大出席者計數
|
MaxAttendeesCount | integer |
此申請允許的最大與會者人數。 |
|
SelfServiceAppointmentId
|
SelfServiceAppointmentId | string |
預約的預約識別碼。 |
|
ServiceId
|
ServiceId | string |
唯一服務識別碼。 |
|
服務名稱
|
ServiceName | string |
預訂服務的名稱。 |
|
服務說明
|
ServiceNotes | string |
員工和管理員的服務水平說明。 |
|
員工
|
StaffMembers | array of StaffMemberData |
工作人員名單 |
|
開始時間
|
StartTime | string |
約會的開始時間。 |
|
追蹤資料
|
TrackingData | string |
活動追蹤資料。 |
|
取消原因
|
CancelReason | string |
取消此預約的原因 |
客戶數據
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Email
|
string |
團體預訂中客戶的電子郵件。 |
|
|
Id
|
Id | string |
團體預訂中客戶的唯一 ID。 |
|
位置顯示名稱
|
Location.DisplayName | string |
客戶位置顯示名稱。 從 C2 頁面填寫的團體預訂位置。 |
|
城市
|
Location.PhysicalAddress.City | string |
客戶所屬的城市進行團體預訂。 |
|
國家或地區
|
Location.PhysicalAddress.CountryOrRegion | string |
團體預訂客戶的國家或地區。 |
|
郵遞區號
|
Location.PhysicalAddress.PostalCode | string |
團體預訂客戶的郵遞區號。 |
|
State
|
Location.PhysicalAddress.State | string |
說明客戶在團體預訂中所屬的位置。 |
|
街道
|
Location.PhysicalAddress.Street | string |
客戶在團體預訂中所屬的街道。 |
|
顯示名稱
|
Name | string |
群組預訂中客戶的顯示名稱。 |
|
註釋
|
Notes | string |
團體預訂中客戶的備註。 |
|
Timezone
|
TimeZone | string |
團體預訂中客戶的時區。 |
|
Answers
|
Answers | array of CustomQuestion |
所有自定義問題和答案。 |
員工資料
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
顯示名稱
|
DisplayName | string |
指派給此約會的工作人員的顯示名稱。 |
|
電子郵件地址
|
EmailAddress | string |
指派給此約會的員工的電子郵件地址。 |
|
Id
|
Id | string |
唯一的員工識別碼。 |
自訂問題
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
回答
|
Answer | string |
回答這個自訂問題。 |
|
答案選項
|
AnswerOptions | array of string |
所有答案選項。 |
|
是必要
|
IsRequired | boolean |
告訴回答這個問題是否是強制性的。 |
|
Question
|
Question | string |
有待回答的問題。 |
|
問題ID
|
QuestionID | string |
要回答的問題的唯一標識符。 |
|
選取的選項
|
SelectedOptions | array of integer |
所有選定的答案選項。 |