Keap

核心用法

Keap skill 提供对 Keap（原 Infusionsoft）CRM 和营销自动化平台的完整 API 访问，通过 Maton 托管的 OAuth 服务代理所有请求。用户需先获取 Maton API 密钥并建立 Keap OAuth 连接，即可通过 REST API 管理联系人、公司、标签、任务、订单、商机、营销活动等核心资源。所有请求需携带 Authorization: Bearer $MATON_API_KEY 头部，多账户场景可通过 Maton-Connection 头部指定连接。

显著优点

• 托管 OAuth 简化认证：无需自建 OAuth 流程，Maton 自动处理令牌注入与刷新
• 完整 CRM 覆盖：支持联系人生命周期管理（创建、标签应用、笔记记录）、商机跟踪、订单处理及营销活动自动化
• 营销自动化深度集成：可直接将联系人添加/移除营销活动序列，触发邮件发送
• 多账户支持：通过连接 ID 区分多个 Keap 账户，适合代理或企业多租户场景
• 分页与过滤完备：支持 token 分页（最大 1000 条/页）及字段级过滤查询

潜在缺点与局限性

• 第三方代理依赖：核心功能依赖 Maton 服务可用性，存在单点故障风险
• 地域与合规限制：Maton 为外部服务商，数据流经第三方服务器，需评估 GDPR/CCPA 合规性
• 写操作需人工确认：文档明确所有创建/更新/删除操作需要用户显式批准，可能降低自动化效率
• 环境变量限制：部分 shell 环境（如管道到 jq）可能存在变量扩展问题
• 无实时 Webhook：仅支持轮询 API，无原生事件推送机制

适合人群

• 已使用 Keap/Infusionsoft 的中小企业销售与营销团队
• 需要将 CRM 数据与内部系统集成的开发者
• 营销代理机构管理多个客户 Keap 账户
• 寻求低代码替代方案替代 Zapier/Make 自动化的高级用户

常规风险

• 数据泄露风险：API 密钥泄露可导致完整 CRM 数据访问，需严格保管 MATON_API_KEY
• 误操作风险：批量标签应用、联系人删除等操作影响面广，建议操作前备份
• 供应商锁定：深度依赖 Maton 代理层，迁移至直接 Keap API 需重新适配 OAuth 流程
• 费率限制：429 错误提示存在频率限制，大规模数据同步需实现退避重试逻辑

核心用法

Keap Skill 是一个面向 CRM 和营销自动化的 API 集成工具，通过 Maton 代理服务访问 Keap（原 Infusionsoft）官方 API。用户需要先获取 Maton API Key，完成 OAuth 授权后即可对 Keap 账户进行全面管理。

关键操作流程：
1. 环境配置：设置 MATON_API_KEY 环境变量
2. 连接管理：创建 Keap OAuth 连接，通过浏览器完成授权
3. API 调用：使用 RESTful 接口操作各类资源

支持的资源类型：

• 联系人管理：创建、更新、删除联系人，管理邮箱和电话
• 公司管理：企业客户信息管理
• 标签系统：标签分类、批量打标签/移除标签
• 任务跟踪：待办事项创建和状态更新
• 商机管理：销售漏斗和阶段跟踪
• 订单与产品：订单创建、产品管理
• 营销活动：活动序列管理和联系人加入/移除
• 邮件发送：支持 HTML 内容的邮件发送

技术特性：

• 采用 Keap REST API v2（v1 已废弃）
• 支持 Token 分页（最大 page_size 1000）
• 支持 RSQL 风格过滤表达式
• 多连接场景下可通过 Maton-Connection 头指定目标账户

显著优点

1. 托管式 OAuth：无需自行处理复杂的 OAuth 流程，Maton 代理自动注入 Token
2. 完整的 CRM 覆盖：涵盖从线索到成交的全链路数据管理
3. 营销自动化原生：深度集成 Keap 的邮件营销和活动序列功能
4. 批量操作支持：标签应用、活动序列等场景支持批量联系人处理
5. 安全设计明确：所有写入操作需用户显式确认，降低误操作风险

潜在缺点与局限性

1. 依赖第三方代理：通过 Maton 中转而非直连 Keap，存在单点依赖
2. 功能边界：仅支持文档列出的资源类型，部分 Keap 高级功能可能未覆盖
3. 连接管理复杂度：多账户场景需要手动管理 connection_id
4. 纯文档型 Skill：无内置错误重试、限流处理等高级客户端特性
5. 环境变量限制：MATON_API_KEY 在部分 shell 管道场景下可能无法正确展开

适合人群

• 中小企业主：需要自动化管理客户数据和营销流程
• 销售运营团队：需要批量管理商机、任务和联系人标签
• 营销自动化从业者：需要程序化操作邮件活动和客户分群
• 系统集成开发者：需要将 Keap CRM 与其他业务系统对接

常规风险

• 数据误操作：批量标签应用、联系人删除等操作不可逆，需严格遵循"显式确认"原则
• API 限流：Keap 对 API 调用频率有限制，高频场景需自行实现退避逻辑
• OAuth 令牌失效：长期运行的自动化任务可能因令牌过期中断
• 数据隐私：通过 Maton 代理传输客户数据，需评估第三方数据处理的合规性
• 多连接混淆：未指定 Maton-Connection 时，请求可能被路由到非预期账户