跳到主要内容

数据与效率集成

将每条线索记录到电子表格、数据库或您自己的 API 端点。在设置 → 集成中进行配置。

Google Sheets​

每当有线索进入 LeadHub，就在 Google 表格中追加一行新记录。

第一步 — 创建 Google Cloud 项目​

  1. 进入 console.cloud.google.com。
  2. 点击新建项目，命名为 LeadHub 并创建。
  3. 搜索 Google Sheets API 并启用。同时启用 Google Drive API。

第二步 — 创建 OAuth 凭证​

  1. 进入 API 和服务 → 凭证。
  2. 点击创建凭证 → OAuth 客户端 ID，应用类型选网页应用。
  3. 在授权重定向 URI 下添加：https://yourdomain.com/oauth/google-sheets/callback
  4. 复制 Client ID 和 Client Secret。

第三步 — 准备 Google 表格​

创建 Google 表格，在第 1 行添加列标题，并从 URL 复制电子表格 ID： https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit

第四步 — 在 LeadHub 中配置​

  1. 进入设置 → 集成 → Google Sheets，填写 Client ID、Client Secret、电子表格 ID 和工作表名称。
  2. 点击使用 Google 连接完成 OAuth 流程。

Notion​

第一步 — 创建 Notion 集成​

  1. 进入 notion.so/my-integrations → + 新建集成。
  2. 复制内部集成令牌（以 secret_ 开头）。

第二步 — 共享数据库并获取数据库 ID​

在数据库 URL 中找到数据库 ID（? 前的 32 位字符串），并通过共享将集成邀请到数据库。

第三步 — 在 LeadHub 中配置​

进入设置 → 集成 → Notion，填写 API 令牌和数据库 ID，点击保存并测试。

Airtable​

第一步 — 获取凭证​

在 airtable.com/account 生成个人访问令牌（启用 data.records:write、schema.bases:read），从 URL 获取数据库 ID，记下表格名称。

第二步 — 在 LeadHub 中配置​

进入设置 → 集成 → Airtable，填写 API Key、数据库 ID 和表格名称，点击保存并测试。

通用 Webhook​

向任意 URL 发送线索数据。您的端点必须接受 HTTP POST 和 Content-Type: application/json，并返回 2xx 状态码。

进入设置 → 集成 → 通用 Webhook，填写 Webhook URL 和可选密钥，点击保存并测试。

如果设置了密钥，每个请求将包含 X-LeadHub-Signature: sha256=HMAC_SHA256(secret, payload_body) 请求头。

REST API 推送​

将线索数据推送到可配置 HTTP 方法和请求头的 RESTful API 端点。

进入设置 → 集成 → REST API 推送，填写端点 URL、HTTP 方法（POST/PUT/PATCH）和请求头 JSON 对象，点击保存并测试。

失败时最多自动重试 3 次，采用指数退避策略。

故障排查​

问题解决方案
Google Sheets OAuth 错误确保重定向 URI 完全匹配，包括 https://
Notion "对象未找到"集成未与数据库共享 — 重新检查共享步骤
Airtable 字段不匹配字段名称区分大小写 — 在 Airtable 中验证确切名称
Webhook 返回 4xx检查端点是否接受 Content-Type: application/json
REST API 推送未触发检查队列 Cron 任务 — 参见共享主机指南
签名不匹配确保在原始请求正文上计算 HMAC-SHA256