共用方式為


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

已知問題與限制

  1. 只有 Bookings 系統管理員可以使用約會觸發程式建立流程。 描述:目前只有 Bookings 系統管理員 (與租用戶系統管理員不同) 可以建立約會觸發程式。 如果您是非管理員 (團隊成員、排程器、檢視者、訪客) 的使用者,您應該要求管理員建立流程。 或者,您也可以要求管理員存取權。

  2. 每個 Bookings 信箱只能建立 5 個流程。 描述:對於預約信箱,只能建立 5 個流程。 這是 Bookings 信箱層級限制,而不是每個系統管理員限制。 如果您要尋找約會觸發程式的多個動作,您可以使用新增動作按鈕在其中一個現有流程中新增該動作。 您可以聯絡其他預訂管理員尋求支援。

  3. 建立流程時,出現錯誤,顯示「員工不屬於 Bookings Business」、「無效的授權單位」。 描述:請確保您是上述 Bookings 郵箱的一部分,並且您是該郵箱的管理員。 您可以轉到員工選項卡並驗證相同的內容。

  4. 部分 Bookings 參數 - 1:1 Bookings 的取消原因不會填入。 描述:上述參數現在不出現,我們正在努力盡快解決此問題。

  5. 錯誤閘道錯誤 - 如果後端 API 中發生建立流程的問題。 502 看到錯誤的閘道錯誤。 請向 Microsoft 365 支援人員報告相同的情況。

常見錯誤和補救措施

建立流程時的 HTTP 錯誤碼:

  1. '401':檢查連線中是否存在驗證相關問題。
  2. '403':只有 Bookings 系統管理員可以建立約會流程。 檢查 (1) 在 已知問題和限制 區段。
  3. '403':通知 URL 網域不屬於允許清單的一部分。
  4. '429':為企業建立的約會流程數量超過預期。 檢查 (2) 在 已知問題和限制 部分。
  5. '502':這是內部伺服器錯誤。 請向您的支援工程師報告此情況,並在流程建立回應中提供所有錯誤詳細資訊。

FAQ

  1. 如果我的預訂日曆不在觸發器下拉式選單中,我該怎麼辦? 答案: 此下拉式清單是以最近存取的預約行事曆為基礎,其中使用者是系統管理員。您可以從 Bookings 網頁流覽它一次,這應該可確保 Bookings 行事曆出現。 如果您沒有看到特定信箱,您可能也沒有管理員存取權。

  2. 如果 (1) 不起作用,如何為我作為管理員的行事曆建立流程? 回答: 您可以輸入自訂值。 這裡的值將是企業的 SMTP 地址/您可以前往您的預訂頁面。 尋找 [整合] 索引標籤,然後選取 [Power Automate] 選項。 您可以複製此處顯示的 SMTP 位址,並將其貼到流程的文字方塊中。

  3. 如何從約會觸發器回應中取得客戶資料? 回答: 如果這是 1:1 預訂,則可以使用 CustomerName、CustomerEmail 等頂級欄位。 如果是群組預訂,客戶陣列可用於取得 displayName (客戶電子郵件、客戶 displayName 等) 等欄位,可與 Power Automate 的「Foreach」選項搭配使用。

  4. 為什麼 StaffMembers 是陣列? 回答: 您將能夠分配多個工作人員作為主持人。 如果您的服務只有一名員工作為主持人,則員工詳細資料將顯示在員工陣列中。

  5. 是否有一個通用的 ID 可以跨觸發器用於同一約會? 回答: 是的,您可以使用 selfServiceAppointmentId。 此欄位將針對所有類型的約會填入 - 無論是線上或 In-Person,或員工預約或客戶預約。 「Id」欄位是交換ID,在觸發器之間不是唯一的。

  6. 有沒有辦法取得更新約會觸發通知中的變更內容? 回答: 不,這今天是不可能的。

  7. 多出席者約會的通知如何運作? 答:如果有多個出席者的約會,則新增新客戶(在第一個出席者之後)會作為更新約會觸發,而不是作為建立約會觸發。 這是因為將新客戶新增至已建立的預約本質上意味著將出席者新增至現有預約的約會實體。 新增至位置的第一個客戶一律會觸發約會建立觸發程序,因為這是建立預約約會實體的時間點。

正在建立連線

連接器支援下列驗證類型:

預設值 建立連線的參數。 所有區域 不可共享

預設

適用:所有地區

建立連線的參數。

這不是可共用的連線。 如果 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
email 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
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

所有選定的答案選項。