sales-zerobounce

ZeroBounce プラットフォームのヘルプ

メール認証やリストのクリーニングから、AI スコアリング、アクティビティデータ、受信トレイへの配信テスト、ブラックリスト監視、DMARC 監視、メールウォームアップ、API 連携、メール検索まで、ZeroBounce プラットフォームに関する質問に対応します。

ZeroBounce は、30 種類以上のメールステータスで 99.6％の精度を実現する、メール認証および配信到達性プラットフォームです。SOC 2 Type 2 および ISO-27001 認証を取得し、GDPR／HIPAA／CCPA に準拠しています。主な強みは、一括およびリアルタイムのメール認証、AI によるキャッチオールスコアリング、エンゲージメント追跡用のアクティビティデータ、受信トレイへの配信テスト、ブラックリスト監視、DMARC 監視、メールウォームアップです。

Step 1 — コンテキストを確認する

references/learnings.md が存在する場合は、蓄積された知識を確認するために、まずそれを読みます。

ユーザーに次の質問をします。

1. ZeroBounce のどの機能についてサポートが必要ですか？

   • A) メール認証 — リストの一括クリーニング、またはリアルタイムの API 検証
   • B) メール検索 — 名前とドメインによる B2B メールアドレスの検索
   • C) メールスコアリング（AI）— キャッチオールアドレスの認証とエンゲージメントスコアリング
   • D) アクティビティデータ — 購読者のエンゲージメント追跡
   • E) 受信トレイへの配信テスト — メール設定と、受信トレイまたはスパムへの振り分けをテスト
   • F) ブラックリスト監視 — 200 以上のプロバイダーを対象とした IP／ドメインのブラックリスト確認
   • G) DMARC モニター — ドメイン認証の監視とポリシー設定
   • H) メールウォームアップ — ドメイン／IP のレピュテーション向上
   • I) API と SDK — プログラムによるアクセスと自動化
   • J) 連携 — HubSpot、Salesforce、Mailchimp、Zapier など
   • K) アカウントと請求 — クレジット、料金、プラン
   • L) その他 — 内容を説明してください

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

   • A) 営業担当者／AE／BDR
   • B) 営業マネージャー／チームリーダー
   • C) RevOps／営業オペレーション
   • D) マーケター／メールマーケター
   • E) 管理者／IT 担当者
   • F) 創業者／個人営業担当者
   • G) その他

3. 何を達成しようとしていますか？（具体的な目標を説明してください。例：「HubSpot キャンペーンの前に 10 万件の連絡先をクリーニングする」「5 つの送信 IP のブラックリスト監視を設定する」「AI スコアリングでキャッチオールアドレスを認証する」）

ユーザーの依頼に必要なコンテキストがすでにほとんど含まれている場合は、該当する手順に直接進みます。 妥当な前提を明示したうえで、最善を尽くした回答から始め、最後に最も重要な確認事項を 1～2 個だけ質問します。必要な情報がすべて揃うまで回答を保留しないでください。

Step 2 — 適切なスキルに振り分けるか、直接回答する

依頼が専門スキルに該当する場合は、次のように振り分けます。

• 配信到達性の一般的な戦略（SPF／DKIM／DMARC、ウォームアップの計画、受信トレイへの配信戦略）→ /sales-deliverability
• ツール間のデータエンリッチメント戦略（ウォーターフォール型エンリッチメント、CRM の衛生管理）→ /sales-enrich
• 見込み客リストの作成／ICP の定義 → /sales-prospect-list
• Zapier／webhook を使った汎用的なツール連携 → /sales-integration

それ以外の場合は、以下のリファレンスにあるプラットフォームの知識をもとに、直接回答します。

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

モジュールの詳細なドキュメント、料金、連携、データモデルについては、references/platform-guide.md を読みます。

プラットフォームガイドの詳細は不要です。ユーザー固有の状況に集中してください。

Step 4 — 実行可能なガイダンス

ユーザーの具体的な質問に応じて、手順を追って説明します。

一括リストの検証ワークフロー

