sales-woodpecker

Woodpecker.co プラットフォームのヘルプ

コールドメールキャンペーンの設定や条件に基づくシーケンスから、到達性ツール、ウォームアップ、受信トレイのローテーション、LinkedIn の自動化、Lead Finder、エージェンシーパネル、API、インテグレーションまで、Woodpecker.co プラットフォームに関する質問に対応します。

ステップ 1 — 背景情報の確認

references/learnings.md が存在する場合は、蓄積された知識を確認するため、まず読み込んでください。

ユーザーに次の質問をしてください。

1. Woodpecker のどの分野についてサポートが必要ですか？

   • A) キャンペーン — 条件に基づくシーケンスの作成、A/B テスト、フォローアップ
   • B) 到達性 — Bounce Shield、Adaptive Sending、ESP Matching、ドメイン監査、スパムチェッカー
   • C) ウォームアップ — Mailivery を利用した組み込みのメールウォームアップ
   • D) エージェンシーパネル — 複数クライアントの管理、クライアントごとの分離
   • E) インテグレーション／API — CRM への接続、ウェブフック、API の自動化
   • F) Lead Finder — B2B リードデータベース、データクレジット
   • G) 受信トレイ — 一元化された受信トレイ、返信管理、自動分類
   • H) LinkedIn の自動化 — 接続リクエストやメッセージの自動送信、マルチチャネルシーケンス
   • I) その他 — 内容を説明してください

2. あなたの役割は何ですか？

   • A) 管理者／アカウント所有者
   • B) 営業担当者／BDR／AE
   • C) エージェンシーのオーナー／アカウントマネージャー
   • D) その他

3. 何を達成しようとしていますか？（具体的な目標や質問を説明してください）

ユーザーの依頼にすでに背景情報の大部分が含まれている場合は、該当するステップに直接進んでください。 妥当な前提を明示したうえで、可能な範囲で最善の回答を先に提示し、最後に最も重要な確認質問を 1～2 個だけ尋ねてください。必要な背景情報をすべて集めるまで回答を保留しないでください。

注：ユーザーに専門スキルが必要な場合は、そのスキルが適している理由を簡潔に説明し、そちらに案内してください。

ステップ 2 — 案内する、または直接回答する

依頼が専門スキルに該当する場合は、次のように案内してください。

• アウトバウンドの接触頻度戦略／シーケンスの設計 -> /sales-cadence
• 複数プラットフォームにまたがるメール到達性 -> /sales-deliverability
• メールトラッキング戦略 -> /sales-email-tracking
• 見込み客リストの作成 -> /sales-prospect-list
• Zapier やミドルウェアを介した Woodpecker と他のツールの接続 -> /sales-integration
• 複数クライアントに対応するエージェンシーアーキテクチャ（プラットフォーム非依存） -> /sales-agency-outbound

それ以外の場合は、以下のリファレンスを参照し、プラットフォームの知識に基づいて直接回答してください。

ステップ 3 — Woodpecker プラットフォームのリファレンス

モジュールの詳細なドキュメント、料金、インテグレーション、データモデルについては、references/platform-guide.md を読んでください。

プラットフォームガイドの詳細を参照する必要はなくなりました。ユーザー固有の状況に集中してください。

ステップ 4 — 実践的なガイダンス

ユーザーの具体的な質問に基づいて、次のように対応してください。

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 が自動的に送信量を調整できるようにしてください
   • メールボックスごとの 1 日あたりの上限は、控えめに設定してください（コールドアウトバウンドの場合は 30～50 件）
   • 3 つ以上のメールボックスで受信トレイのローテーションを使い、送信量を分散してください
   • まず件名を、次に本文を A/B テストしてください。一度にテストする変数は 1 つにしてください

3. API に関する質問の場合：必ず次の案内を含めてください — 「エンドポイント一覧、リクエスト／レスポンスのスキーマ、レート制限については、references/woodpecker-api-reference.md を参照してください。」

注意点

調査に基づくベストエフォートの情報です。詳細は Woodpecker の最新ドキュメントで確認してください。

