您自己網站上的表單 — 白皮書下載、示範申請、聯絡頁面 — 可以直接在 AB Sales 裡建立潛在客戶，後端系統或自動化工具也可以。兩者都使用同一把來自 CRM 設定的接收金鑰。您的網站上不需要任何登入，而且一個純 HTML 表單完全不需要 JavaScript。
金鑰在哪裡
開啟您的工作區 → 設定 → 網站表單與 API 卡片。Owner（擁有者）或 Admin（管理員）第一次開啟它時會建立一把金鑰；成員看到的是同一把金鑰，但只能讀取。卡片上顯示金鑰與一個複製按鈕、一段可直接貼上的 HTML 表單程式碼片段、一個 API 範例，以及一個重新產生金鑰按鈕。
兩種進入方式
純 HTML 表單
您現有的表單直接送出到 AB Sales，再把訪客帶往您的感謝頁面。最適合身邊沒有開發人員的網站上的下載或聯絡表單。
JSON API
您的後端、Zapier、Power Automate，或任何能發出網路請求的工具，以 JSON（一種用於結構化資料的純文字格式）送出同樣的欄位，並把金鑰當作 bearer token 帶上。
1. 把 HTML 表單指向 AB Sales
- 複製程式碼片段。在網站表單與 API 卡片上，按一下 HTML 表單旁邊的複製。它已經帶著您的金鑰。
- 更改感謝頁面的網址。隱藏的
redirect欄位決定訪客送出後會到哪裡 — 您的下載或感謝頁面，以完整的https://位址填寫。 - 保留隱藏欄位，再加上您自己的。
key和redirect負責運作；ab_hp是一個蜜罐（honeypot，人看不到的欄位，所以一個會填滿所有找到的欄位的機器人會自己露餡，其送出內容會被捨棄）。以完全相同的名稱加入company、phone、website或message作為額外輸入欄位。 - 自己先送出一次。這筆潛在客戶片刻後就會出現在潛在客戶裡，來源為 Website。
<form method="post" action="https://blz.actionbridge.io/api/crm/leads/form">
<input type="hidden" name="key" value="lk_…your key…">
<input type="hidden" name="redirect" value="https://www.example.com/thank-you">
<input type="text" name="ab_hp" value="" tabindex="-1" autocomplete="off" style="display:none">
<input name="name" placeholder="Your name">
<input name="company" placeholder="Company">
<input name="email" type="email" required placeholder="Work email">
<button type="submit">Download</button>
</form>message 欄位，例如 Downloaded: Pricing guide，會寫進這筆潛在客戶的備註，讓接手的人知道這個人為什麼來 — 而且 AI 研究也會讀取備註。欄位
只有電子郵件是必填的 — 它是辨識重複送出的依據，也是聯絡這筆潛在客戶的方式。其他一切都是選填。
| 表單欄位 | API 欄位 | 成為 |
|---|---|---|
email 必填 | email | 電子郵件 |
name | name | 聯絡人姓名 — 或在沒有提供公司時，成為這筆潛在客戶的名稱 |
company | company | 名稱。有填寫時，name 會成為聯絡人，和 Teams 機器人的做法相同 |
phone、website、industry | 相同 | 電話、網站、產業 |
source | source | 來源。預設為 Website；潛在客戶清單會依它篩選，所以請維持少數幾個值 |
message | message | 備註，最多 4,000 個字元 |
country、language、timezone | countryCode、preferredLanguage、timeZone | 國家（JP）、偏好語言（ja-JP）、時區（Asia/Tokyo）。不是有效代碼的值會被拒絕，所以這筆潛在客戶永遠不會帶著一個下游任何系統都讀不懂的值 |
文字欄位上限為 200 個字元。如果送出被拒絕，回應會指出是哪個欄位。
2. JSON API
同樣的欄位，改為駝峰式命名，並把金鑰作為 bearer token（放在 Authorization 標頭中）送出。無法設定該標頭的工具，可以改用 X-AB-Key 標頭帶上金鑰。
curl -X POST https://blz.actionbridge.io/api/crm/leads \
-H "Authorization: Bearer lk_…your key…" \
-H "Content-Type: application/json" \
-d '{"name":"Aoi Sato","company":"Contoso","email":"aoi@contoso.com","message":"Downloaded the pricing guide"}'| 狀態 | 意義 |
|---|---|
| 201 | 新的潛在客戶。回應內容帶著它的 leadId。 |
200 existing: true | 重複送出：改為在那筆潛在客戶上加了一則備註（見下方）。 |
| 400 | 有欄位不正確。錯誤訊息會說明是哪一個。 |
| 401 | 未知的金鑰 — 打錯了，或是之後已重新產生。 |
| 429 | 工作區已超過潛在客戶額度，或是同一個位址每分鐘送出超過 60 次請求。 |
重複送出不會產生重複資料
如果某個電子郵件已經屬於工作區裡一筆有效的潛在客戶，再次送出不會建立另一筆潛在客戶。系統會在既有的那筆上加一則備註 — 「再次透過網站表單送出。」加上他們寫的內容 — 讓團隊在原本就在處理的地方看到對方再度表現出的興趣，額度也不會為同一個人花掉兩次。比對時不分大小寫；已封存的潛在客戶不算在內，所以被封存後又回來的人會從頭開始。
您的訪客會看到什麼
有 redirect 時，一律是您的感謝頁面 — 包括送出內容屬於重複、來自機器人，或工作區已超過潛在客戶額度的情況。您的方案上限是您的事，不是訪客的事。沒有 redirect 時（以 JavaScript 送出的表單），端點會以上表中的 JSON 回應。
如果金鑰被濫用
濫用讓您付出的代價是垃圾潛在客戶和額度，除此之外沒有別的。在卡片上按一下重新產生金鑰並確認，舊金鑰會立即失效 — 接著把新金鑰貼進每一個使用過它的表單和整合。請求也會依呼叫位址限制速率，所以爬蟲會撞上一道真正的網頁永遠不會碰到的牆。
您的網站表單只是潛在客戶抵達的另一種方式：同樣的潛在客戶、同樣的漏斗、同樣的額度 — 只是不用再打字了。