Keap（Infusionsoft）CRM集成金蝶云星空解决方案
更新: 10/9/2026 字数: 0 字 时长: 0 分钟
业务背景
| 源系统 | 成集云 | 目标系统 |
|---|---|---|
| Keap（Infusionsoft）CRM系统 |  | 金蝶云星空ERP |
Keap（原 Infusionsoft）是面向中小企业的销售与营销自动化 CRM，集联系人管理、邮件营销、电商、商机管线、预约与开票于一体，在海外中小商贸、教育培训、专业服务行业拥有大量用户。
使用 Keap 的企业普遍面临一个典型问题：营销获客在 Keap，财务与供应链履约在金蝶云星空，两套系统彼此割裂。销售在 Keap 中推进商机、成交订单、记录收款，但财务却要在金蝶里手工重复建档、录单、核销，导致：
- 客户、联系人、产品信息在两边各维护一份，极易不一致；
- Keap 成交订单无法自动生成金蝶销售订单与应收，月底对账靠人工导出导入；
- 收款状态不同步，财务无法实时掌握「已收款 / 待收款」；
- 营销标签（如「VIP」「续费意向」）无法沉淀为金蝶客户分类，会员运营与财务脱节。
通过成集云数据集成平台，可将 Keap 的营销与成交数据自动、可靠地同步到金蝶云星空，实现「前端获客—中台成交—后端财务」的数据闭环。
解决方案
基于成集云 iPaaS 数据集成平台，通过 Keap REST API（OAuth 2.0 授权码 + 刷新令牌，Bearer Token 鉴权）对接 Keap 开放接口，结合 Keap REST Hooks 实时事件推送，构建可视化自动同步任务，将联系人、公司、产品、商机、订单、标签等数据按规则映射并写入金蝶云星空，同时对回写结果做幂等去重与异常告警，保障数据一致性。
对接要点：
- 鉴权方式：Keap OAuth 2.0（Authorization Code + Refresh Token），访问令牌以
Authorization: Bearer <token>传递，令牌过期自动刷新；单租户脚本亦支持 Personal Access Token。 - 数据入口：REST v2（
https://api.infusionsoft.com/crm/rest/v2，联系人/公司/商机/标签/任务等）为主，REST v1（/crm/rest/v1，订单/产品/订阅等）补充，REST Hook 订阅contact.add、contactGroup.applied等事件实现近实时同步。 - 映射与去重：以 Keap 记录
id作为统一外部主键，写入金蝶时落「来源系统标识 + 外部 ID」，保证重复推送只更新不新增。
业务流程
一、基础资料同步流程
1. 客户与联系人同步流程
2. 产品与物料同步流程
3. 商机与订单同步流程
4. 营销标签与客户分类同步流程
二、订阅与 recurring 收入同步流程
对接说明
一、基础资料同步（源 → 目标）
| Keap 对象 | 金蝶云星空对象 | 关键字段映射 |
|---|---|---|
| Contact（联系人） | 客户 / 联系人 | email → 邮箱；given_name+family_name → 名称；phone → 手机号；自定义字段 → 客户扩展属性 |
| Company（公司） | 客户（单位客户） | company → 客户名称；company.phone → 联系电话 |
| Product（产品） | 物料 | sku → 物料编码；product_name → 名称；product_price → 标准售价 |
| Tag（标签） | 客户分类 / 会员等级 | tag name → 分类名称；contactGroup.applied → 打标关联 |
二、业务单据同步（源 → 目标）
| Keap 对象 | 金蝶云星空对象 | 触发条件 |
|---|---|---|
| Opportunity（商机） | 销售线索 / 商机 | stage 推进；stage=赢单 → 生成销售订单 |
| Order（订单，v1） | 销售订单 / 应收单 | 订单状态为已支付或已开票 |
| Order 收款 | 收款单 | 订单完成支付 → 收款单 + 自动核销应收 |
| Subscription（订阅） | 销售合同 / 应收计划 | 订阅创建 → 合同；按周期生成应收计划 |
三、同步规则与过滤条件
- 增量与事件双通道：REST Hook 事件（contact.add、contactGroup.applied）触发准实时同步；定时任务按
last_updated全量增量兜底，避免事件丢失。 - 过滤条件：仅同步
email非空的联系人；订单仅同步状态为 paid / fulfilled 的单据；可按 Keap Campaign 或 Tag 限定需要进入财务的客户范围。 - 幂等去重：以 Keap
id为外部主键，重复事件仅更新不新增；金额字段统一以 Keap 原币种落金蝶，多币种订单通过金蝶币别与汇兑损益处理。 - 异常处理：接口限流（Keap 有速率限制）自动退避重试；同步失败进入成集云异常队列并告警，支持人工重放。
业务价值
- 消除重复录单：客户、产品、订单从 Keap 自动进入金蝶，财务无需手工建档与录单，录入工作量下降约 70%。
- 业财一体：Keap 成交即生成金蝶销售订单与应收，收款自动核销，月底对账从「导出导入」变为「实时可查」。
- 客户资产沉淀：营销标签自动转化为金蝶客户分类与会员等级，让会员运营与财务口径统一。
- 订阅收入可视： recurring 订阅自动生成合同与应收计划，周期性收入可预测、可跟踪。
- 合规与可追溯：每次同步保留来源系统标识与外部 ID，审计链路清晰，便于差错追溯。
接口文档
- Keap（Infusionsoft）REST API v2 文档：
https://developer.infusionsoft.com/docs/restv2/ - Keap REST API v1 文档：
https://developer.infusionsoft.com/docs/rest/ - Keap OAuth 2.0 接入指南：
https://developer.infusionsoft.com/getting-started-oauth-keys/ - 金蝶云星空 OpenAPI 文档（开放平台）