1. API アクセスは有料アドオンです（月額 $20、2026-06-13 確認） — 基本プランには含まれていません。API アクセスは標準で利用できると思っているユーザーも多いですが、「API, webhooks, MCP Server, CLI & integrations」アドオンまたは有効なトライアルが必要です。同じ単一のアドオンで、公式 MCP Server（Woodpeckerco/woodpecker-mcp-server、WOODPECKER_API_KEY env var、Claude/Cursor で動作）と CLI（@woodpecker.co/cli、コマンド woodpecker）も利用できるようになります。
2. LinkedIn の自動化は別のアドオンです（LinkedIn アカウントごとに月額 $29） — どのプランにも含まれていません。自動化する LinkedIn アカウントごとに、基本プラン料金に加えて追加料金がかかります。
3. Woodpecker の料金はユーザー／シート単位ではなく、「連絡した見込み客」数に基づきます — 現在の料金は計算ツールによるもので、連絡した見込み客 100 人あたり月額約 $4.8 です（2026-06-13 確認）。キャンペーンに新しい人を追加すると、すべてのステップを受け取らない場合でも、月間上限にカウントされます。同じ見込み客に別のキャンペーンで再度連絡すると、再びカウントされます。
4. 代理店パネルの料金は有効なクライアントごとにかかります（月額 $27／クライアント、オプションの White Label は月額 $5／クライアント） — クライアント数に比例して料金が増えます。多くのクライアントを管理する場合は、Smartlead の定額制代理店料金と比較してください。
5. Woodpecker の API は同時リクエスト数が 1 件に厳しく制限され、キューはわずか 6 件です — 大量の API を利用する連携では、慎重なスロットリングと再試行ロジックが必要です。キューに 6 件を超えてリクエストを追加すると、HTTP 429 が直ちに返されます（キューに入ったリクエストごとに 15 秒のタイムアウト）。

• 継続的な改善：ここに記載されていないことが分かった場合は、今日の日付を添えて references/learnings.md に追記してください。

Step 5 — 関連スキル

• /sales-cadence — アウトバウンドのケイデンス戦略を設計します（プラットフォームに依存せず、Woodpecker のキャンペーンにも対応）
• /sales-deliverability — プラットフォームを問わないメール到達性 — SPF/DKIM/DMARC、ウォームアップ、受信トレイへの配置
• /sales-email-tracking — メール追跡戦略 — 開封／クリック追跡、エンゲージメントのシグナル
• /sales-prospect-list — Woodpecker にインポートする見込み客リストを作成します
• /sales-integration — Webhook、Zapier、API を使って Woodpecker を他のツールに接続します
• /sales-agency-outbound — 複数クライアント向け代理店アーキテクチャ — インフラストラクチャ、クライアントの分離、オンボーディング
• /sales-enrich — Woodpecker にインポートする前に、連絡先のメールアドレス／電話番号を補完します
• /sales-smartlead — Smartlead のプラットフォームに関するサポート（Woodpecker の代替サービスを検討している場合）
• /sales-lemlist — Lemlist のプラットフォームに関するサポート（Woodpecker の代替サービスを検討している場合）
• /sales-do — どのスキルを使えばよいか分かりませんか？ルーターが営業に関するあらゆる目的に適したスキルを判断します。まだインストールしていない場合は、/install-skill sales-do でインストールしてください。

例

例 1：A/B テストを使った基本的なキャンペーン設定

ユーザーの発言：「A/B テストとフォローアップを含むコールドメールキャンペーンを Woodpecker で設定するには、どうすればよいですか？」 スキルの動作：

1. 条件ベースのステップを使って新しいキャンペーンを作成する手順を説明します
2. 初回メールとフォローアップを含め、最大 16 個のステップを追加し、各ステップの間隔を設定する方法を説明します
3. 件名と本文の文面について、A/B テスト用のバリエーション（各ステップ最大 5 件）を作成する方法を紹介します
4. 返信があったときに見込み客がシーケンスから外れるよう、自動停止を設定します
5. 配信量を分散するため、受信トレイローテーションを使って 3 つ以上のメールボックスを接続することを推奨します 結果：ユーザーは、A/B テスト、フォローアップ、適切なメールボックスローテーションを設定した複数ステップのキャンペーンを利用できます

例 2：到達率の監査

