Skip to main content
  • 集成
  • 数据与效率集成

数据与效率集成

实现将线索数据写入电子表格、数据库或者自定义API接口;配置入口:设置 → 集成。

#Google Sheets(谷歌表格,线索追加行)

  1. Google Cloud新建项目,启用 Google Sheets API、Google Drive API。
  2. API和服务‑凭证,创建OAuth客户端ID(网页应用),填入OAuth重定向URI:https://yourdomain.com/oauth/google‑sheets/callback,复制Client ID、Client Secret。
  3. 准备目标Google表格,第一行设置表头,从URL提取电子表格ID。
  4. LeadHub填入Client ID、Client Secret、电子表格ID、工作表名称,执行Google OAuth授权连接。

#Notion(写入数据库条目)

  1. Notion我的集成页面新建集成,复制以secret_开头的内部集成令牌。
  2. 获取数据库32位字符串ID;将该集成共享授权给目标Notion数据库。
  3. LeadHub填写API令牌、数据库ID,保存并测试。

#Airtable(写入数据表记录)

  1. Airtable账号页面生成个人访问令牌,授予data.records:write、schema.bases:read权限;获取数据库ID、目标表格名称。
  2. LeadHub填入API Key、数据库ID、表格名称,保存并测试。

#通用 Webhook

向任意外部地址POST JSON数据;目标端点需要支持Content‑Type: application/json并且返回2xx状态码。

  1. LeadHub进入设置 → 集成 → 通用Webhook。
  2. 填写Webhook URL,可配置密钥。

设置密钥后请求携带请求头:X‑LeadHub‑Signature: sha256=HMAC_SHA256(secret, payload_body),用于校验请求合法性。

#REST API 推送

可自定义HTTP请求方法、请求头,调用任意REST接口。

  1. 设置 → 集成 → REST API推送。
  2. 填写端点URL,选择HTTP方法(POST/PUT/PATCH),填写JSON格式自定义请求头。
  3. 保存测试;调用失败最多自动重试3次,采用指数退避策略。

#故障排查

现象 处理方案
Google Sheets OAuth报错 重定向URI必须完整匹配,包含https://
Notion返回对象未找到 确认集成已经共享授权给目标数据库
Airtable字段不匹配 字段名称大小写敏感,核对Airtable内字段名
Webhook返回4xx 确认接口接受Content‑Type: application/json
REST API推送没有执行 检查Cron队列定时任务,参考共享主机指南
签名校验不通过 HMAC‑SHA256必须基于原始请求正文进行计算