Setup

表单广告（Meta 和 LinkedIn）

通过你的 Facebook/Instagram 广告（Meta Lead Ads）或 LinkedIn 广告（Lead Gen Forms）提交的每一份表单都会自动成为 CRM 中的线索，使用你自己的应用（BYO 模式）。

表单广告集成使用你自己的应用以及你自己的主页/广告账户（这就是 BYO，即“自带应用”模式）。当有人在 Facebook/Instagram（Meta）或 LinkedIn 广告中填写表单时，CRM 会自动创建一条线索并按轮询方式分配负责人，与公开表单获客的方式相同。数据直接来自你的广告账户，我们这边不做任何中间处理。

集成一开始处于未激活状态：在你填写凭据并开启之前不会发生任何事。App Secret 和访问令牌会以加密方式存储在 CRM 中，且永远不会再次显示给你。

前提条件

Meta：在 developers.facebook.com 创建的应用、运行广告的 Facebook 主页，以及 leads_retrieval 和 pages_manage_metadata 权限；你还需要 App Secret 和一个长期有效的主页访问令牌。
LinkedIn：在 linkedin.com/developers 创建的、具备 Lead Sync / Advertising API 访问权限的应用，以及带有 r_marketing_leadgen_automation 权限范围的 OAuth 访问令牌。
广告系列中已创建好表单广告（Meta Lead Ads / LinkedIn Lead Gen Forms）。
在 Sellio 中拥有管理员权限，以便在“设置 → 集成”中保存凭据并启用该集成。

Meta（Facebook/Instagram）的工作原理

Meta 的 webhook 不会发送表单数据本身，只会发送一个标识符（leadgen_id）。收到该标识符后，CRM 会验证事件签名（使用你的 App Secret 对请求体进行 HMAC-SHA256 校验），然后使用你的主页访问令牌通过 Meta Graph API 拉取该条线索，获取提交的字段（field_data）。这些字段会被映射到线索字段，并创建线索。

配置 Meta：在 Meta 后台

在 developers.facebook.com 创建（或使用现有）应用。在“设置 → 基本信息”中复制 App Secret。
添加“Webhooks”产品以及 Leadgen 对象/产品（Leads Access）。为你的主页申请 leads_retrieval 和 pages_manage_metadata 权限。
为运行广告的主页生成一个长期有效的主页访问令牌（可通过 Graph API Explorer 或 Business Manager 生成）。
将所有信息准备好：稍后需要在 CRM 中粘贴 App Secret、主页令牌，以及一个“verify token”（由你自行设定的字符串）。

配置 Meta：在 CRM 中

打开“设置 → 集成”，找到“Meta 表单广告（Facebook/Instagram）”卡片。
Verify token：任选一个字符串并输入。稍后在 Meta 后台中要使用完全相同的值。
App Secret 和主页访问令牌：将两者一起粘贴（会被一并加密保存），然后点击“保存凭据”。
复制出现的“Webhook 网址（Meta）”。
返回 Meta 后台 → Webhooks，将该网址粘贴为 Callback URL，并将你的 verify token 粘贴为 Verify Token。Meta 会进行一次握手（GET 请求），当 verify token 匹配时，CRM 会响应该验证挑战。
订阅你主页的“leadgen”字段。然后回到 CRM 并点击“启用”。

配置 LinkedIn

在 LinkedIn（Lead Gen Forms）中，于 linkedin.com/developers 创建一个应用，申请 Lead Sync / Advertising API 相关产品，并生成一个具备表单获客权限范围（r_marketing_leadgen_automation）的 OAuth 访问令牌。在 CRM 中，于“LinkedIn 表单获客（Lead Gen Forms）”卡片上，粘贴访问令牌（可选地填写组织 URN），保存并启用。将你的自动化（或表单响应的拉取任务）指向“入站网址（LinkedIn）”，发送包含表单字段的 JSON 数据。

字段映射

每一行映射都将广告表单中的某个字段名称（左侧）关联到一个线索字段（右侧，按 api_name 指定：email、name、phone、company、title……）。系统已内置合理的默认映射：full_name → name、email → email、phone_number → phone、company_name → company。仅需为你表单中的自定义字段添加映射行。如果表单分别发送 first_name 和 last_name（LinkedIn 上常见），它们会被合并为 name。

示例: 假设你的 Meta 表单中包含 full_name、email、phone_number，以及一个自定义字段“budget”。将 budget 映射到一个线索字段（例如 segment）。其余字段已由默认映射处理好。

💡 创建过程是幂等的：同一条线索不会被重复创建。CRM 会按 leadgen_id（webhook 重复投递时）以及邮箱进行去重。如果表单未包含邮箱，该线索会被忽略，因为邮箱是线索的唯一必填字段。如果“company”字段已填写，CRM 会查找或创建对应的公司并将其关联。

请将 webhook 网址、App Secret 和令牌都视为机密。无效签名会被拒绝（401）。没有主页访问令牌，CRM 就无法通过 Graph API 获取线索数据，这就是为什么要将令牌与 App Secret 一起粘贴。有一个限制需要注意：原生的 LinkedIn 拉取方式（订阅 leadNotifications 后再通过 API 拉取响应）已在此说明并可以接入；目前该路由接收的是已经规范化的表单响应负载。

如何测试

Meta：在 Meta 后台 → Webhooks 中，保存 Callback URL 时的握手（GET 请求）就已经验证了 verify token。然后使用 Meta 的“Lead Ads Testing Tool”（developers.facebook.com/tools/lead-ads-testing）向你的表单发送一条测试线索。
在 CRM 中检查：应出现一条包含映射字段的新线索；如果传来了公司信息，对应公司应被查找/创建并关联。
LinkedIn：触发（或手动发送）一个表单响应负载到“入站网址（LinkedIn）”，并检查生成的线索。

故障排查

Meta 握手失败：CRM 中输入的 verify token 必须与 Meta 后台中的 Verify Token 完全一致。让两者匹配后再保存。
收到了 webhook 但未创建线索：没有主页访问令牌，CRM 就无法从 Graph API 获取 field_data。请将主页令牌与 App Secret 一起粘贴。确认已具备 leads_retrieval/pages_manage_metadata 权限，并已订阅主页的“leadgen”字段。
签名无效（401）：CRM 中的 App Secret 与 Meta 应用中的不一致（签名是使用 App Secret 对请求体进行的 HMAC-SHA256 校验）。请重新粘贴正确的 App Secret。
没有邮箱的线索会被忽略：邮箱是线索的唯一必填字段。请确保广告表单包含邮箱字段。
字段未填充：检查映射设置（表单字段名称对应线索的 api_name）。在 LinkedIn 上，first_name + last_name 会被自动合并为 name。

在系统内打开这篇文章 →