ユーザーの発言：「Woodpecker から送ったメールが迷惑メールに振り分けられてしまいます。到達率を改善するにはどうすればよいですか？」 スキルの動作：

1. Woodpecker のドメイン監査を実施し、SPF、DKIM、DMARC を確認して修正案を提示します
2. 接続済みのすべてのメールボックスのウォームアップ状況を確認します。健全なレピュテーションを保つには、2 週間以上継続している必要があります
3. Bounce Shield と Adaptive Sending がまだ有効になっていない場合は有効にします
4. スパムチェッカーを使ってメールの文面を監査し、スパムと見なされやすい語句、リンク切れ、認証の問題を確認します
5. 継続的に受信トレイへの到達状況を追跡するため、到達率モニターを推奨します 結果：具体的な修正方法と継続的なモニタリングを含む、到達率の完全な診断が得られます

例 3：代理店パネルの設定

ユーザーの発言：「代理店を運営しており、Woodpecker で 10 社のクライアントを管理する必要があります」 スキルの動作：

1. 代理店パネルのアドオン料金を説明します（有効なクライアント 1 社あたり月額 EUR 27、10 社で月額 EUR 270）
2. クライアントごとの分離設定を案内します。キャンペーン、見込み客、メールボックスを個別に管理します
3. 代理店 API の認証方式を説明します。HQ キーと x-company-id ヘッダーを使用します
4. 独自の API アクセスが必要なクライアント向けに、会社ごとの API キーを設定します
5. 10 社すべてを監視する単一ダッシュボードのワークフローを設定します 結果：API アクセスと一元管理が可能な、クライアントごとに分離された 10 個のワークスペースが得られます

トラブルシューティング

メールが迷惑メールに振り分けられる

症状：見込み客からメールが迷惑メールに入っていたと報告される、または大量に送信しているにもかかわらず返信率がほぼゼロです 原因：ドメイン認証（SPF／DKIM／DMARC）の設定漏れまたは誤設定、ウォームアップ不足、スパムと見なされやすいコンテンツ、または送信者のレピュテーション低下です 解決策：Woodpecker のドメイン監査を実行し、SPF／DKIM／DMARC を確認して、指摘された問題を修正します。すべてのメールボックスでウォームアップが 2 週間以上続いていることを確認します。スパムチェッカーでメールの文面を監査します。Bounce Shield と Adaptive Sending を有効にします。レピュテーションが低下している場合は、キャンペーンを一時停止し、2〜3 週間はウォームアップのみを実施してから、送信量を減らして再開します。包括的な診断フレームワークについては、/sales-deliverability を参照してください。

開封率が低い

症状：キャンペーンの開封率が 30％未満です 原因：件名の質が低い、送信時刻が適切でない、受信トレイへの到達に問題がある、または見込み客データが古いことです 解決策：件名を A/B テストします（5 つのバリエーション枠をすべて使用します）。到達率を確認します。開封率が低い場合、見込み客が無視しているのではなく、メールが迷惑メールに入っていることがよくあります。Woodpecker に組み込まれた検証機能で見込み客のメールアドレスを確認し、無効なアドレスを削除します。送信時刻と曜日を変えてテストします。Adaptive Sending を使い、Woodpecker が送信タイミングを最適化できるようにします。すべてのバリエーションで開封率が低い場合、問題はコンテンツではなく到達率にある可能性が高いです。

API 429 エラー

症状：Woodpecker API から HTTP 429（リクエストが多すぎます）の応答が頻繁に返されます 原因：同時リクエスト数の上限である 1 件を超えている、または 6 件のリクエストキューがあふれています 解決策：Woodpecker では、一度に実行できるリクエストは 1 件のみで、キューの上限は 6 件です（キューに入ったリクエストのタイムアウトは 15 秒です）。リクエストを厳密に直列化し、同時にリクエストを送信しないでください。15 秒から開始する指数バックオフを使った再試行ロジックを追加します。一括操作では、可能な限りバッチ処理を行い、順次処理します。より高いスループットが必要な場合は、[email protected] に連絡してレート制限の引き上げについて相談してください。レート制限の詳細については、references/woodpecker-api-reference.md を参照してください。