你自己网站上的一个表单 —— 白皮书下载、演示申请、联系页面 —— 可以直接在 AB Sales 中创建线索，后端程序或自动化工具也同样可以。两者用的都是来自 CRM 设置的同一把接收密钥。你的网站上没有任何东西需要登录，一个普通的 HTML 表单甚至完全不需要 JavaScript。
密钥在哪里
打开你的工作区 → 设置 → 网站表单与 API 卡片。Owner（所有者）或 Admin（管理员）第一次打开它时会创建一把密钥；成员看到的是同一把密钥，只读。卡片上显示接收密钥和一个复制按钮、一段可直接粘贴的 HTML 表单代码片段、一个 API 示例，以及一个重新生成密钥按钮。
两条进来的路
一个普通的 HTML 表单
你现有的表单直接提交到 AB Sales，然后把访客送到你的感谢页面。最适合身边没有开发人员的网站上的下载表单或联系表单。
JSON API
你的后端、Zapier、Power Automate 或任何能发出网络请求的工具，以 JSON（一种表示结构化数据的纯文本格式）发送同样的字段，并把密钥作为 bearer 令牌附上。
1. 把 HTML 表单指向 AB Sales
- 复制代码片段。在网站表单与 API 卡片上，点击 HTML 表单旁边的复制。它已经带着你的密钥。
- 改掉感谢页面的网址。隐藏字段
redirect是访客提交后落到的地方 —— 你的下载页或感谢页，写成完整的https://地址。 - 保留隐藏字段，再加上你自己的。
key和redirect负责干活；ab_hp是一个蜜罐（一个人永远看不到的字段，所以见字段就填的机器人会暴露自己，它的提交会被丢弃）。把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 令牌发送（放在 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 个。 |
重复提交不会产生重复线索
如果某个邮箱已经属于工作区里一条有效的线索，来自它的第二次提交不会再创建一条线索。而是在已有的那条上添加一条备注 —— “Submitted again through the website form.”（通过网站表单再次提交）加上他们写的内容 —— 这样团队就在自己已经在跟进的地方看到对方重新表露的兴趣，额度也不会在同一个人身上花两次。匹配时忽略字母大小写；已归档的线索不算在内，所以一个被归档后又回来的人会从头开始。
你的访客看到什么
带有 redirect 时，永远是你的感谢页面 —— 包括这次提交是重复的、来自机器人的，或者工作区已超出线索额度的情况。你的套餐限额是你的事，与访客无关。没有 redirect 时（用 JavaScript 提交的表单），端点会以上表中的 JSON 作答。
如果密钥被滥用
滥用让你损失的只是垃圾线索和额度，别无其他。在卡片上点击重新生成密钥，确认，旧密钥立即失效 —— 然后把新密钥粘贴到每一个用过它的表单和集成里。请求还会按调用方地址限速，所以爬虫会撞上一道真实页面永远碰不到的墙。
你的网站表单只是线索到来的又一条路：同样的线索、同样的漏斗、同样的额度 —— 只是不用再打字了。