表單與潛在客戶

在 Studio 中建立表單、在您的網站上算繪、以 Turnstile 阻擋垃圾訊息，並將每筆詢問接收為潛在客戶。

本頁翻譯自英文。若內容有任何差異，以英文版為準。閱讀英文版

Atlas 表單會在您的網站上收集詢問，並將每一筆轉為潛在客戶，供您的團隊指派、跟進與匯出。表單可用於您的 Development 網站，並在 Production 上線後，用於您的正式網站。

運作方式

在 Studio 中建立表單。 在 Forms & leads 下設定欄位、標籤、同意聲明文字、送出按鈕標籤與成功訊息。
由您的網站算繪。 網站會取得表單定義，並以自己的元件繪製欄位，因此表單會與您的設計一致。
訪客送出表單。 瀏覽器直接向 Atlas 送出資料。不涉及任何權杖：Atlas 只接受 Origin 為您網站已登錄位址的請求。
Atlas 檢查並儲存。 先執行垃圾訊息與濫用檢查，接著儲存潛在客戶、以電子郵件通知您的團隊，並傳送到您的 Webhook。

Development 與正式網站

	Development 網站	正式網站（Production）
表單何時回應	隨時	當 Production 已開啟且已簽署的發行版本正式上線時
表單的版本	最新已發布的草稿	正式發行版本中的版本
接受的來源	您的 Development 位址	僅限 `https://` 加上您的 Production 網域
潛在客戶顯示於	Leads → Development	Leads → Live website（「Leads from the live website」）
潛在客戶電子郵件	預設為關閉	預設為開啟；可以暫停

表單與頁面一樣，會隨發行版本送往 Production。您在 Development 中修改的表單，會隨下一個已核准的發行版本抵達正式網站；從發行版本中移除的表單，在正式網站上也將停止回應。

Production 關閉期間，其表單位址會回應 404 CP_NOT_FOUND。若 Production 已開啟但尚無已簽署的正式發行版本，則會回應 403 CP_PRODUCTION_LOCKED。

算繪表單

// GET /v1/public/environments/{environmentId}/forms/{formKey}
// → { key, name, version, fields, settings: { submitLabel, successMessage, consentText },
//     challenge: { provider: 'turnstile', action, siteKey } }

請以您自己的輸入元件算繪 fields。若 challenge.provider 為 turnstile，請使用給定的 siteKey 與 action 算繪 Cloudflare Turnstile 小工具，並在您的 Content-Security-Policy 中允許 Turnstile。

送出

// POST /v1/public/environments/{environmentId}/forms/{formKey}/submissions
{
  "idempotencyKey": "<new UUID per attempt>",
  "sessionId": "<16–128 chars, A–Z a–z 0–9 _ ->",
  "startedAt": 1761210000000,       // when the visitor opened the form, in ms
  "challengeToken": "<Turnstile token>",
  "website": "",                    // hidden honeypot field; leave empty
  "consent": true,
  "fields": { "name": "…", "email": "…", "message": "…" }
}

回應	意義
`201 { status: 'received' }`	已接受。顯示 `settings.successMessage`
`422 SUBMISSION_INVALID`	某個欄位驗證失敗。顯示欄位錯誤
`400 SUBMISSION_REJECTED`	被拒絕，例如驗證挑戰失敗
`429`	送出次數過多。請訪客稍後再試

可疑的送出內容會被隔離，但仍會收到 201，讓攻擊者無從得知哪些內容被標記。

垃圾訊息與濫用防護

每個網站各自的 Cloudflare Turnstile 挑戰。
蜜罐欄位與最短填寫時間。
在 10 分鐘內偵測重複送出。
依網站、表單、訪客工作階段與 IP 位址設定的速率限制。請參閱限制。

Studio 中的 Spam review 分頁會顯示來自 Development 的被隔離送出內容。目前尚無法在 Studio 中審查來自正式網站的被隔離送出內容。

潛在客戶電子郵件

網站擁有者在 Integrations → Email 下新增電子郵件連線（SMTP 或電子郵件服務供應商）。密碼與 API 金鑰會加密儲存，之後不會再次顯示，也不會寫入記錄。

Email for enquiries and leads 卡片有兩個開關：

Live website：Production 上線後預設為開啟。將它切換為「emails paused」即可在不更動表單的情況下停止寄送電子郵件。
Development：預設為關閉，因此測試送出不會寄信給任何人。測試送出會標示為 [Test]。

只有網站管理員可以變更這些開關。除非您開啟，否則不會自動回覆訪客。

後續閱讀

處理潛在客戶指派、合併、匯出並清理潛在客戶，並將它們送到您的 CRM。上線發布發行版本並開啟 Production，讓表單回應真實訪客。