Back to Details

sales-woodpecker

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Woodpecker.co Platform Help

Woodpecker.co 平台帮助中心

Help the user with Woodpecker.co platform questions — from cold email campaign setup and condition-based sequences through deliverability tools, warmup, inbox rotation, LinkedIn automation, Lead Finder, agency panel, API, and integrations.
为用户解答Woodpecker.co平台相关问题 — 从冷邮件营销活动设置、基于条件的序列，到送达率工具、邮箱预热、收件箱轮换、LinkedIn自动化、Lead Finder、代理面板、API及集成等全方面内容。

Step 1 — Gather context

步骤1 — 收集上下文信息

Ask the user:
  1. What area of Woodpecker do you need help with?
    • A) Campaigns — creating condition-based sequences, A/B testing, follow-ups
    • B) Deliverability — Bounce Shield, Adaptive Sending, ESP Matching, domain audit, spam checker
    • C) Warmup — built-in email warmup powered by Mailivery
    • D) Agency panel — multi-client management, per-client isolation
    • E) Integrations / API — connecting to CRMs, webhooks, API automation
    • F) Lead Finder — B2B lead database, data credits
    • G) Inbox — centralized inbox, reply management, auto-categorization
    • H) LinkedIn automation — automated connection requests, messages, multichannel sequences
    • I) Something else — describe it
  2. What's your role?
    • A) Admin / account owner
    • B) Sales rep / BDR / AE
    • C) Agency owner / account manager
    • D) Other
  3. What are you trying to accomplish? (describe your specific goal or question)
If the user's request already provides most of this context, skip directly to the relevant step. Lead with your best-effort answer using reasonable assumptions (stated explicitly), then ask only the most critical 1-2 clarifying questions at the end — don't gate your response behind gathering complete context.
Note: If the user needs a specialized skill, route them there with a brief explanation of why that skill is a better fit.
向用户询问：
  1. 你需要Woodpecker哪方面的帮助？
    • A) 营销活动 — 创建基于条件的序列、A/B测试、跟进设置
    • B) 送达率 — Bounce Shield、Adaptive Sending、ESP匹配、域名审核、垃圾邮件检测
    • C) 邮箱预热 — 由Mailivery提供支持的内置邮箱预热功能
    • D) 代理面板 — 多客户管理、客户数据隔离
    • E) 集成/API — 连接CRM、webhooks、API自动化
    • F) Lead Finder — B2B线索数据库、数据积分
    • G) 收件箱 — 集中式收件箱、回复管理、自动分类
    • H) LinkedIn自动化 — 自动连接请求、消息发送、多渠道序列
    • I) 其他 — 请详细描述
  2. 你的角色是什么？
    • A) 管理员/账户所有者
    • B) 销售代表/BDR/AE
    • C) 代理机构所有者/客户经理
    • D) 其他
  3. 你想要达成什么目标？（描述具体目标或问题）
如果用户的请求已提供大部分上述信息，可直接跳至对应步骤。 先基于合理假设给出初步解答（需明确说明假设），最后仅询问1-2个最关键的澄清问题 — 不要要求用户提供完整上下文后才给出回复。
注意：如果用户需要特定领域的专业技能支持，请引导至对应技能，并简要说明原因。

Step 2 — Route or answer directly

步骤2 — 引导至对应技能或直接解答

If the request maps to a specialized skill, route:
  • Outbound cadence strategy / sequence design -> 
    /sales-cadence
  • Cross-platform email deliverability -> 
    /sales-deliverability
  • Email tracking strategy -> 
    /sales-email-tracking
  • Building prospect lists -> 
    /sales-prospect-list
  • Connecting Woodpecker to other tools via Zapier or middleware -> 
    /sales-integration
  • Multi-client agency architecture (platform-agnostic) -> 
    /sales-agency-outbound
Otherwise, answer directly from platform knowledge using the reference below.
如果用户的请求对应特定专业技能，请引导至：
  • 外呼节奏策略/序列设计 -> 
    /sales-cadence
  • 跨平台邮件送达率优化 -> 
    /sales-deliverability
  • 邮件追踪策略 -> 
    /sales-email-tracking
  • 构建潜在客户列表 -> 
    /sales-prospect-list
  • 通过Zapier或中间件连接Woodpecker与其他工具 -> 
    /sales-integration
  • 多客户代理架构（跨平台通用） -> 
    /sales-agency-outbound
