跳到主要内容

安装后的第一步

恭喜 — LeadHub 已安装完毕，您已登录管理面板。本指南将引导您完成首次会话中应做的所有事项，使 LeadHub 完全投入运行。按顺序执行这些步骤，您将在 30 分钟内准备就绪。

熟悉管理面板​

在开始设置任务之前，花 60 秒熟悉一下界面。LeadHub 管理面板左侧有一个侧边栏。主要部分包括：

  • 仪表板 — 您的概览页面，包含关键统计数据：潜在客户总数、今日新增、本周新增、本月新增、转化率、活跃管道数量和平均响应时间。图表显示潜在客户随时间的变化量、按来源分类的潜在客户和管道分布。
  • 潜在客户 — 系统中所有潜在客户的完整列表。您可以从这里筛选、搜索、排序、收藏、标记、分配和管理潜在客户。
  • 看板 — 一个可视化的拖放面板，按管道阶段显示您的潜在客户（类似 Trello，但用于潜在客户）。
  • 管道 — 您创建和管理销售/资格审查阶段的地方。
  • 潜在客户来源 — 您连接外部来源的地方，如 Facebook Lead Ads、Google Ads、Typeform 等。
  • 表单 — 内置的网页表单构建器，用于在您的网站上嵌入潜在客户捕获表单。
  • 自动化 — 您构建自动化工作流的地方，当潜在客户发生某些事件时触发。
  • 集成 — 与第三方工具的预构建连接。
  • 邮件模板 — 用于自动化邮件的可重用邮件模板。
  • 团队 — 管理用户、角色和邀请。
  • 报告 — 关于潜在客户数量、来源表现、代理表现、管道漏斗、转化率等的详细报告。
  • 设置 — 所有配置：常规设置、邮件、品牌、安全、API 密钥、许可证等。
  • API 密钥 — 创建和管理用于连接外部工具的 API 密钥。

设置部分在侧边栏中展开，包含多个子页面：常规、邮件、品牌、安全、许可证等。

步骤 1 — 设置 Cron 任务​

首先执行此操作，优先于其他一切。 Cron 任务是使 LeadHub 实时工作的关键。没有它：

  • 来自 Facebook、Google Ads 和其他来源的潜在客户将留在队列中，不会出现在您的仪表板上
  • 自动化将不会运行
  • 计划邮件将不会发送
  • IMAP 邮件来源将不会被检查
  • 计划报告将不会被送达

Cron 任务在后台每分钟运行一次，自动处理所有这些事务。您只需设置一次即可。

有关如何在 cPanel、Plesk 和 DirectAdmin 中添加 cron 任务的完整说明，请参阅共享主机指南 — 设置 Cron 任务。

您需要添加的命令（每分钟运行）是：

php /home/yourusername/leadhub/cron.php >> /dev/null 2>&1

将路径替换为服务器上 cron.php 文件的实际路径。

步骤 2 — 配置邮件（设置 → 邮件）​

LeadHub 需要您的 SMTP 邮件详细信息来发送任何类型的邮件 — 团队成员邀请邮件、潜在客户通知邮件、自动化邮件、计划报告邮件和测试邮件。

如何配置邮件​

  1. 在管理面板中，点击侧边栏中的设置。

  2. 点击设置部分下的邮件。

  3. 填写 SMTP 配置表单：

    字段输入内容
    Host您的邮件提供商的 SMTP 服务器地址（例如 smtp.gmail.com、smtp.mailgun.org、email-smtp.us-east-1.amazonaws.com）
    Port通常 TLS 使用 587，SSL 使用 465。请咨询您的邮件提供商。
    Encryption选择 TLS（最常见）或 SSL。仅在您的提供商要求时才使用 None。
    Username您的 SMTP 用户名（通常是您的邮箱地址，或根据提供商不同可能是 API 密钥）
    Password您的 SMTP 密码或 API 密钥

  4. 填写发件人地址部分：

    字段输入内容
    From Name将出现在收件人收件箱中的名称（例如 "Acme CRM" 或您的名字）
    From Email邮件看起来来自的邮箱地址（例如 [email protected]）

  5. 点击保存设置。

  6. 点击发送测试邮件（页面右上角的按钮）。LeadHub 将向您的管理员帐户邮箱地址发送一封测试邮件。如果收到了，就没问题。如果失败了，您会看到一条错误消息，告诉您出了什么问题（通常是错误的 SMTP 凭据或被阻止的端口）。

