ActiveCampaign

核心功能

ActiveCampaign 技能是 Maton 平台提供的官方 API 集成服务，通过托管 OAuth 认证机制，让用户能够安全地访问 ActiveCampaign 的营销自动化与客户关系管理功能。该技能完整覆盖了 ActiveCampaign API v3 的核心能力，包括联系人管理、交易管道、邮件营销、自动化工作流、标签分类、用户权限及自定义字段等模块。

显著优点

1. 托管 OAuth 安全架构：无需用户自行处理复杂的 OAuth 流程，Maton 平台自动管理令牌刷新与存储，降低凭证泄露风险
2. 完整功能覆盖：支持 contacts、deals、lists、campaigns、automations、tags、webhooks 等 10+ 核心资源类型的 CRUD 操作
3. 多连接管理：支持同一用户绑定多个 ActiveCampaign 账户，通过 Maton-Connection 头部灵活切换
4. 开发者友好：提供 Python、JavaScript 等完整代码示例，请求格式遵循 RESTful 规范，响应包含标准 meta 分页信息
5. 细粒度权限控制：写操作强制要求用户确认，webhook 创建需验证目标 URL，用户/账户管理操作明确标识风险

潜在局限

• 速率限制：每秒 5 请求/账户的硬限制，大规模数据同步需实现指数退避重试
• 依赖 Maton 平台：所有请求必须经由 api.maton.ai 代理，无法直连 ActiveCampaign 原生端点，存在单点依赖
• 功能滞后风险：ActiveCampaign API 更新需等待 Maton 适配，可能无法及时使用最新功能
• 环境变量依赖：运行时强制要求 MATON_API_KEY，本地调试需额外配置

适合人群

• 营销自动化工程师：需要程序化管理邮件列表、自动化流程与用户分群
• CRM 集成开发者：将 ActiveCampaign 数据与内部系统双向同步
• 销售运营团队：批量更新交易阶段、联系人标签及自定义字段
• SaaS 产品经理：快速验证与 ActiveCampaign 的集成方案

常规风险

• 数据误操作风险：DELETE 操作不可逆，批量更新可能导致联系人数据丢失
• Webhook 数据泄露：配置错误的目标 URL 可能导致敏感客户数据外泄
• OAuth 令牌过期：长期运行的自动化任务可能因令牌失效中断
• API 代理故障：Maton 服务异常将导致完全无法访问 ActiveCampaign 数据

---

安全等级：S（企业级托管 OAuth，强制写确认，明确风险标识）
来源可信度：T1（Maton 官方提供，ActiveCampaign 官方 API 代理）

核心用法

本 Skill 是 ActiveCampaign 营销自动化平台的 API 集成指南，通过 Maton 托管服务实现 OAuth 认证代理。用户可使用标准 REST API 操作联系人（Contacts）、商机（Deals）、标签（Tags）、邮件列表（Lists）、自动化工作流（Automations）、邮件 campaign、用户账户及 Webhook 等全量资源。

关键特性：

• 托管 OAuth：Maton 自动处理令牌刷新，用户仅需管理 MATON_API_KEY
• 多账户支持：通过 Maton-Connection 头部指定不同 ActiveCampaign 账户
• 完整 CRUD：覆盖营销自动化核心实体，支持自定义字段和备注

典型工作流：
1. 配置 MATON_API_KEY 环境变量
2. 创建 OAuth 连接（POST /connections）并浏览器授权
3. 调用 /active-campaign/api/3/* 端点操作数据

显著优点

• 零代码集成：纯文档型 Skill，无可执行代码，降低供应链攻击面
• 官方 API 完整覆盖：支持 ActiveCampaign v3 API 全部核心功能
• 安全设计：所有写操作强制要求用户显式确认，Webhook 创建需二次验证目标 URL
• 弹性分页：支持 offset 和 cursor 两种分页模式，适配大数据集
• 多语言示例：提供 Python、JavaScript、Bash curl 完整代码

潜在局限

• 外部依赖强：功能完全依赖 Maton 服务可用性，若 Maton 平台故障则不可用
• 速率限制：ActiveCampaign 原生限制 5 req/sec，高频场景需自行限流
• 无本地缓存：每次请求实时代理，无法离线操作
• 权限粒度粗：通过 OAuth 一次性授权，无法细粒度控制单资源权限

适合人群

• 需自动化营销流程的中小企业市场团队
• 希望将 ActiveCampaign 数据同步到内部系统的开发者
• 使用多账户管理客户代运营的代理商

常规风险

| 风险类型 | 说明 | 缓解措施 |

|---------|------|---------|

| 密钥泄露 | `MATON_API_KEY` 泄露可导致账户被接管 | 使用密钥管理服务，避免硬编码 |

| 误操作数据 | 批量更新/删除影响生产数据 | 利用强制确认机制，测试环境先行 |

| Webhook 数据外泄 | 配置错误 URL 导致事件数据泄露 | 严格校验 URL 所有权，使用 HTTPS |

| 权限提升 | 用户/账户管理操作影响团队访问 | 仅限管理员执行，操作前二次确认 |