否则，直接基于平台知识库给出解答。

Step 3 — Woodpecker platform reference

步骤3 — Woodpecker平台参考指南

Provide module-by-module guidance based on the user's area:
根据用户需求的领域，提供分模块指导：

Cold email campaigns

冷邮件营销活动

  • Condition-based campaigns: If/then branching based on prospect behavior (opened, clicked, replied) or data attributes — far more flexible than linear sequences
  • Up to 16 steps per campaign — more than most competitors
  • A/B testing: Up to 5 variants per step (subject lines, body copy, send times)
  • Auto-stop on reply: Campaign automatically pauses sending to a prospect when a reply is detected
  • Personalization: Custom fields and snippets for dynamic content
  • Manual tasks: Insert non-automated action steps (e.g., call, LinkedIn visit) into campaign sequences
  • 基于条件的营销活动：根据潜在客户行为（已打开、已点击、已回复）或数据属性设置If/Then分支逻辑 — 比线性序列更灵活
  • 每个活动最多支持16个步骤 — 超过大多数竞品
  • A/B测试：每个步骤最多支持5个变体（主题行、邮件正文、发送时间）
  • 回复自动停止：当检测到潜在客户回复时，自动暂停向该客户发送后续邮件
  • 个性化设置：自定义字段和代码片段，实现动态内容
  • 手动任务：在营销活动序列中插入非自动化操作步骤（如电话沟通、LinkedIn访问）

Deliverability toolkit

送达率工具包

  • Bounce Shield: Prevents sending to risky addresses, protects sender reputation by pre-validating before each send
  • Adaptive Sending: Automatically adjusts send volume based on provider limits and engagement signals — throttles down when signals are negative
  • ESP Matching: Matches your sending patterns to what email providers expect, reducing spam flags
  • Domain audit: Checks SPF, DKIM, DMARC configuration with specific fix suggestions
  • Spam checker: Highlights spammy words, broken links, and authentication issues before sending — catch problems pre-launch
  • Deliverability monitor: Ongoing monitoring of inbox placement and sender reputation
  • Bounce Shield：阻止向高风险地址发送邮件，通过发送前预验证保护发件人信誉
  • Adaptive Sending：根据邮件服务商限制和互动信号自动调整发送量 — 当信号不佳时自动限流
  • ESP匹配：使发送模式匹配邮件服务商的预期要求，降低被标记为垃圾邮件的概率
  • 域名审核：检查SPF、DKIM、DMARC配置，并提供具体修复建议
  • 垃圾邮件检测器：发送前标记垃圾邮件词汇、失效链接和认证问题 — 提前排查隐患
  • 送达率监控：持续监控收件箱投递情况和发件人信誉

Email warmup

邮箱预热

  • Free built-in warmup powered by Mailivery — included in all plans
  • AI-driven interactions: Opens, replies, marks as important, removes from spam — mimics real engagement
  • Ramp schedule: Starts with a few emails/day, gradually ramps to a max of 50/day
  • Free plan: 4 warmup slots included at no cost
  • Additional slots: Available as an add-on at EUR 5 per account
  • Best practice: Run warmup for 2+ weeks before launching campaigns from a new mailbox
  • 免费内置预热功能，由Mailivery提供支持 — 所有套餐均包含
  • AI驱动的互动行为：模拟真实用户的打开、回复、标记为重要、移出垃圾邮箱等操作
  • 渐进式计划：从每天发送几封邮件开始，逐步增加至最多每天50封
  • 免费套餐：包含4个预热名额，无需额外付费
  • 额外名额：可作为附加服务购买，每个账户每月5欧元
  • 最佳实践：从新邮箱启动营销活动前，需运行预热2周以上

Email verification

邮件验证

  • Free catch-all verification powered by Bouncer
  • Real-time list cleaning before sending — automatic validation when prospects are added to campaigns
  • Reduces bounce rate and protects sender reputation
  • No additional cost — included in all plans
  • 免费的全域验证功能，由Bouncer提供支持
  • 发送前实时清理列表 — 当潜在客户被添加到营销活动时自动验证
  • 降低退信率，保护发件人信誉
  • 无需额外付费 — 所有套餐均包含

Inbox rotation