1. リストを準備する：連絡先を、1行につき1つのメールアドレスを含むCSVとしてエクスポートします。クレジットを節約するため、重複を削除してください。
2. アップロードする：ZeroBounceにログインし、「Bulk Email Validator」からCSVファイルをアップロードします。または、API経由で POST /v2/sendfile を使用します。
3. 処理を待つ：ZeroBounceはリストを非同期で処理します。ダッシュボードまたは GET /v2/filestatus でステータスを確認してください。
4. 結果を確認する：ダッシュボードまたは GET /v2/getfile から結果をダウンロードします。ステータス（Valid、Invalid、Catch-All、Spam Trap、Abuse、Disposable、Unknown、Do Not Mail）別の内訳を確認してください。
5. キャッチオールアドレスに対処する：キャッチオールの結果に対してAI Scoringを実行します。含めるスコアのしきい値を設定してください（7以上を推奨）。
6. クリーンなリストをダウンロードする：キャンペーン用に、Validのメールアドレス（およびスコアの高いキャッチオール）をエクスポートします。
7. キャンペーンツールにインポートする：クリーンなリストをESP、CRM、またはキャンペーンプラットフォームにアップロードします。
8. 定期的に再検証する：3か月ごと、または大規模なキャンペーンの前に再検証します。

リアルタイムAPI検証の設定

1. APIキーを取得する：ZeroBounceにログインし、「API settings」からAPIキーをコピーします。
2. リージョンを選択する：デフォルト（api.zerobounce.net）、US（api-us.zerobounce.net）、またはEU（api-eu.zerobounce.net）を選択します。
3. 統合する：単一のメールアドレスを検証するには GET /v2/validate?api_key=YOUR_KEY&[email protected] を呼び出し、一度に最大200件を検証するには POST /v2/validatebatch を呼び出します。
4. レスポンスを処理する：status フィールドを確認し、Validのメールアドレスをシステムに渡し、Invalid／Spam Trap／Abuse／Disposableを拒否し、Catch-AllにはAI Scoringの対象としてフラグを付けます。
5. SDKを使用する：ZeroBounceは13種類の公式SDKを提供しています。HTTPを直接呼び出すのではなく、使用する言語に対応したSDKを利用してください。
6. 使用状況を監視する：GET /v2/getcredits でクレジットを、GET /v2/getusage で使用状況を確認します。

ブラックリスト監視の設定

1. IPとドメインを追加する：ZeroBounceの「Blacklist Monitor」から、送信に使用するすべてのIP（IPv4とIPv6）とドメインを追加します。
2. アラートを設定する：ブラックリストへの登録を知らせるメール通知またはWebhook通知を設定します。
3. 初回スキャンを確認する：ZeroBounceが初回チェックを実行します。既存のブラックリスト登録があれば確認してください。
4. アラートに対処する：ブラックリスト登録のアラートを受け取ったら、ブラックリストのプロバイダーを特定し、登録解除の手順を確認して、登録解除を申請します。最近の送信アクティビティと照合して原因を特定してください。
5. 継続的に監視する：ダッシュボードを定期的に確認してください。自動的に期限切れになるブラックリストもあれば、手動での登録解除が必要なものもあります。

DMARC監視の設定

1. ドメインを追加する：ZeroBounceの「DMARC Monitor」から、メールの送信に使用するすべてのドメインを追加します。
2. DMARCレコードを公開する：DMARCレコードがまだない場合は、v=DMARC1; p=none; rua=mailto:[email protected] から始めます。ZeroBounceが公開用の正しいレコードを提示します。
3. レポートを監視する：ダッシュボードでDMARCの集計レポートを確認し、許可された送信元をすべて特定します。
4. ポリシーを段階的に強化する：正規の送信元をすべて特定したら、数週間から数か月かけてp=none → p=quarantine → p=rejectの順に移行します。
5. 不審なアクティビティに注意する：許可されていない送信元がドメインを偽装しているというアラートには対処してください。

メールウォームアップのワークフロー

1. メールアカウントを接続する：ZeroBounceの「Email Warmup」から、ウォームアップするGmailまたはOutlookのアカウントを接続します。
2. 設定を構成する：1日の送信数の目標と、送信量を段階的に増やすスケジュールを設定します。
3. ウォームアップを開始する：ZeroBounceが、送信、開封、返信、迷惑メールからの救済を含むエンゲージメントを自動で開始します。
4. 進捗を監視する：ダッシュボードでウォームアップの指標（配信率、受信トレイへの配置率）を確認します。
5. 受信トレイ配置テストを実行する：2～3週間後に配置テストを実行し、レピュテーションが改善したことを確認します。
6. キャンペーンに移行する：ウォームアップの指標が安定したら、少量から実際のキャンペーンの送信を開始し、徐々に増やします。