按提供商分类的常见 SMTP 设置​

Gmail / Google Workspace：

  • Host：smtp.gmail.com
  • Port：587
  • Encryption：TLS
  • Username：您的完整 Gmail 地址
  • Password：应用密码（不是您的常规 Gmail 密码 — 您需要在 Google 帐户 → 安全性 → 两步验证 → 应用密码 中生成应用密码）

Mailgun：

  • Host：smtp.mailgun.org
  • Port：587
  • Encryption：TLS
  • Username：您的 Mailgun SMTP 用户名（来自您的 Mailgun 域设置）
  • Password：您的 Mailgun SMTP 密码

Amazon SES：

  • Host：email-smtp.us-east-1.amazonaws.com（区域可能不同）
  • Port：587
  • Encryption：TLS
  • Username 和 Password：您的 SES SMTP 凭据（在 SES 控制台的 SMTP 设置下创建）

对于其他提供商，请查看其关于"SMTP 设置"的文档 — 他们都提供您需要的确切值。

步骤 3 — 创建您的第一个管道​

管道是潜在客户在您与其合作时所经历的阶段序列。例如：新潜在客户 → 已联系 → 已资格审查 → 已发送提案 → 赢得（或失去）。LeadHub 中的每个潜在客户都在特定阶段的管道中。

如何创建管道​

  1. 点击侧边栏中的管道。
  2. 点击**"新建管道"**按钮（右上角）。
  3. 为管道命名（例如 "销售管道"、"营销漏斗"，或任何适合您业务的名称）。
  4. 可选择编写描述。
  5. 如果您希望新潜在客户自动放入此管道，请勾选**"默认管道"**复选框。（您可以稍后更改。）
  6. 点击保存。

向管道添加阶段​

创建管道后，您将在列表中看到它。点击它（或点击编辑 / 管理阶段按钮）打开它并添加阶段。

  1. 点击**"添加阶段"**。
  2. 输入阶段名称（例如 "新建"、"已联系"、"已资格审查"、"已发送提案"、"赢得"、"失去"）。
  3. 为阶段选择颜色（有助于在看板中直观区分各阶段）。
  4. 点击保存。
  5. 对每个想要的阶段重复此操作。
  6. 如需要，拖放阶段以重新排序。

您的管道现已准备就绪。潜在客户将在您与其合作时经历这些阶段。

步骤 4 — 连接您的第一个潜在客户来源​

潜在客户来源是潜在客户进入 LeadHub 的方式。您可以同时连接多个来源。LeadHub 支持 19 种不同的来源。

如何添加潜在客户来源​

  1. 点击侧边栏中的潜在客户来源。
  2. 点击**"新建潜在客户来源"或"连接来源"**。
  3. 从列表中选择来源类型。
  4. 为连接命名（例如 "Facebook — 夏季活动"）。
  5. 按照该特定来源的屏幕指示操作。

潜在客户来源类型说明​

广告平台集成（基于 webhook）：

这些来源会在有人在广告平台上填写潜在客户表单时自动将潜在客户数据发送到 LeadHub。您只需连接一次，潜在客户就会自动流入。

  • Facebook Lead Ads — 当有人在您的 Facebook 广告上填写潜在客户表单时，其详细信息会立即发送到 LeadHub。您通过 LeadHub 生成的 Facebook Lead Ads webhook URL 来连接。
  • Instagram Leads — 与 Facebook Lead Ads 相同，因为 Instagram 广告通过 Meta 的平台管理。
  • TikTok Lead Generation — 来自 TikTok 活动的潜在客户表单。
  • Google Ads Lead Forms — 来自 Google 潜在客户表单广告扩展的潜在客户。
  • LinkedIn Lead Gen Forms — 来自 LinkedIn 广告的潜在客户。
  • YouTube Lead Forms — 来自 YouTube 广告活动的潜在客户。
  • Microsoft Advertising — 来自 Microsoft/Bing 广告活动的潜在客户。
  • Snapchat Lead Ads — 来自 Snapchat 广告的潜在客户。
  • Pinterest Lead Ads — 来自 Pinterest 广告的潜在客户。
  • Twitter / X — 来自 Twitter/X 广告的潜在客户。