收件箱轮换

  • Automatic distribution of sending across multiple connected email accounts
  • Woodpecker rotates which account sends each email in a campaign
  • Unlimited email accounts on all plans — no per-seat or per-mailbox charges
  • Helps maintain per-account sending limits while increasing total daily volume
  • 自动在多个已连接邮箱间分配发送任务
  • Woodpecker会轮换使用不同邮箱发送营销活动中的每封邮件
  • 所有套餐支持无限邮箱账户 — 无按席位或按邮箱收费的限制
  • 有助于在保持单账户发送限制的同时，提升每日总发送量

Centralized inbox

集中式收件箱

  • Unified view of all replies from all connected mailboxes in one place
  • Auto-categorization: Interested, auto-replied, bounced, out-of-office — no manual sorting
  • Filters: By campaign, status, or mailbox
  • Reply directly from the centralized inbox without switching accounts
  • 统一查看所有已连接邮箱的回复
  • 自动分类：分为感兴趣、自动回复、退信、外出办公等类别 — 无需手动排序
  • 筛选功能：可按营销活动、状态或邮箱筛选
  • 直接回复：无需切换账户，直接在集中式收件箱中回复

LinkedIn automation

LinkedIn自动化

  • Add-on: EUR 29/month per LinkedIn account
  • Automated actions: Connection requests, messages, and profile visits
  • Multichannel sequences: LinkedIn steps woven into email campaign steps
  • Condition-based: e.g., if email not opened -> send LinkedIn connection request
  • Requires a connected LinkedIn account
  • 附加服务：每个LinkedIn账户每月29欧元
  • 自动化操作：连接请求、消息发送、资料访问
  • 多渠道序列：将LinkedIn步骤融入邮件营销活动序列
  • 基于条件触发：例如，若邮件未被打开 -> 发送LinkedIn连接请求
  • 需要连接LinkedIn账户

Lead Finder

Lead Finder

  • B2B database with 1B+ leads
  • Search filters: Company, title, industry, location
  • Data credits system: 400 free credits included, additional credits from EUR 28 per 2,000 credits
  • Direct export: Export leads directly into Woodpecker campaigns — no CSV intermediary needed
  • 拥有10亿+线索的B2B数据库
  • 搜索筛选器：按公司、职位、行业、地点筛选
  • 数据积分体系：包含400个免费积分，额外积分从28欧元/2000积分起售
  • 直接导出：可直接将线索导出至Woodpecker营销活动 — 无需通过CSV中转

Agency panel

代理面板

  • Add-on: EUR 27/month per active client
  • Multi-client management from a single dashboard
  • Per-client isolation: Separate campaigns, prospects, mailboxes per client — no data bleed
  • Agency API: HQ key + 
    x-company-id
    header for programmatic client management
  • Per-company API keys: Create API keys scoped to individual clients, manage mailboxes and campaigns across clients
  • 附加服务：每个活跃客户每月27欧元
  • 单仪表盘多客户管理
  • 客户数据隔离：每个客户拥有独立的营销活动、潜在客户、邮箱 — 无数据交叉
  • 代理API：使用总部密钥+
    x-company-id
    请求头实现程序化客户管理
  • 按公司分配API密钥：可为单个客户创建专属API密钥，跨客户管理邮箱和营销活动

Data model

数据模型

ObjectDescriptionKey fields
CampaignCold email sequence with stepsid, name, status, steps, prospects
ProspectContact recordid, email, firstName, lastName, company, status, tags
MailboxConnected email accountid, email, provider, warmupEnabled, dailyLimit
Campaign StepIndividual step in a campaignid, campaignId, type (email/LinkedIn/task), variant, delay
WebhookEvent subscriptionid, url, events, status
BlacklistBlocked domains/emailsid, type (domain/email), value
LinkedIn AccountConnected LinkedIn profileid, name, status
Manual TaskNon-automated action in campaignid, type, prospectId, description
对象描述核心字段
Campaign冷邮件序列及步骤id, name, status, steps, prospects
Prospect联系人记录id, email, firstName, lastName, company, status, tags
Mailbox已连接的邮箱账户id, email, provider, warmupEnabled, dailyLimit
Campaign Step营销活动中的单个步骤id, campaignId, type (email/LinkedIn/task), variant, delay
Webhook事件订阅id, url, events, status
Blacklist被阻止的域名/邮箱id, type (domain/email), value
LinkedIn Account已连接的LinkedIn资料id, name, status
Manual Task营销活动中的非自动化操作id, type, prospectId, description

API quick reference

