跳至主要内容

請求表單

當訪客在 Kaleidr 地圖上點按請求動作（例如 Reserve、Schedule a Tour 或 Request Pickup），或在 Kaleidr AI 準備好的請求上點按檢查並送出時，就會開啟請求表單。它會將請求送到你組織的收件匣。如何設定請求，請參閱預訂請求。

在哪裡運作​

表單只在 Kaleidr 自己的網站上運作。 它不是你加入頁面的指令碼。在你的網站上，它會在你以 <kaleidr-map product="viewer"> 嵌入的已發佈地圖中開啟：viewer 是 iframe 中的一個 Kaleidr 頁面，表單在其地圖上方開啟。它也在 Kaleidr Studio 中運作；在 Kaleidr Map 中，僅在顯示 Kaleidr 自己的底圖時運作。

<script src="https://cdn.kaleidr.com/embed/v1/kaleidr.js"></script>
<kaleidr-map product="viewer" share-id="YOUR_MAP_ID" layout="guide"
             style="display:block; height:640px"></kaleidr-map>
  • 不需要在你的 Content Security Policy 中加入任何項目。 表單及其真人驗證在 viewer 的 iframe 中載入，因此你的頁面只需要 viewer 本身的 script-src 和 frame-src 項目。
  • 第一次點按時才載入。 訪客從不開啟表單的地圖永遠不會載入它。
  • 只有接受請求的地點才會顯示按鈕。 哪些地點接受請求在 Studio 和 Kaleidr Booking 中設定；參閱開啟請求。

訪客看到什麼​

  1. 以動作標籤為標題的表單：依你組織的設定顯示的套件欄位、姓名、電子郵件、選填的電話、留言，以及包含你的商家名稱和隱私權政策連結的同意聲明。
  2. 送出請求，在必填欄位填寫完畢並勾選同意方塊後可用。同意方塊一開始未勾選。未登入 Kaleidr 的訪客需要通過一次簡短的真人驗證。
  3. 請求已送出，並顯示參考編號（例如 K-7XQ2MD）；如果你的組織會寄送回條，還會顯示已將副本寄到訪客的電子郵件。

表單不會預先填入任何關於訪客的資訊。Kaleidr AI 準備的請求只填入訪客說過的內容，例如日期和人數，訪客會在送出前檢查。

訪客看到條件
「此地點不接受線上請求。」該地點或你的組織關閉了請求。
同樣的句子，並附地點的電話或連結你的組織已達到每月請求限制。
欄位旁的一句話必填欄位為空，或回答超出範圍。

表單的標籤跟隨地圖的語言，支援英語、西班牙語、法語、德語、葡萄牙語、日語、韓語、簡體和繁體中文，以及阿拉伯語。你自己的問題和標籤會依你撰寫的原樣顯示。

事件​

表單會向包含它的 Kaleidr 頁面回報，而不是向你的頁面回報：

事件時機
ready表單已顯示。
resize高度已變更。
submitted請求已被接受，附帶參考編號。
error請求遭拒，附帶錯誤代碼。
close訪客關閉了表單。

你的頁面不會收到其中任何事件。 送出請求時，viewer 不會發布任何公開訊息，而除了 ready 和 error 之外的 iframe 訊息都不是公開契約。要處理請求，請使用你的收件匣或 webhook，它會把完整的請求送到你自己的系統。

當已發佈地圖開啟 Kaleidr Analytics 時，送出的請求會計為該地圖的一次轉換。轉換只包含請求的類型，絕不包含訪客的資訊。

樣式​

表單在自己的 shadow root 中繪製，並在淺色與深色模式下沿用其所開啟地圖的顏色、字型和圓角。你頁面的 CSS 無法影響它：它位於 viewer 的 iframe 內。

以下是表單樣式所使用的 CSS 自訂屬性及其預設值。Kaleidr 的頁面會依地圖的主題設定它們。

屬性預設值作用於
--kbw-fontinherit字型。
--kbw-fg#111文字。
--kbw-bg#fff背景。
--kbw-muted#6b7280提示和次要文字。
--kbw-border#d1d5db欄位邊框。
--kbw-accent#2da84a送出按鈕和焦點環。
--kbw-accent-fg#fff送出按鈕上的文字。
--kbw-danger#b91c1c錯誤語句。
--kbw-radius10px圓角半徑。
--kbw-space8px間距單位。

相關內容​