潜在客户来源
什么是潜在客户来源连接？
潜在客户来源连接告诉 LeadHub 从哪里接收潜在客户。当有人填写您的 Facebook 潜在客户广告、提交 Google Ads 表单、预约 Calendly 约会或填写网络表单时，LeadHub 需要知道这些信息，以便自动创建潜在客户。
来源连接是外部平台与 LeadHub 之间的桥梁。您只需在管理面板中设置一次，之后每次新提交都会实时到达 LeadHub——无需手动复制粘贴。
支持的来源
LeadHub 支持来自 18 个平台的连接：
| 来源 | 捕获内容 |
|---|---|
| Facebook Lead Ads | 来自 Facebook 上 Meta 潜在客户广告活动的潜在客户 |
| Instagram Leads | 来自 Instagram 潜在客户广告活动的潜在客户 |
| TikTok Lead Generation | 来自 TikTok 潜在客户生成表单的潜在客户 |
| LinkedIn Lead Gen Forms | 来自 LinkedIn 潜在客户生成表单活动的潜在客户 |
| WhatsApp Business | 通过 WhatsApp Business webhook 发送的潜在客户 |
| Viber | 通过 Viber webhook 发送的潜在客户 |
| Telegram | 通过 Telegram webhook 发送的潜在客户 |
| Twitter / X | 通过 webhook 发送的 Twitter/X 活动潜在客户 |
| Snapchat Lead Ads | 来自 Snapchat 潜在客户广告的潜在客户 |
| Pinterest Lead Ads | 来自 Pinterest 潜在客户广告的潜在客户 |
| Google Ads Lead Forms | 来自 Google Ads 潜在客户表单扩展的潜在客户 |
| YouTube Lead Forms | 来自 YouTube 潜在客户表单广告扩展的潜在客户 |
| Microsoft Advertising | 来自 Microsoft Ads 潜在客户表单的潜在客户 |
| Email (IMAP) | 从连接的电子邮件收件箱解析的潜在客户 |
| Typeform | 来自 Typeform 表单提交的潜在客户 |
| JotForm | 来自 JotForm 表单提交的潜在客户 |
| Calendly | 来自 Calendly 预约确认的潜在客户 |
| LeadHub Web Form | 来自您在 LeadHub 内创建的表单的潜在客户 |
如何创建来源连接
- 在左侧栏转到集成 > 潜在客户来源。
- 点击新建潜在客户来源。
- 填写：
- 连接名称 — 此特定连接的名称。请具体描述，例如"Facebook – 夏季促销活动"或"Google Ads – 品牌关键词"。您可以有来自同一来源的多个连接。
- 来源类型 — 从下拉菜单中选择平台。
- 活跃 — 保持开启状态。
- 点击创建保存连接。
保存后，表单会展开显示根据来源类型不同的附加选项：
- 对于基于 webhook 的来源（大多数平台），您将看到唯一的 Webhook URL。复制此 URL 并将其粘贴到来源平台的 webhook 或集成设置中。
- 对于基于 OAuth 的来源（Facebook、Instagram、TikTok、LinkedIn、Google Ads、Microsoft Ads），您将看到 OAuth 授权部分。按照屏幕上的说明通过 OAuth 连接。
- 对于电子邮件 (IMAP)，您将看到电子邮件服务器的凭据字段。
分配默认管道和阶段
编辑来源连接时，滚动到设置部分以分配默认管道和阶段。通过此连接到达的每个潜在客户都将自动放置在您在此处选择的管道和 阶段中。
如果您运行多个活动，这非常有用——每个活动都有自己的来源连接，每个连接指向不同的管道阶段。潜在客户在到达的那一刻就被自动组织。
基于 Webhook 的来源
大多数来源（Facebook、Google Ads、TikTok、LinkedIn、WhatsApp、Calendly、Typeform、JotForm 等）通过 webhook 工作。
Webhook URL 的工作原理
当您创建来源连接时，LeadHub 会为该连接生成一个唯一的、秘密的 webhook URL。它看起来像这样：
https://yourdomain.com/webhook/inbound/{tenant-id}/{source}/{token}
此 URL 是：
- 唯一的 — 每个连接都有自己的 URL，带有 48 字符的随机令牌
- 秘密的 — 只有知道此 URL 的平台才能向其发送潜在客户
- 始终在线 — 自动全天候接受传入数据
您从连接的编辑页面复制此 URL（保存连接后它显示在"Webhook URL"部分）并将其粘贴到来源平台。
在哪里找到 Webhook URL
- 转到集成 > 潜在客户来源。
- 点击连接上的编辑（铅笔）图标。
- "Webhook URL"部分显示您的唯一 URL 和复制按钮。
字段映射
当潜在客户通过 webhook 到达时，来源平台以其自己的格式发送数据。LeadHub 自动尝试将传入字段映射到正确的潜在客户字段（姓名、电子邮件、电话等）。
如果自动映射未能捕获您需要的字段，您可以在连接设置中配置自定义字段映射。这是一个键值列表，您可以告诉 LeadHub："当传入数据有一个名为 full_name 的字段时，将其放入潜在客户的 first_name 字段。"
基于 OAuth 的来源
某些平台（Facebook、Instagram、TikTok、LinkedIn、Google Ads、Microsoft Ads）使用 OAuth 来授权连接。这意味着您不需要复制 webhook URL，而是点击按钮并登录平台，授予 LeadHub 接收您的潜在客户的权限。
如何通过 OAuth 连接：
- 首先创建并保存来源连接。
- 返回潜在客户来源列 表。
- 点击连接行上的通过 OAuth 连接按钮。
- 您将被重定向到平台的登录页面。
- 登录并点击允许或授权。
- 您被重定向回 LeadHub。连接状态更改为已连接。
您的 API 凭据（访问令牌、刷新令牌）自动存储并加密。您永远不需要手动复制粘贴令牌。
电子邮件 (IMAP) 来源
电子邮件来源将 LeadHub 连接到电子邮件收件箱。当有人向该收件箱发送电子邮件时，LeadHub 读取电子邮件并从中创建潜在客户。
如何设置：
创建电子邮件来源连接时，您将在 API 凭据部分看到凭据字段：
- IMAP 主机 — 您的电子邮件服务器地址（例如
imap.gmail.com） - IMAP 端口 — SSL 通常为
993 - 用户名 — 电子邮件地址（例如
[email protected]） - 密码 — 电子邮件账户密码或应用程序密码
工作原理： LeadHub 定期轮询您的收件箱查找新电子邮件（按固定时间表）。找到新电子邮件时，它解析发件人的姓名和电子邮件地址并创建潜在客户。电子邮件主题和正文存储为潜在客户的备注。
Gmail 提示： Google 要求您使用"应用程序密码"而不是普通账户密码。转到您的 Google 账户安全设置，为 LeadHub 创建应用程序密码。
提示： 创建一个专门用于潜在客户的电子邮件地址（例如
[email protected]），而不是连接您的主要业务收件箱。这样可以保持整洁，避免 LeadHub 处理非潜在客户询问的电子邮件。
字段映射说明
字段映射是 LeadHub 知道哪条传入数据应该进入哪个潜在客户字段的方式。
当 Facebook 发送潜在客户时，它可能发送一个名为 full_name 的字段。LeadHub 需要知道将其拆分为 first_name 和 last_name。当 Calendly 发送预约时，它可能发送 invitee_email。LeadHub 需要知道这对应 email 字段。
自动映射： LeadHub 为每个平台的常见字段名称内置了映射。大多数情况下它直接可用。
自定义映射： 如果您的潜在客户表单上有自定义问题（例如"您的预算是多少？"），您可以告诉 LeadHub 将答案放在哪里。在连接的设置部分，添加映射条目：
- 传入字段名称 — 与平台发送的完全相同（例如
question_budget） - 潜在客户字段 — 存储位置（例如您设置的自定义字段键）
来源绩效分析
转到报告 > 来源绩效查看每个来源连接的表现。报告显示：
- 每个来源收到的潜在客户总数
- 每个来源的转化率
- 每个来源随时间变化的潜在客户数
您可以使用此功能查看哪些广告渠道实际上在提供高质量潜在客户，而不仅仅是数量。
停用和编辑来源连接
暂时暂停连接（停止接收潜在客户但不删除它）：
- 转到集成 > 潜在客户来源。
- 点击连接上的编辑（铅笔）图标。
- 关闭活跃。
- 点击保存。
连接已暂停。发送到其 webhook URL 的潜在客户将被忽略，直到您重新激活它。
编辑连接（重命名、更新凭据、更改字段映射）：
- 转到集成 > 潜在客户来源。
- 点击编辑（铅笔）图标。
- 进行更改并点击保存。
永久删除连接： 点击连接行上的垃圾桶图标。连接被删除。已通过它接收的潜在客户仍保留在您的系统中——不会被删除。