API快速参考

  • Base URL: 
    https://api.woodpecker.co/rest
  • Auth: 
    x-api-key
    header
  • Versions: V1 (stable), V2 (under development)
  • Key endpoints: Campaigns, Prospects, Mailboxes, LinkedIn accounts, Inbox, Reports, Users, Manual tasks, Blacklist, Webhooks
  • Agency API: HQ key + 
    x-company-id
    header for multi-client access
  • Rate limits: 1 concurrent request, queue of 6 (15-second timeout), unlimited monthly calls, HTTP 429 on overflow
  • Add-on required: API & integrations add-on (EUR 20/mo) or active trial
  • Full reference: See 
    references/woodpecker-api-reference.md
  • Developer contact: developers@woodpecker.co
  • 基础URL：
    https://api.woodpecker.co/rest
  • 认证方式：
    x-api-key
    请求头
  • 版本：V1（稳定版）、V2（开发中）
  • 核心端点：Campaigns、Prospects、Mailboxes、LinkedIn accounts、Inbox、Reports、Users、Manual tasks、Blacklist、Webhooks
  • 代理API：使用总部密钥+
    x-company-id
    请求头实现多客户访问
  • 速率限制：1个并发请求，队列容量6个（超时时间15秒），每月调用次数无限制，超出队列限制时返回HTTP 429
  • 需附加服务：API及集成附加服务（每月20欧元）或处于有效试用阶段
  • 完整参考文档：详见
    references/woodpecker-api-reference.md
  • 开发者联系方式：developers@woodpecker.co

Pricing (as of 2026, EUR — verify current pricing at woodpecker.co)

定价（截至2026年，单位：欧元 — 请以woodpecker.co官网当前定价为准）

TierContacted prospects/moPrice
Free500EUR 0
Tier 1500EUR 35/mo
Tier 22,000EUR 67/mo
Tier 34,000EUR 99/mo
EnterpriseUnlimitedCustom
Add-ons: LinkedIn (EUR 29/acct), Agency (EUR 27/client), API & integrations (EUR 20), warmup slots (EUR 5/acct), servers (EUR 59/server), Lead Finder (from EUR 28/2K credits). Annual billing saves 33%.
套餐每月可联系潜在客户数量价格
免费版5000欧元/月
套餐150035欧元/月
套餐2200067欧元/月
套餐3400099欧元/月
企业版无限制定制价格
附加服务：LinkedIn自动化（每个账户29欧元）、代理面板（每个客户27欧元）、API及集成（20欧元）、预热名额（每个账户5欧元）、服务器（59欧元/服务器）、Lead Finder（从28欧元/2000积分起）。按年付费可享受33%折扣。

Integrations

集成功能

  • HubSpot: Native integration (requires API & integrations add-on)
  • Pipedrive: Native integration
  • Salesforce: Via Zapier
  • Zapier: Full integration — triggers and actions
  • Clay, Persana AI: Native connectors
  • Calendly: Meeting booking integration
  • Google Sheets: Prospect import/export
  • HubSpot：原生集成（需API及集成附加服务）
  • Pipedrive：原生集成
  • Salesforce：通过Zapier集成
  • Zapier：完整集成 — 支持触发事件和操作
  • Clay、Persana AI：原生连接器
  • Calendly：会议预约集成
  • Google Sheets：潜在客户导入/导出

Step 4 — Actionable guidance

步骤4 — 可落地的指导建议

Based on the user's specific question:
  1. Recommended setup order for new accounts:
    1. Connect mailbox(es) (Gmail, Outlook, or SMTP)
    2. Enable warmup on all connected mailboxes
    3. Wait 2+ weeks for warmup to build reputation
    4. Set up domain authentication (SPF, DKIM, DMARC) — use Woodpecker's domain audit to verify
    5. Create your first campaign with condition-based steps
    6. Add prospects (manually, CSV, Lead Finder, or API)
    7. Run spam checker on your email copy
    8. Launch campaign
  2. Configuration recommendations:
    • Enable Bounce Shield on all campaigns — there is no reason to skip it
    • Enable Adaptive Sending to let Woodpecker auto-throttle based on engagement
    • Set daily per-mailbox limits conservatively (30-50 for cold outbound)
    • Use inbox rotation with 3+ mailboxes to distribute volume
    • A/B test subject lines first, then body copy — test one variable at a time
  3. For API questions: Always include a pointer — "For the full endpoint catalog, request/response schemas, and rate limits, see 
    references/woodpecker-api-reference.md
    ."
