跳到主要内容

CRM 集成

LeadHub 可以在线索到达的瞬间将每条新线索推送到 13 个支持的 CRM 平台中的任意一个。在设置 → 集成中配置一个或多个 CRM 集成。

CRM 集成的工作原理​

  1. 新线索进入 LeadHub（来自任意来源）。
  2. LeadHub 在后台（通过队列工作进程）调用目标 CRM 的 API。
  3. 在 CRM 中创建新的联系人、线索或交易记录。
  4. 如果 API 调用失败，LeadHub 自动重试（最多 3 次）。

HubSpot​

HubSpot 使用 OAuth 2.0。您需要创建一个 HubSpot 应用来获取凭证。

第一步 — 创建 HubSpot 私有应用​

  1. 登录 app.hubspot.com。
  2. 点击账户名 → 集成 → 私有应用。
  3. 点击创建私有应用。
  4. 命名（例如 LeadHub），在权限下启用：
    • crm.objects.contacts.write
    • crm.objects.deals.write
    • crm.pipelines.orders.read
  5. 点击创建应用 → 复制显示的访问令牌。

第二步 — 在 LeadHub 中配置​

  1. 进入设置 → 集成 → HubSpot。
  2. 填写：
    字段值
    访问令牌粘贴第一步的令牌
    创建交易开启后同时在 HubSpot 中创建交易
    交易管道管道 ID（来自 HubSpot 管道设置）
    交易阶段放置交易的阶段 ID
  3. 点击保存并测试。

提示： 留空交易管道和交易阶段将使用 HubSpot 的默认管道。

Salesforce​

Salesforce 通过已连接应用使用 OAuth 2.0。

第一步 — 创建已连接应用​

  1. 在 Salesforce 中，进入设置 → 应用管理器 → 新建已连接应用。
  2. 启用 OAuth 设置。
  3. 将回调 URL 设置为 https://yourdomain.com/oauth/salesforce/callback。
  4. 选择 OAuth 权限范围：api、refresh_token。
  5. 保存并记下消费者密钥（Client ID）和消费者密钥（Client Secret）。

第二步 — 在 LeadHub 中配置​

  1. 进入设置 → 集成 → Salesforce。
  2. 填写：
    字段值
    Client ID第一步中的消费者密钥
    Client Secret第一步中的消费者密钥
    实例 URL您的 Salesforce URL，例如 https://yourorg.salesforce.com
    对象类型Lead 或 Contact
  3. 点击使用 Salesforce 连接完成 OAuth 流程。

Pipedrive​

Pipedrive 使用简单的 API 密钥。

第一步 — 获取您的 API 密钥​

  1. 登录 Pipedrive → 点击头像 → 个人偏好 → API。
  2. 复制您的 API 令牌。

第二步 — 在 LeadHub 中配置​

  1. 进入设置 → 集成 → Pipedrive。
  2. 粘贴您的 API 密钥并点击保存并测试。

LeadHub 为每条线索创建新的联系人记录。

Zoho CRM​

Zoho 使用 OAuth 2.0。

第一步 — 创建 Zoho OAuth 客户端​

  1. 访问 api-console.zoho.com。
  2. 点击添加客户端 → 选择基于服务器的应用。
  3. 将重定向 URI 设置为 https://yourdomain.com/oauth/zoho/callback。
  4. 记下 Client ID 和 Client Secret。

第二步 — 在 LeadHub 中配置​

  1. 进入设置 → 集成 → Zoho CRM。
  2. 填写：
    字段值
    Client ID来自第一步
    Client Secret来自第一步
    区域您的数据中心：com、eu、in、com.au、jp
  3. 点击使用 Zoho 连接完成 OAuth 流程。

Freshsales​

第一步 — 获取您的 API 密钥​

  1. 在 Freshsales 中，进入设置 → API 设置。
  2. 复制 API Key。
  3. 记下您的子域名（.freshsales.io 前面的部分）。

第二步 — 在 LeadHub 中配置​

  1. 进入设置 → 集成 → Freshsales。
  2. 填写：
    字段值
    API Key来自第一步
    域名仅子域名部分，例如 mycompany
    创建交易开启后同时创建交易记录
  3. 点击保存并测试。

Monday.com​