消息平台集成（基于 webhook）：

  • WhatsApp Business — 来自 WhatsApp Business 的消息或订阅。
  • Telegram — 通过 Telegram 机器人获取的潜在客户。
  • Viber — 通过 Viber 获取的潜在客户。

表单工具集成（基于 webhook）：

这些连接到第三方表单构建器，以便表单提交自动发送到 LeadHub。

  • Typeform — 来自您的 Typeform 表单的提交。通过 LeadHub 中显示的 webhook URL 连接。
  • JotForm — 来自您的 JotForm 表单的提交。通过 JotForm 的 webhook 集成连接。
  • Calendly — 当有人通过 Calendly 预约会议时，会被添加为 LeadHub 中的潜在客户。

基于邮件：

  • Email (IMAP) — LeadHub 通过 IMAP 连接到邮箱并将收到的邮件转换为潜在客户。适合捕获直接给您发邮件的潜在客户。您提供 IMAP 服务器地址、端口、用户名和密码。Cron 任务会定期检查收件箱。

内置表单：

  • LeadHub 网页表单 — 您完全在 LeadHub 内创建的表单（参见侧边栏中的表单部分）。您用一小段代码将其嵌入到您的网站中。提交直接进入 LeadHub — 无需第三方服务。

手动：

  • 手动录入 — 简单地手动添加潜在客户。在潜在客户部分的任何位置点击**"新建潜在客户"**并填写详细信息。适合通过电话、名片或其他线下方式获得的潜在客户。

步骤 5 — 邀请团队成员（设置 → 团队）​

如果其他人将与您一起使用 LeadHub，请在此邀请他们。

如何邀请某人​

  1. 前往设置 → 团队（或点击团队，如果它出现在您的侧边栏中）。
  2. 点击**"邀请成员"**。
  3. 输入他们的邮箱地址。
  4. 选择他们的角色（参见下面的角色描述）。
  5. 点击发送邀请。

LeadHub 将向他们发送一封包含链接的邮件，用于接受邀请和设置帐户。（邮件必须已配置才能正常工作 — 参见步骤 2。）

角色说明​

LeadHub 有五个角色。每个角色决定了该人员可以查看和执行的操作。

角色权限说明
超级管理员拥有一切的完全访问权限 — 所有潜在客户、所有设置、所有团队管理、所有账单。安装 LeadHub 的帐户以此角色开始。应该只有一到两个超级管理员。
管理员几乎与超级管理员相同。可以管理一切，包括团队成员、设置和所有潜在客户。无法管理许可证或系统级设置。适合可信赖的经理或合伙人。
经理可以查看和管理潜在客户（包括导入、导出和分配），管理管道，创建和编辑表单和自动化，查看集成，查看报告和查看团队成员。无法邀请新用户或更改设置。
代理可以查看和创建潜在客户，添加备注和活动，分配潜在客户，查看表单和自动化，以及查看报告。无法删除潜在客户、管理管道或更改任何设置。适合销售人员或潜在客户处理人员。
查看者只读访问权限。可以查看潜在客户、管道阶段、表单和报告，但无法进行任何更改。适合需要可见性但不需要修改任何内容的利益相关者。

步骤 6 — 创建您的第一个自动化​

自动化让 LeadHub 在潜在客户发生某些事情时自动执行操作 — 无需您在场。例如："当从 Facebook 来了一个新潜在客户时，将其分配给小李并向小李发送通知邮件。"