根据用户的具体问题：
  1. 新账户推荐设置顺序：
    1. 连接邮箱（Gmail、Outlook或SMTP）
    2. 为所有已连接邮箱启用预热功能
    3. 等待2周以上，通过预热建立发件人信誉
    4. 设置域名认证（SPF、DKIM、DMARC） — 使用Woodpecker的域名审核工具验证配置
    5. 创建首个包含基于条件步骤的营销活动
    6. 添加潜在客户（手动、CSV、Lead Finder或API）
    7. 对邮件内容运行垃圾邮件检测
    8. 启动营销活动
  2. 配置建议：
    • 为所有营销活动启用Bounce Shield — 没有理由跳过该功能
    • 启用Adaptive Sending，让Woodpecker根据互动信号自动限流
    • 保守设置单邮箱每日发送限制（冷外呼建议30-50封）
    • 使用3个以上邮箱进行收件箱轮换，分散发送量
    • 先对主题行进行A/B测试，再测试邮件正文 — 每次仅测试一个变量
  3. API相关问题：务必附上指引 — “如需完整的端点目录、请求/响应 schema及速率限制详情，请查看
    references/woodpecker-api-reference.md
    。”

Gotchas

注意事项

Best-effort from research — verify details against current Woodpecker documentation.
  1. API access is a paid add-on (EUR 20/mo) — not included in base plans. Many users expect API access by default, but you need the API & integrations add-on or an active trial to use the API at all.
  2. LinkedIn automation is a separate add-on (EUR 29/LinkedIn account) — not included in any plan tier. Each LinkedIn account you want to automate costs extra on top of your base plan.
  3. Woodpecker prices by "contacted prospects" not by user/seat — every new person added to a campaign counts against your monthly limit, even if they don't receive all steps. Recontacting the same prospect in a different campaign counts again.
  4. The agency panel is per active client (EUR 27/client/mo) — costs scale linearly with client count. Compare with Smartlead's flat agency pricing if managing many clients.
  5. Woodpecker's API has a strict 1-concurrent-request limit with a queue of only 6 — high-volume API integrations need careful throttling and retry logic. Requests beyond 6 queued return HTTP 429 immediately (15-second timeout per queued request).
以下内容基于研究整理，建议对照Woodpecker官方文档核实细节。
  1. API访问是付费附加服务（每月20欧元） — 基础套餐不包含。很多用户默认以为API是免费的，但必须购买API及集成附加服务或处于有效试用阶段才能使用API。
  2. LinkedIn自动化是独立附加服务（每个LinkedIn账户每月29欧元） — 任何套餐均不包含。每个需要自动化的LinkedIn账户都需在基础套餐之外额外付费。
  3. Woodpecker按“已联系潜在客户数量”计费，而非按用户/席位 — 每个添加到营销活动的新联系人都会计入月度限额，即使他们未收到所有步骤的邮件。在不同营销活动中重新联系同一联系人也会再次计入限额。
  4. 代理面板按活跃客户数量计费（每个客户每月27欧元） — 成本随客户数量线性增长。如果管理大量客户，可对比Smartlead的固定代理定价。
  5. Woodpecker API严格限制1个并发请求，队列容量仅为6个 — 高流量API集成需要谨慎的限流和重试逻辑。超出队列容量的请求会立即返回HTTP 429（每个队列请求超时时间15秒）。

Step 5 — Related skills

