配置 Webhooks

網路掛鉤 Bookablesites 中的功能可讓您透過自訂 URL 將即時事件資料從平台傳送到外部應用程式。使用它來自動通知並將預訂資料推送到其他系統以簡化整合。

網路掛鉤 Bookablesites 的功能是一個高級選項,將計入您的總自訂功能和整合。

開始

  • 啟用 網路掛鉤功能和集成 頁。
  • 啟用後,按一下「設定」以開啟 webhooks 管理頁面。最初不會有 Webhook,因此請使用右上角的「建立 Webhook」按鈕建立新的 Webhook

可用的 webhook 事件類型 您可以為每個事件建立一個 webhook。點選“建立 webhook“:

  • 預約已預訂
  • 預約取消
  • 預約重新安排
  • 預約狀態已更改
  • 客戶創建
Web 儀表板的螢幕截圖,顯示了「功能和整合」下的 Webhook 部分,其中包含新增 Webhook URL 的選項和突出顯示的「建立 Webhook」按鈕。

請注意,在此階段,您只能為每種類型建立一個 Webhook。這意味著只能有一個 ‘預約已預訂’ webhook、一個 ‘預約已取消’ webhook,依此類推。

配置選項 建立 Webhook 時,您可以設定:

  • 名稱 — webhook 的描述性標籤。
  • 網站 URL — 可預訂網站發布事件有效負載的端點。

測試並有效負載您的 Webhook:

發送測試 Webhook 將範例資料傳送到配置的 URL,以便您可以驗證有效負載和映射。測試有效載荷包括以下詳細資訊:

  • 預約狀態、開始/結束日期和時間、合併開始/結束日期時間
  • 預約價格
  • 客戶全名、名字、姓氏、電子郵件、電話
  • 員工全名、名字、姓氏、電子郵件、電話
  • 服務類別、名稱、持續時間、價格
  • 附加內容
  • 地點名稱、地址、電話
  • 自訂欄位

這使您能夠確保正確配置 Webhook 以發送滿足您的整合需求所需的資訊。

筆記

您只能為每種事件類型建立一個網路掛鉤(例如,單一預約預訂網路掛鉤)。

有效負載格式遵循您在可預訂網站中選擇的設定。事件透過 HTTP 傳遞 發布 請求。

安全

驗證令牌 點擊驗證令牌按鈕(建立 Webhook 附近)以查看和複製您的令牌。當包含在每個 webhook 請求的授權標頭中時,此令牌可讓您驗證傳入的請求並確認它們來自 Bookablesites。

網頁顯示一個 “驗證令牌”彈出窗口,其中包含令牌字串以及複製令牌或關閉彈出視窗的選項; webhook 設定在背景可見。

範例和集成

第三方整合商,例如 帕布利康內克茨 使用 Bookablesites webhook 建立了集成,演示瞭如何將平台與外部自動化和工作流程工具連接起來。