名称： activecampaign
描述： ActiveCampaign CRM 集成，用于线索管理、交易跟踪和邮件自动化。适用于同步演示线索、管理诊所销售管道以及触发跟进序列。
元数据： {"clawdbot":{"emoji":"📧","requires":{"bins":["activecampaign"],"env":["ACTIVECAMPAIGN_URL","ACTIVECAMPAIGN_API_KEY"]},"primaryEnv":["ACTIVECAMPAIGN_URL","ACTIVECAMPAIGN_API_KEY"]}}

ActiveCampaign 技能 📧

用于 CRM 自动化和销售管道管理的 ActiveCampaign 集成。

目的

管理销售相关的线索、交易和邮件自动化：
- 联系人：同步演示参与者、线索和潜在客户
- 交易：跟踪销售管道阶段
- 标签：细分线索（例如：请求演示、培育中、准备成交）
- 自动化：根据操作触发邮件序列
- 自定义字段：映射订单、配送、账单和订阅数据

设置

1. 凭证配置

# 创建配置目录
mkdir -p ~/.config/activecampaign

# 添加凭证
echo "https://youraccount.api-us1.com" > ~/.config/activecampaign/url
echo "your-api-key" > ~/.config/activecampaign/api_key

# 或使用环境变量
export ACTIVECAMPAIGN_URL="https://youraccount.api-us1.com"
export ACTIVECAMPAIGN_API_KEY="your-api-key"

从 ActiveCampaign 获取 API 凭证：
- URL：设置 → 开发者 → API 访问
- API 密钥：设置 → 开发者 → API 访问

2. 自定义字段配置（可选）

此技能支持为订单、配送、账单和订阅数据映射自定义字段。

# 从示例初始化配置
activecampaign config init

# 使用你的字段 ID 进行编辑
nano ~/.config/activecampaign/fields.json

配置文件已被 gitignore 忽略，不应提交到版本库。

使用方法

# 联系人
activecampaign contacts list                    # 列出所有联系人
activecampaign contacts create "email@test.com" "First" "Last"
activecampaign contacts sync "email@test.com" "First" "Last"
activecampaign contacts get <id>
activecampaign contacts search "clinic"
activecampaign contacts add-tag <id> <tag_id>
activecampaign contacts remove-tag <id> <tag_id>

# 交易
activecampaign deals list
activecampaign deals create "Clinic Name" <stage_id> <value>
activecampaign deals update <id> stage=<stage_id> value=<value>
activecampaign deals get <id>

# 标签
activecampaign tags list
activecampaign tags create "Demo Requested"

# 自动化
activecampaign automations list
activecampaign automations add-contact <contact_id> <automation_id>

# 自定义字段
activecampaign fields list                    # 列出已配置的字段
activecampaign fields get order_fields.order_id
activecampaign fields set-field <contact_id> <field_id> <value>

# 列表
activecampaign lists list
activecampaign lists add-contact <list_id> <contact_id>

# 配置
activecampaign config init                    # 从示例创建 fields.json
activecampaign config path                    # 显示配置文件路径

自定义字段配置

此技能包含一个全面的字段配置系统，涵盖以下类别：

设置字段值

# 从配置中获取字段 ID
activecampaign fields get order_fields.order_id
# 输出：7

# 为联系人设置字段值
activecampaign fields set-field <contact_id> 7 "ORD-12345"

速率限制

• 最大 每秒 5 个请求
• 封装器会自动处理速率限制

相关技能

• shapescale-crm - Attio CRM 集成（单一数据源）
• shapescale-sales - 销售工作流和资格认定
• campaign-orchestrator - 多渠道跟进活动编排