步骤5 — 相关技能

  • /sales-cadence
    — Design outbound cadence strategy (platform-agnostic, works with Woodpecker campaigns)
  • /sales-deliverability
    — Cross-platform email deliverability — SPF/DKIM/DMARC, warmup, inbox placement
  • /sales-email-tracking
    — Email tracking strategy — open/click tracking, engagement signals
  • /sales-prospect-list
    — Build prospect lists to import into Woodpecker
  • /sales-integration
    — Connect Woodpecker to other tools via webhooks, Zapier, or API
  • /sales-agency-outbound
    — Multi-client agency architecture — infrastructure, client isolation, onboarding
  • /sales-enrich
    — Enrich contacts with emails/phones before importing into Woodpecker
  • /sales-smartlead
    — Smartlead platform help (if evaluating alternatives to Woodpecker)
  • /sales-lemlist
    — Lemlist platform help (if evaluating alternatives to Woodpecker)
  • /sales-do
    — Not sure which skill to use? The router matches any sales objective to the right skill. Install with 
    /install-skill sales-do
    if you don't have it.
  • /sales-cadence
    — 设计外呼节奏策略（跨平台通用，适用于Woodpecker营销活动）
  • /sales-deliverability
    — 跨平台邮件送达率优化 — SPF/DKIM/DMARC、邮箱预热、收件箱投递
  • /sales-email-tracking
    — 邮件追踪策略 — 打开/点击追踪、互动信号
  • /sales-prospect-list
    — 构建潜在客户列表以导入Woodpecker
  • /sales-integration
    — 通过webhooks、Zapier或API连接Woodpecker与其他工具
  • /sales-agency-outbound
    — 多客户代理架构 — 基础设施、客户隔离、客户接入
  • /sales-enrich
    — 在导入Woodpecker前，补充联系人的邮箱/电话信息
  • /sales-smartlead
    — Smartlead平台帮助（如果在评估Woodpecker的替代工具）
  • /sales-lemlist
    — Lemlist平台帮助（如果在评估Woodpecker的替代工具）
  • /sales-do
    — 不确定使用哪个技能？该技能可将任何销售目标匹配到对应技能。如果未安装，请通过
    /install-skill sales-do
    安装。

Examples

示例

Example 1: Basic campaign setup with A/B testing

示例1：带A/B测试的基础营销活动设置

User says: "How do I set up a cold email campaign in Woodpecker with A/B testing and follow-ups?" Skill does:
  1. Walks through creating a new campaign with condition-based steps
  2. Explains adding up to 16 steps with delays between them — initial email plus follow-ups
  3. Shows how to create A/B test variants (up to 5 per step) for subject lines and body copy
  4. Configures auto-stop on reply so prospects exit the sequence when they respond
  5. Recommends connecting 3+ mailboxes with inbox rotation for volume distribution Result: User has a multi-step campaign with A/B testing, follow-ups, and proper mailbox rotation configured
用户提问：“如何在Woodpecker中设置包含A/B测试和跟进的冷邮件营销活动？” 技能操作：
  1. 引导创建包含基于条件步骤的新营销活动
  2. 说明如何添加最多16个带延迟的步骤 — 初始邮件加跟进邮件
  3. 展示如何为主题行和邮件正文创建A/B测试变体（每个步骤最多5个）
  4. 配置回复自动停止功能，使潜在客户回复后退出序列
  5. 建议连接3个以上邮箱并启用收件箱轮换以分散发送量 结果：用户完成了带A/B测试、跟进设置和合理邮箱轮换的多步骤营销活动配置

Example 2: Deliverability audit

示例2：送达率问题排查

User says: "My Woodpecker emails are going to spam. How do I fix deliverability?" Skill does:
  1. Runs through Woodpecker's domain audit — checks SPF, DKIM, DMARC with fix suggestions
  2. Verifies warmup status on all connected mailboxes — must be running 2+ weeks with healthy reputation
  3. Enables Bounce Shield and Adaptive Sending if not already active
  4. Uses spam checker to audit email copy for spammy words, broken links, and authentication issues
  5. Recommends deliverability monitor for ongoing inbox placement tracking Result: User has a complete deliverability diagnosis with specific fixes and ongoing monitoring
用户提问：“我的Woodpecker邮件被标记为垃圾邮件，如何修复送达率问题？” 技能操作：
  1. 引导运行Woodpecker的域名审核 — 检查SPF、DKIM、DMARC配置并提供修复建议
  2. 验证所有已连接邮箱的预热状态 — 必须运行2周以上且信誉良好
  3. 若未启用，帮助开启Bounce Shield和Adaptive Sending
  4. 使用垃圾邮件检测器审核邮件内容中的垃圾词汇、失效链接和认证问题
  5. 建议启用送达率监控以持续跟踪收件箱投递情况 结果：用户完成了完整的送达率诊断，获得具体修复方案和持续监控方法

Example 3: Agency panel configuration

示例3：代理面板配置

User says: "I run an agency and need to manage 10 clients in Woodpecker" Skill does:
  1. Explains the agency panel add-on pricing (EUR 27/active client/mo = EUR 270/mo for 10 clients)
  2. Walks through setting up per-client isolation — separate campaigns, prospects, and mailboxes
  3. Shows the Agency API authentication pattern: HQ key + 
    x-company-id
    header
  4. Configures per-company API keys for any clients needing their own API access
  5. Sets up a single-dashboard workflow for monitoring all 10 clients Result: User has 10 isolated client workspaces with API access and centralized management
