跳到内容
All articles
Integrations

网站表单、WordPress 与采集 SDK

直接将你网站上任意表单(WordPress、Wix、纯 HTML)的线索采集到 CRM 中:粘贴一个现成的 HTML 表单,或使用 JS 采集 SDK。每次提交都会自动生成一条线索。

“网站表单/WordPress”集成会从你网站上的任意表单中采集线索,每次提交都会在 CRM 中创建一条线索。它由我们自主构建,无需外部账号:你只需生成一个采集地址(一个公开令牌),并将表单指向该地址即可。字段的映射方式非常灵活(姓名/邮箱/电话/公司/留言),线索的来源会保持为“网站”(或你在“source”字段中设置的值)。

它既支持以普通 HTML 表单形式提交(application/x-www-form-urlencoded),也支持以 JSON 形式提交,因此无论是你粘贴的 <form>,还是通过代码调用,都能正常工作。该地址接受来自任意域名的 POST 请求(CORS 已开放),因为其目的正是接收来自客户网站的提交内容。该功能默认处于未激活状态:在你生成地址并启用之前,不会采集任何数据。

前提条件

  • 无需外部账号或凭证:该采集功能由我们自主构建。
  • 拥有编辑网站的权限:可以粘贴一个 <form> 或一段 <script>(在 WordPress 中可使用“自定义 HTML”区块或主题的页脚;同样适用于 Contact Form 7、Elementor、Wix 或纯 HTML 页面)。
  • 在 Sellio 中,需要是管理员才能在“设置 → 集成”中生成采集地址并启用该集成。

如何启用

  1. 打开“设置 → 集成”,进入“网站表单/WordPress”卡片。
  2. 点击“生成采集地址”以创建 webhook URL(一个唯一的、公开的采集令牌)。
  3. 复制现成的 HTML 表单(或 SDK 代码),并按下方说明粘贴到你的网站上。
  4. 点击“启用”。此后,每次提交都会开始在 CRM 中创建线索。

方式 A:现成的 HTML 表单

在卡片上,复制现成的 <form> 代码块(它已指向你的采集地址),并粘贴到你想展示表单的任意位置。在 WordPress 中,可使用“自定义 HTML”区块。你可以自由调整字段:name、email、phone、company 和 message 等字段名会被自动识别。可选的隐藏字段“redirect”可在提交后将访客带到一个感谢页面。

Example: <form action="https://app.yourdomain.com/api/inbound/webform/YOUR_TOKEN" method="POST"> … <input name="email" required> … </form>

方式 B:JS 采集 SDK(面向开发者)

如果你的网站(或应用)已经有自己的表单,可以将 SDK 的 <script> 粘贴到网站中。它在浏览器中提供两个方法,且不涉及任何敏感数据(脚本中只包含公开的采集令牌):

  • window.Sellio.capture({ name, email, phone, company, message, source }) 直接发送一条线索(适用于按钮、弹窗或应用内流程)。
  • Sellio.trackForm('#my-form') 会拦截某个现有表单的提交操作,并将字段发送到 CRM,而无需修改表单的 HTML。
Example: <script src="https://app.yourdomain.com/api/sdk/YOUR_TOKEN/sellio.js" async></script> → 然后调用:Sellio.trackForm('.wpcf7-form')

WordPress:Contact Form 7、Elementor 与 HTML 区块

  • HTML 区块:将现成的表单(方式 A)粘贴到页面的“自定义 HTML”区块中。
  • Contact Form 7:保留你现有的 CF7 表单,并将 SDK(方式 B)添加到主题的页脚;然后调用 Sellio.trackForm(".wpcf7-form")。CF7 的字段名(your-name、your-email)已被自动识别。
  • Elementor:保留 Elementor 表单,并将 SDK 添加到网站中;使用 Sellio.trackForm() 并传入你表单的选择器,即可将每次提交发送到 CRM。

哪些内容会成为线索

每次包含可识别信息(邮箱、电话或姓名)的提交都会创建一条线索,来源由“source”字段决定(默认值为“网站”)。你发送的非标准字段会被附加到线索的留言中,因此不会丢失任何信息。采集功能在尽力而为的基础上具有幂等性:如果你发送了“external_id”,重复提交相同 id 不会产生重复数据;如果没有 external_id,具有相同邮箱的线索同样不会重复。

安全性

  • URL 令牌是公开的,仅用于采集:它标识你的账号,但不会暴露任何数据,也无法读取任何信息。切勿在表单或 SDK 中放置密钥。
  • 如果需要作废当前地址,使用“生成新令牌”,旧的表单/SDK 将失效。
  • 无效的令牌或已停用的集成将返回 404;完全为空(没有任何可识别信息)的提交会被静默忽略。
💡 建议先使用现成的 HTML 表单快速验证效果,等你想保留当前 WordPress 表单的样式时,再切换到 SDK(trackForm)方式。

如何测试

  1. 将现成的 HTML 表单(方式 A)粘贴到你网站的测试页面上,并启用该集成。
  2. 使用测试邮箱填写并提交表单。
  3. 在 CRM 中打开线索列表,确认出现了一条来源为“网站”(或“source”字段所设置的值)的线索。
  4. 使用相同的邮箱(或相同的 external_id)再次提交,确认不会产生重复数据。

故障排查

  • 未创建线索:确认集成状态为“已启用”,且 <form>/SDK 指向了正确的采集地址。完全为空的提交(没有邮箱、电话或姓名)会被静默忽略。
  • URL 返回 404:地址令牌已变更(你点击了“生成新令牌”),或该集成已被停用。请复制当前地址并更新表单/SDK。
  • SDK 未能拦截表单:检查传给 Sellio.trackForm() 的选择器(例如“.wpcf7-form”);在 CF7/Elementor 中,SDK 必须已在网站上加载(主题页脚)。
  • 字段未能传递:请使用可识别的字段名(name、email、phone、company、message);CF7 的字段名(your-name、your-email)已被自动接受。多余的字段会被附加到线索的留言中。
  • 请勿在表单中放置密钥:URL 令牌是公开的,仅用于采集,既不会暴露数据,也不会读取数据。

Open this article inside the system

Read it and want to see it working?

The account is free and the whole manual is available inside the system, with an assistant that answers from this very content.

免费创建账户
网站表单、WordPress 与采集 SDK · Sellio