注意点

調査に基づくベストエフォートの内容です。特に、変更されている可能性のある料金、クレジットコスト、API の動作に関する項目は確認してください。

• キャッチオールを有効または無効と決めつけないでください。 キャッチオールドメインは SMTP レベルですべてのメールを受け付けるため、ZeroBounce では標準の検証だけで個々のメールボックスが存在するか確認できません。無条件に含めるとバウンスのリスクがあり、無条件に除外すると有効な見込み客を失う可能性があります。AI Scoring を使ってキャッチオールアドレスを個別に評価してください。この機能はそのために設計されています。

• Email Finder のクレジットコストを軽視しないでください。 1 件の検索成功につき 20 クレジットかかるため、500 件の検索では最大 10,000 クレジットが必要になる場合があります。これはメールアドレス 10,000 件の検証に相当します。Email Finder の利用分は、検証クレジットとは別に予算を確保してください。大量のメールアドレスを見つける必要がある場合は、1 件あたりの検索コストを専用のメール検索ツールと比較してください。

• 地域別 API エンドポイントを忘れないでください。 ZeroBounce は、デフォルトに加えて米国と EU の地域別エンドポイントを提供しています。データの所在地に関する要件（GDPR）がある場合は、EU エンドポイント（api-eu.zerobounce.net）を使用してください。レイテンシが重要な場合は、インフラに最も近い地域別エンドポイントを使用してください。デフォルトのエンドポイントは世界中で利用できますが、コンプライアンス要件を満たさない場合があります。

• 実際のレート制限を把握してください。これは 1 時間あたりの上限ではなく、バーストウィンドウです。 ZeroBounce の検証は 10 秒あたり 80,000 リクエスト（ZeroBounce ONE™ の顧客は 100,000 リクエスト）に制限されています。これを超えても発生するのは 1 分間の一時的なブロックのみです。厳格な上限は無効な API キーによるリクエストで、1 時間あたり 200 件を超えると 1 時間ブロックされます。大規模なリストには、単一メールアドレスのエンドポイントへ大量のリクエストを送るのではなく、一括アップロード（POST /v2/sendfile、非同期）またはバッチ検証（POST /v2/validatebatch、1 回あたり最大 200 件）を優先してください。

• 同じアカウントでウォームアップとキャンペーンを同時に行わないでください。 メールウォームアップでは、制御されたエンゲージメントパターンを通じてレピュテーションを高めます。ウォームアップ中に実際のキャンペーンを送信すると、こうしたパターンが乱れ、効果が得られないどころか悪影響が出る可能性があります。まずウォームアップを完了して（2〜4 週間）、その後、徐々に通常の送信へ移行してください。

• 自己改善：ここに記載されていない情報を見つけた場合は、今日の日付を添えて references/learnings.md に追記してください。

ステップ 5 — 関連スキル

• /sales-deliverability — ツールを横断したメール到達性の戦略（SPF/DKIM/DMARC、ウォームアップ計画、受信トレイへの配置、バウンス管理）
• /sales-enrich — ツールを横断したデータエンリッチメント戦略（ウォーターフォールエンリッチメント、CRM の整理、クレジットの最適化）
• /sales-prospect-list — ICP の定義とセグメンテーションによる、ターゲットを絞った見込み客リストの作成
• /sales-integration — Zapier または直接連携を通じた、ZeroBounce と CRM やその他のツールとの接続
• /sales-do — どのスキルを使えばよいかわからない場合に使用します。ルーターがあらゆる営業目的に適したスキルを選択します。インストール：npx skills add sales-skills/sales --skill sales-do

例

例 1：HubSpot のキャンペーン前にメールリストを整理する

ユーザーの発言：「HubSpot に 50,000 件の連絡先があり、製品ローンチのメールを送る前に確認したいです。」 スキルの動作：

1. HubSpot の連絡先リストを CSV としてエクスポートするよう提案します
2. ZeroBounce にアップロードして一括検証する手順を案内します（必要なクレジットは 50,000）
3. 結果の解釈方法を説明します。無効、スパムトラップ、不正利用、使い捨て、「メール送信禁止」を除外します
4. キャッチオールの結果に AI Scoring を実行するよう提案します（含める基準を 7 以上に設定）
5. 手動でのエクスポート／インポートに代わる方法として、HubSpot のネイティブ連携を紹介します 結果：無効でリスクのあるアドレスを除外し、キャッチオールアドレスをスコアリングしてフィルタリングした、整理済みの検証済みリストが HubSpot に再インポートされます