用户提问：“我运营一家代理机构，需要在Woodpecker中管理10个客户” 技能操作：
  1. 说明代理面板附加服务的定价（每个活跃客户每月27欧元，10个客户每月总计270欧元）
  2. 引导设置客户数据隔离 — 每个客户拥有独立的营销活动、潜在客户和邮箱
  3. 展示代理API的认证方式：总部密钥+
    x-company-id
    请求头
  4. 为需要独立API访问的客户配置按公司分配的API密钥
  5. 建立单仪表盘监控10个客户的工作流程 结果：用户完成了10个客户的隔离工作区配置，具备API访问权限和集中管理能力

Troubleshooting

故障排查

Emails going to spam

邮件被标记为垃圾邮件

Symptom: Prospects report finding emails in spam, or reply rates are near zero despite high send volume Cause: Missing or misconfigured domain authentication (SPF/DKIM/DMARC), insufficient warmup, spammy content, or sender reputation damage Solution: Run Woodpecker's domain audit to check SPF/DKIM/DMARC — fix any issues flagged. Verify warmup has been running 2+ weeks on all mailboxes. Use the spam checker to audit email copy. Enable Bounce Shield and Adaptive Sending. If reputation is damaged, pause campaigns, run warmup-only for 2-3 weeks, then relaunch with lower volume. See 
/sales-deliverability
for a comprehensive diagnosis framework.
症状：潜在客户反馈邮件出现在垃圾邮箱中，或发送量很高但回复率接近零 原因：域名认证缺失或配置错误（SPF/DKIM/DMARC）、预热不充分、邮件内容类似垃圾邮件、发件人信誉受损 解决方案：运行Woodpecker的域名审核工具检查SPF/DKIM/DMARC — 修复所有标记的问题。验证所有邮箱的预热已运行2周以上。使用垃圾邮件检测器审核邮件内容。启用Bounce Shield和Adaptive Sending。如果信誉受损，暂停营销活动，仅运行预热2-3周，然后以较低发送量重新启动。如需全面诊断框架，请查看
/sales-deliverability
。

Low open rates

打开率低

Symptom: Campaign open rates below 30% Cause: Poor subject lines, bad send times, inbox placement issues, or stale prospect data Solution: A/B test subject lines (use all 5 variant slots). Check deliverability — low opens often mean emails are landing in spam, not that prospects are ignoring them. Verify prospect emails with Woodpecker's built-in verification to remove invalid addresses. Test different send times and days. Use Adaptive Sending to let Woodpecker optimize send timing. If open rates are low across all variants, the issue is likely deliverability, not content.
症状：营销活动打开率低于30% 原因：主题行质量差、发送时间不佳、收件箱投递问题、潜在客户数据过时 解决方案：对主题行进行A/B测试（使用全部5个变体名额）。检查送达率 — 打开率低通常意味着邮件进入了垃圾邮箱，而非潜在客户忽略。使用Woodpecker的内置验证工具核实潜在客户邮箱有效性，移除无效地址。测试不同的发送日期和时间。启用Adaptive Sending，让Woodpecker优化发送时间。如果所有变体的打开率都很低，问题很可能出在送达率而非内容上。

API 429 errors

API 429错误

Symptom: Frequent HTTP 429 (Too Many Requests) responses from the Woodpecker API Cause: Exceeding the 1-concurrent-request limit or overflowing the 6-request queue Solution: Woodpecker allows only 1 request at a time with a queue of 6 (15-second timeout per queued request). Implement strict request serialization — never send concurrent requests. Add retry logic with exponential backoff starting at 15 seconds. For bulk operations, batch where possible and process sequentially. If you need higher throughput, contact developers@woodpecker.co about rate limit increases. See 
references/woodpecker-api-reference.md
for full rate limit details.
症状：频繁收到Woodpecker API返回的HTTP 429（请求过多）响应 原因：超出1个并发请求限制或队列容量（6个） 解决方案：Woodpecker仅允许同时发送1个请求，队列容量为6个（每个队列请求超时时间15秒）。实现严格的请求序列化 — 绝不发送并发请求。添加指数退避重试逻辑，初始重试间隔为15秒。批量操作时尽可能分批处理，按顺序执行。如果需要更高吞吐量，请联系developers@woodpecker.co申请提高速率限制。如需完整速率限制详情，请查看
references/woodpecker-api-reference.md
。