跳到主要内容

配置 Webhook

接下来我们将告诉 Facebook 在哪里 发送潜在客户数据，也就是配置 “Webhook”——相当于给 Facebook 您 CRM 的地址。

什么是 Webhook？​

简单来说：

Someone fills out your Lead Form on Facebook/Instagram
         ↓
Facebook says: "Hey, I got a new lead!"
         ↓
Facebook sends the lead data to YOUR webhook URL
         ↓
Your module receives it and creates the lead in Perfex CRM

Webhook 就是您服务器上的一个 URL，Facebook 会把数据发送到这里。模块会自动创建该 URL，您只需告诉 Facebook 即可。

从 Perfex 获取 Webhook 信息​

在去 Facebook 之前，先从模块中获取以下信息：

  1. 登录 Perfex CRM
  2. 在侧边栏进入 Meta Leads → Settings
  3. 首先输入 App ID 和 App Secret（来自第 1 步），然后点击 Save Settings
  4. 向下滚动到 Webhook Settings 部分
  5. 您会看到两个值：
字段示例说明
Webhook Callback URLhttps://yourcrm.com/facebookleadsintegration/webhookFacebook 发送数据的目标地址
Verify Tokena1b2c3d4e5f6g7h8i9j0用于验证连接的密钥
  1. 点击每个值旁边的 Copy 按钮
注意

Callback URL 必须以 https:// 开头——Facebook 要求使用 SSL！若您的 URL 以 http:// 开头，需先安装 SSL 证书。

在 Meta 应用中添加 Webhook​

1. 打开 Meta 应用面板​

前往您的应用：

👉 https://developers.facebook.com/apps/

点击您的应用打开。

2. 添加 Webhooks 产品​

  1. 在左侧边栏查找 "Add Product" 或在面板中向下滚动
  2. 在产品列表中找到 "Webhooks"
  3. 点击 "Set Up" 或 "Configure"
提示

如果左侧边栏中已有 "Webhooks"，直接点击即可；无需重复添加。

3. 选择 "Page" 作为对象类型​

  1. 在 Webhooks 页面，默认会显示 "User" 的下拉菜单
  2. 将该下拉菜单改为 "Page"
注意

非常重要！ 必须选择 "Page"——不能是 "User"、"Application" 或其他任何选项。潜在客户数据通过 Pages 订阅获取。

4. 订阅 Webhook​

  1. 点击 "Subscribe to this object" 按钮（若已配置则显示 "Edit Subscription"）
  2. 会弹出对话框要求输入两个值：
字段输入内容
Callback URL粘贴模块中的 Webhook URL（例如 https://yourcrm.com/facebookleadsintegration/webhook）
Verify Token粘贴模块中的 Verify Token
  1. 点击 "Verify and Save"

5. 点击 "Verify and Save" 后会发生什么​

Facebook 会立即向您的 Webhook URL 发送 验证请求：

Facebook: "Hey, is this really your server?"
Your Module: "Yes! Here's the verify token to prove it!"
Facebook: "Great, verified!"

若成功： 会显示成功消息，对话框关闭。

若失败： 请参阅 Troubleshooting 获取常见解决方案。

6. 订阅 "leadgen" 事件​

验证成功后，需要告诉 Facebook 发送 哪些 事件：

  1. 在 Page 订阅下会看到事件类型列表
  2. 找到 "leadgen"（可能需要滚动）
  3. 点击 "leadgen" 旁边的 "Subscribe" 开关/复选框
提示

"leadgen" 是您唯一需要订阅的事件。 无需订阅其他事件（如 "messages" 或 "feed"），只需 "leadgen"。

验证成功！​

您的 Webhook 配置应类似这样：

Webhooks
├── Object: Page
├── Callback URL: https://yourcrm.com/facebookleadsintegration/webhook ✅
├── Verify Token: ✅ Verified
└── Subscriptions:
    └── ✅ leadgen (subscribed)

返回 Perfex CRM 模块，Webhook 状态指示器应显示 绿色/Verified！

如何测试 Webhook​

想确认 Webhook 是否正常工作？

  1. 进入 Perfex CRM → Meta Leads → Settings
  2. 点击 "Test Connection" 按钮
  3. 应看到所有绿色勾选

更详细测试将在 Testing Leads 部分进行。

常见错误及避免方法​

错误解决方法
选择了 "User" 而不是 "Page"将下拉菜单改为 "Page"
忘记订阅 "leadgen"在列表中找到 "leadgen" 并订阅
使用了 HTTP 而非 HTTPS在服务器上安装 SSL 证书
Callback URL 中有拼写错误直接从模块设置中复制粘贴
"Callback URL couldn't be validated"查看 Troubleshooting

Webhook 已配置？ Connect Your Pages