例 2：送信インフラのブラックリスト監視を設定する

ユーザーの発言：「3 つの IP と 2 つのドメインからメールを送信しています。ブラックリストに登録されたらすぐに知りたいです。」 スキルの動作：

1. 3 つすべての IP（IPv4 および／または IPv6）と 2 つのドメインを Blacklist Monitor に追加する手順を案内します
2. すぐに通知を受け取れるよう、メールと webhook のアラートを設定します
3. 対象となる 200 以上のブラックリストプロバイダーと、自動的に期限切れになるリストと手動で登録解除するリストの違いを説明します
4. ドメイン認証を包括的に監視するため、DMARC Monitor と組み合わせることを推奨します
5. ブラックリストへの登録が見つかった場合、原因を特定するため、最近の送信状況と照合するよう案内します 結果：すべての送信 IP とドメインを対象に、200 以上のプロバイダーを 24 時間 365 日監視し、登録時にすぐアラートを受け取れます

例 3：API を使って登録時にメールアドレスをリアルタイムで検証する

ユーザーの発言：「偽のメールアドレスがデータベースに登録されないよう、登録フォームにメールアドレスの検証を追加したいです。」 スキルの動作：

1. フォーム送信にはリアルタイム検証エンドポイント GET /v2/validate または一括処理エンドポイントを推奨します
2. api_key パラメーターを使った認証の設定方法を示します
3. フォーム側で Invalid、Disposable、Spam Trap、Abuse のステータスをブロックするよう案内します
4. レイテンシを最小限に抑えるため、ユーザーのインフラに最も近いリージョンの API エンドポイントを推奨します
5. 生の HTTP リクエストではなく、ユーザーのバックエンド言語に対応する SDK（13 種類を提供）を提案します
6. 想定される登録数に基づいてクレジット使用量を算出します 結果：フォームでリアルタイム検証を行い、無効、一時利用、リスクのあるメールアドレスがデータベースに登録されるのを防止できます

トラブルシューティング

Catch-All の結果が多い

症状：リストの大部分が Catch-All と判定され、リストの品質を判断しにくくなっています。 原因：多くの企業ドメインでは、すべてのアドレスを受け付けるキャッチオールメールサーバーが設定されています。標準的な検証では、これらのドメインにおける個々のメールボックスの存在を確認できません。 解決策：すべての Catch-All 結果に AI Scoring を実行します。キャンペーンに含めるスコアのしきい値を設定します（7 以上を推奨）。スコア付けしたアドレスのバウンス率を監視し、時間の経過とともにしきい値を調整します。リストの大部分がキャッチオールの場合、大企業に偏っている可能性があります。これは通常の状態です。

一括検証ジョブが停止、または時間がかかる

症状：一括検証用の CSV をアップロードしましたが、ジョブのステータスが長時間「processing」のままです。 原因：大規模なリストは処理に時間がかかります。アップロード中のネットワークの問題により、ファイル転送が不完全になることがあります。CSV の形式が正しくない場合も、処理が遅くなることがあります。 解決策：ダッシュボードまたは GET /v2/filestatus でジョブのステータスを確認します。大規模なリスト（100K 以上）の処理には数時間かかることがありますが、これは通常の状態です。24 時間以上停止している場合は、GET /v2/deletefile でファイルを削除して再アップロードします。CSV は正しい形式にし、1 行につきメールアドレスを 1 つ記載し、メールアドレスの列に特殊文字を含めないようにしてください。

API が多くのメールアドレスに対して「Unknown」ステータスを返す

症状：リアルタイム検証で、かなりの割合のメールアドレスに「Unknown」ステータスが返されます。 原因：受信側のメールサーバーがタイムアウトしたか、曖昧な応答を返しました。受信側サーバーによるグレイリスティングが、一時的に Unknown の結果を引き起こすことがあります。ZeroBounce と受信側サーバー間のネットワークに問題が発生している可能性もあります。 解決策：Unknown のメールアドレスは数時間後に再試行します。グレイリスティングは通常、再試行によって解消されます。特定のドメインで Unknown の割合が高い状態が続く場合、そのドメインのメールサーバーが検証の試行を積極的にブロックしている可能性があります。Unknown を Valid として扱わないでください。キャンペーンから除外するか、送信前に再試行します。