核心用法
Keap Skill 提供对 Keap（原 Infusionsoft）CRM 平台的完整 API 接入能力，通过 Maton 网关代理实现托管式 OAuth 认证。开发者无需自行处理 Token 刷新和密钥存储，仅需配置 MATON_API_KEY 即可调用 Keap v2 REST API。
主要功能模块：
- 联系人管理：创建、更新、删除联系人，支持多邮箱/电话字段，可附加笔记
- 公司与标签体系：维护企业客户信息，通过标签实现精细化分组与批量操作
- 商机与订单：跟踪销售漏斗阶段，创建订单并管理产品订阅
- 营销自动化：管理邮件营销活动、自动化工作流，支持序列化邮件触达
- 任务协作：分配跟进任务，设置截止日期与完成状态
技术接入方式：
1. 在 maton.ai 获取 API Key 并设置环境变量
2. 通过 ctrl.maton.ai 创建 Keap OAuth 连接并完成授权
3. 向 gateway.maton.ai/keap/crm/rest/v2/{endpoint} 发起请求
4. 支持分页（page_token）、过滤（filter参数）和字段筛选
显著优点
1. 托管认证减负：OAuth 流程完全托管，Token 自动续期，降低安全合规成本
2. 功能覆盖全面：涵盖 CRM 核心实体（联系人、公司、商机、订单）及营销自动化能力
3. 多语言示例：提供 Python、JavaScript、Bash 等即插即用代码片段
4. 连接管理灵活：支持多 Keap 账户切换，通过 Maton-Connection 头指定特定连接
5. 分页过滤完善：支持 RCN 风格过滤表达式，大数据量场景可流式处理
潜在局限与风险
| 方面 | 说明 |
|------|------|
| **厂商锁定** | 依赖 Maton 网关服务，若服务中断则 API 调用失效；迁移需重构认证层 |
| **调试复杂度** | 400/401 错误需区分是 Maton 密钥问题还是 Keap OAuth 授权问题，排查链路较长 |
| **速率限制** | 429 状态码表明触发 Keap 或 Maton 侧限流，高并发场景需设计退避策略 |
| **数据隐私** | 联系人、订单等敏感数据流经第三方网关，需评估 Maton 的数据处理协议 |
| **OAuth 权限** | 需确保 Keap 应用授权包含足够 scope，403 错误常因权限不足导致 |
适合人群
- 使用 Keap/Infusionsoft 作为核心 CRM 的中小企业运营团队
- 需要打通 Keap 与内部系统的集成开发者
- 构建营销自动化、客户生命周期管理工具的 SaaS 厂商
常规风险建议
- 密钥隔离：生产环境
MATON_API_KEY应配置在密钥管理系统，避免硬编码 - 连接监控：定期检查
ctrl.maton.ai/connections状态，OAuth 授权过期前及时刷新 - 沙箱先行：建议在 Keap 沙箱环境完成全链路测试后再切换生产数据
- 日志脱敏：记录 API 响应时过滤 email、phone 等 PII 字段，符合 GDPR/CCPA 要求