用途:按既定流程创建 Woodpecker 营销活动并正确录入潜在客户,保证客户在 Woodpecker 仪表盘中与该 V2 活动可见地关联,并使用账户签名。
主要能力与关键点:
- 活动创建使用 V2 API:POST https://api.woodpecker.co/rest/v2/campaigns,请求头 X-API-KEY: YOUR_KEY。请求体包含 name、email_account_ids、settings(如 timezone、daily_enroll)以及 steps;步骤 body 中设置 "signature": "SENDER" 可自动使用该账户配置的签名。
- 客户录入必须使用 V1 API:POST https://api.woodpecker.co/rest/v1/add_prospects_campaign,请求头同为 X-API-KEY。为使客户出现在 V2 活动的仪表盘中,需将 campaign_id 嵌套在 campaign 对象内,即 {"campaign": {"campaign_id": ...}}。
- 客户状态需设为 ACTIVE,并在录入负载中使用 force: true,以覆盖此前的全局状态。
必要准备:从 Woodpecker(Settings > Marketplace > API keys)获取 API Key;找到 Email Account ID,用于活动创建。技能提供脚本以自动化这两步流程。
排错要点:若返回 200 但活动为空,检查负载嵌套,确认 campaign_id 位于 campaign 对象内;若签名未显示,确认步骤版本 body 中包含 "signature": "SENDER",且该邮箱账户已在 Woodpecker 中设置签名;若客户被加入列表但未进入活动,通常是 V1 调用缺少 campaign 对象。
限制:资料未提供脚本文件细节、依赖环境、错误码列表及权限范围,暂未提供;具体字段取值以 Woodpecker 官方 API 文档为准。