第一步 — 获取 API 密钥和看板 ID​

  1. 在 Monday.com 中，点击头像 → 管理 → API。
  2. 复制个人 API 令牌。
  3. 打开您希望添加线索的看板 → 从 URL 中复制看板 ID （https://yourteam.monday.com/boards/123456789 → ID 为 123456789）。

第二步 — 在 LeadHub 中配置​

  1. 进入设置 → 集成 → Monday.com。
  2. 填写：
    字段值
    API Key个人 API 令牌
    看板 ID第一步中的数字看板 ID
  3. 点击保存并测试。

Copper CRM​

第一步 — 获取 API 凭证​

  1. 在 Copper 中，进入设置 → 集成 → API 密钥。
  2. 复制 API Key。
  3. 记下与您 Copper 账户关联的邮箱地址。

第二步 — 在 LeadHub 中配置​

  1. 进入设置 → 集成 → Copper CRM。
  2. 填写：
    字段值
    API Key来自第一步
    用户邮箱与 API 密钥绑定的邮箱地址
  3. 点击保存并测试。

Close CRM​

第一步 — 获取您的 API 密钥​

  1. 在 Close 中，进入设置 → API 密钥 → 生成 API 密钥。
  2. 复制密钥。

第二步 — 在 LeadHub 中配置​

  1. 进入设置 → 集成 → Close CRM。
  2. 粘贴您的 API 密钥并点击保存并测试。

LeadHub 在 Close 中创建新的线索，并将联系人作为活动。

Streak（Gmail CRM）​

第一步 — 获取您的 API 密钥​

  1. 在 Gmail 中，打开 Streak → 设置 → API。
  2. 复制 API Key。
  3. 打开您希望添加线索的管道 → 从 URL 中复制管道密钥。

第二步 — 在 LeadHub 中配置​

  1. 进入设置 → 集成 → Streak。
  2. 填写：
    字段值
    API Key来自第一步
    管道密钥来自 URL 的管道密钥
  3. 点击保存并测试。

Insightly​

第一步 — 获取您的 API 密钥​

  1. 在 Insightly 中，进入用户设置（点击头像）→ 滚动到 API 密钥。
  2. 复制密钥。

第二步 — 在 LeadHub 中配置​

  1. 进入设置 → 集成 → Insightly。
  2. 粘贴您的 API 密钥并点击保存并测试。

Bitrix24​

Bitrix24 使用入站 Webhook URL。

第一步 — 创建入站 Webhook​

  1. 在 Bitrix24 中，进入应用 → Webhook → 添加入站 Webhook。
  2. 启用 CRM 权限。
  3. 复制完整的 Webhook URL（格式如 https://yourcompany.bitrix24.com/rest/1/abc123xyz/）。

第二步 — 在 LeadHub 中配置​

  1. 进入设置 → 集成 → Bitrix24。
  2. 粘贴您的 Webhook URL 并点击保存并测试。

SugarCRM​

第一步 — 获取访问令牌​

使用 SugarCRM REST v11 API 获取 OAuth 访问令牌，或使用管理员从管理 → 密码管理 → OAuth 密钥生成的令牌。

第二步 — 在 LeadHub 中配置​

  1. 进入设置 → 集成 → SugarCRM。
  2. 填写：
    字段值
    访问令牌OAuth 访问令牌
    实例 URL您的 SugarCRM URL，例如 https://yourcrm.sugarcrm.com
  3. 点击保存并测试。

Vtiger​

第一步 — 获取访问密钥​

  1. 在 Vtiger 中，进入我的偏好（点击右上角的姓名）。
  2. 滚动到访问密钥并复制。
  3. 记下您的 Vtiger URL（例如 https://yourcompany.vtiger.com）。

第二步 — 在 LeadHub 中配置​

  1. 进入设置 → 集成 → Vtiger。
  2. 填写：
    字段值
    访问令牌第一步中的访问密钥
    实例 URL您的 Vtiger URL
  3. 点击保存并测试。

故障排查​

问题解决方案
"认证失败"重新检查 API 密钥或重新执行 OAuth 流程
"记录未创建"检查 API 密钥是否具有联系人/线索的写入权限
线索未同步确认队列工作进程正在运行（Cron 任务已正确设置）
OAuth 回调错误确保 CRM 应用中的重定向 URI 完全匹配

如果 Cron 任务未运行，请参阅服务器要求和共享主机指南。