如何创建自动化​

  1. 点击侧边栏中的自动化。

  2. 点击**"新建自动化"**。

  3. 命名（例如 "新潜在客户 — 分配并通知"）。

  4. 选择一个触发器 — 启动自动化的事件。选项包括：

    • 收到新潜在客户 — 每当有新潜在客户到达时触发（来自任何来源）
    • 潜在客户阶段更改 — 当潜在客户移动到不同的管道阶段时触发
    • 潜在客户分配给用户 — 当潜在客户被分配给某人时触发
    • 标签添加到潜在客户 — 当添加特定标签时触发
    • 潜在客户评分跨越阈值 — 当潜在客户的评分超过或低于某个数字时触发
    • 无活动（基于时间） — 当潜在客户在设定天数内没有活动时触发
    • 表单提交 — 当特定表单被提交时触发
    • 手动触发 — 仅当您手动在潜在客户上点击"运行"时触发

  5. 添加步骤 — 自动化执行的操作。您可以按顺序添加任意数量的步骤。可用的步骤类型：

    • 条件 — 仅在潜在客户满足某些条件时才继续（例如 "仅当来源是 Facebook 时"）
    • 延迟 — 在下一步之前等待指定的时间
    • 操作 — 执行某些操作。可用的操作包括：
      • 向潜在客户发送邮件
      • 向用户发送内部通知
      • 将潜在客户分配给特定用户
      • 添加或删除标签
      • 将潜在客户移动到管道阶段
      • 更改潜在客户的状态
      • 向外部 URL 发送 webhook
      • 创建任务或提醒
      • 发送 Slack 通知
      • 向潜在客户发送短信

  6. 切换启用开关以激活自动化。

  7. 点击保存。

自动化现在将在每次触发条件发生时自动运行。Cron 任务（每分钟运行一次）在后台处理自动化队列。

步骤 7 — 自定义品牌（设置 → 品牌）​

LeadHub 可以完全白标 — 您可以用自己的品牌替换名称、标志、颜色和登录页面外观。

如何配置品牌​

  1. 前往侧边栏中的设置 → 品牌。
  2. 填写身份部分：
    • 应用名称 — 将 "LeadHub" 替换为您的品牌名称（例如 "Acme CRM"）。这会出现在顶部栏、登录页面、邮件主题和浏览器标签标题中。
    • 上传标志 — 上传您的标志文件（推荐 PNG 或 SVG，理想大小 300×80 像素）。或粘贴托管在其他地方的标志图片 URL。
    • 上传网站图标 — 出现在浏览器标签中的小图标（32×32 像素，ICO 或 PNG 格式）。
  3. 填写颜色部分：
    • 主色 — 点击颜色选择器并选择您品牌的主色。这会影响整个面板中的按钮、链接和高亮元素。
    • 强调色 — 用于高亮和徽章的辅助颜色。
  4. 填写登录页面部分：
    • 背景颜色 — 登录表单后面的颜色。
    • 上传登录背景图片 — 可选择上传登录屏幕的全页背景图片（推荐大小：1920×1080 像素）。
  5. 填写邮件品牌部分：
    • 邮件发件人名称 — 出现在 LeadHub 发送的邮件的"发件人"字段中的名称（例如 "Acme 支持"）。
    • 发件人邮箱地址 — 发出邮件的邮箱地址。
    • 页脚文字 — 出现在所有发出邮件和公共表单底部的文字（例如 "© 2026 Acme Corp. 保留所有权利。"）。
  6. 点击保存品牌。

更改将立即对您工作区的所有用户生效。

步骤 8 — 启用 AI 功能（可选）​

LeadHub 包含可选的 AI 驱动功能，用于潜在客户丰富、评分和摘要。这些功能需要 OpenAI API 密钥。

AI 功能的作用​

  • 潜在客户丰富 — 根据潜在客户的邮箱地址自动填充缺失的潜在客户详细信息（公司、职位、LinkedIn 个人资料、行业）
  • 潜在客户评分辅助 — AI 辅助的潜在客户质量建议
  • 潜在客户摘要 — 生成潜在客户活动和备注的简明摘要

如何启用 AI 功能​

  1. 首先，您需要一个 OpenAI API 密钥。前往 platform.openai.com，注册或登录，前往 API Keys 并创建一个新密钥。
  2. 在您的 LeadHub 安装中，打开 .env 文件（在 LeadHub 根文件夹中 — 您可能需要在 cPanel 文件管理器中启用"显示隐藏文件"才能看到它）。
  3. 找到 OPENAI_API_KEY= 这一行，在等号后添加您的密钥： 
    OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  4. 保存文件。

AI 功能将立即可用。您将在各个潜在客户记录上看到与 AI 相关的按钮。

