数据与效率集成
实现将线索数据写入电子表格、数据库或者自定义API接口;配置入口:设置 → 集成。
#Google Sheets(谷歌表格,线索追加行)
- Google Cloud新建项目,启用 Google Sheets API、Google Drive API。
- API和服务‑凭证,创建OAuth客户端ID(网页应用),填入OAuth重定向URI:
https://yourdomain.com/oauth/google‑sheets/callback,复制Client ID、Client Secret。 - 准备目标Google表格,第一行设置表头,从URL提取电子表格ID。
- LeadHub填入Client ID、Client Secret、电子表格ID、工作表名称,执行Google OAuth授权连接。
#Notion(写入数据库条目)
- Notion我的集成页面新建集成,复制以
secret_开头的内部集成令牌。 - 获取数据库32位字符串ID;将该集成共享授权给目标Notion数据库。
- LeadHub填写API令牌、数据库ID,保存并测试。
#Airtable(写入数据表记录)
- Airtable账号页面生成个人访问令牌,授予
data.records:write、schema.bases:read权限;获取数据库ID、目标表格名称。 - LeadHub填入API Key、数据库ID、表格名称,保存并测试。
#通用 Webhook
向任意外部地址POST JSON数据;目标端点需要支持Content‑Type: application/json并且返回2xx状态码。
- LeadHub进入设置 → 集成 → 通用Webhook。
- 填写Webhook URL,可配置密钥。
设置密钥后请求携带请求头:
X‑LeadHub‑Signature: sha256=HMAC_SHA256(secret, payload_body),用于校验请求合法性。
#REST API 推送
可自定义HTTP请求方法、请求头,调用任意REST接口。
- 设置 → 集成 → 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必须基于原始请求正文进行计算 |