关于费用的说明： OpenAI 按使用计费。潜在客户丰富和摘要功能每次使用时都会调用 OpenAI API。费用通常非常小（每个潜在客户只有几分钱），但在高流量情况下会累积。请监控您的 OpenAI 使用情况仪表板。

步骤 9 — 检查仪表板和报告​

随着您的第一批潜在客户流入、管道设置完毕和团队受邀，探索仪表板和报告以了解一切看起来如何。

仪表板​

仪表板（管理面板的首页）显示：

  • 统计卡片 — 潜在客户总数、今日新增、本周新增、本月新增、转化率、管道中活跃数和平均响应时间。每张卡片显示与上一时期比较的趋势指标（上/下箭头）。
  • 潜在客户随时间变化图表 — 按天或周显示潜在客户数量的折线图或柱状图。
  • 按来源分类的潜在客户图表 — 哪些潜在客户来源提供最多潜在客户的分析。
  • 管道分布图表 — 您的管道各阶段中有多少潜在客户。
  • 实时潜在客户动态 — 最近添加的潜在客户的实时动态。

报告​

点击侧边栏中的报告访问详细分析：

  • 潜在客户数量报告 — 带有日期范围筛选的潜在客户随时间变化
  • 来源表现报告 — 哪些来源提供最多潜在客户、最佳转化率和最快响应
  • 管道漏斗报告 — 有多少潜在客户通过各阶段，以及在哪里发生流失
  • 代理表现报告 — 每个团队成员处理多少潜在客户、响应时间和转化率
  • 响应时间报告 — 潜在客户到达后被联系的速度
  • 自动化统计报告 — 每个自动化运行了多少次、成功/失败率
  • 表单分析报告 — 每个网页表单的提交率、浏览量和转化率
  • 审计日志 — 系统中每个操作的完整日志，包括谁在何时执行

步骤 10 — 设置 API 密钥（如果需要）​

如果您想将 LeadHub 连接到外部工具（如自定义网站、CRM 或 Zapier 或 Make 等无代码平台），您可以创建 API 密钥来授权这些连接。

如何创建 API 密钥​

  1. 点击侧边栏中的 API 密钥（或前往设置 → API 密钥，如果它出现在那里）。

  2. 点击**"新建 API 密钥"**。

  3. 为密钥取一个描述性名称（例如 "网站集成" 或 "Zapier 连接"）。

  4. 选择此密钥应具有的范围（权限）。范围控制外部工具被允许执行的操作：

    • read:leads — 查看潜在客户
    • write:leads — 创建和更新潜在客户
    • delete:leads — 删除潜在客户
    • read:pipelines — 查看管道
    • write:pipelines — 创建和更新管道
    • read:tags / write:tags — 管理标签
    • read:users / write:users / delete:users — 管理用户
    • read:forms / write:forms / delete:forms — 管理表单
    • read:automations / write:automations / delete:automations — 管理自动化
    • read:integrations / write:integrations — 管理集成

    仅授予外部工具实际需要的范围。

  5. 可选择为密钥设置过期日期（有利于安全 — 强制续期）。

  6. 可选择设置速率限制（每小时最大 API 调用次数）。

  7. 点击创建密钥。

重要： 完整的 API 密钥（以 lh_ 开头）仅在创建后显示一次。请复制并将其存储在安全的地方（如密码管理器）。如果丢失，您需要创建新密钥 — 无法检索原始密钥。

在 HTTP 请求的 Authorization 头中使用 API 密钥：

Authorization: Bearer lh_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

完整的 API 文档可在本文档的 API 部分找到。

您已准备就绪​

如果您已完成上述步骤，LeadHub 已完全投入运行。以下是您应该已完成的事项摘要：

  • Cron 任务已设置并每分钟运行
  • 邮件已配置并收到测试邮件
  • 第一个管道已创建并包含阶段
  • 第一个潜在客户来源已连接
  • 团队成员已邀请（如适用）
  • 至少创建了一个自动化（可选但推荐）
  • 品牌已用您的标志和颜色自定义
  • AI 功能已启用（可选）
  • 仪表板已审查且状态良好
  • API 密钥已创建（如果连接外部工具）

从这里开始，探索文档的其余部分，了解高级功能，如潜在客户评分规则、计划报告、网页表单嵌入、出站 webhook 等。