sales-tomba

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

ドメイン検索やメールアドレスの検索から、検証、情報の補完、一括操作、API、連携まで、Tomba.io プラットフォームに関する質問に対応します。

ステップ 1 — コンテキストを把握する

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

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

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

   • A) ドメイン検索 — 企業のメールアドレスをすべて検索する
   • B) メールファインダー — 特定の人物のメールアドレスを検索する
   • C) メール認証 — メールアドレスを検証する
   • D) メール情報の補完 — 連絡先に企業やソーシャルメディアの情報を追加する
   • E) 著者ファインダー — ブログ著者のメールアドレスを検索する
   • F) LinkedIn ファインダー — LinkedIn プロフィールからメールアドレスを検索する
   • G) 電話番号ファインダー — 電話番号を検索する
   • H) 一括操作 — 数千件のレコードを一度に処理する
   • I) リードとリスト — 保存した連絡先やリストを管理する
   • J) ブラウザー拡張機能 — Chrome／Edge／Safari／Firefox 拡張機能
   • K) Google Sheets／Excel — アドオンまたはアドイン
   • L) API — プログラムからのアクセス、自動化、カスタム連携
   • M) 連携 — Zapier、HubSpot、Salesforce、Pipedrive、Make、n8n
   • N) アカウントと請求 — プラン、クレジット、チームメンバー
   • O) その他 — 内容を説明してください

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

   • A) 営業担当者／AE／BDR
   • B) 営業マネージャー／チームリーダー
   • C) RevOps／Sales Ops
   • D) リクルーター
   • E) マーケティング担当者
   • F) 創業者／個人営業担当者
   • G) 開発者／エンジニア
   • H) その他

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

ユーザーの依頼にこうしたコンテキストのほとんどがすでに含まれている場合は、該当するステップに直接進んでください。 妥当な前提を明示したうえで、可能な範囲で最善の回答を最初に提示し、最後に重要度の高い確認事項だけを 1～2 件尋ねます。すべての情報が揃うまで回答を保留しないでください。

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

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

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

• 複数のツールをまたぐ情報補完戦略 → /sales-enrich
• 見込み顧客リストの作成／ICP の定義 → /sales-prospect-list
• メール到達性／SPF/DKIM/DMARC → /sales-deliverability
• 購買シグナルと優先順位付け → /sales-intent
• Zapier／webhook によるツールの接続 → /sales-integration

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

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

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

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

ステップ 4 — 実行可能なガイダンス

ユーザーの具体的な質問に基づき、次の内容を提示します。

1. 手順 — 正確な UI の操作経路または API 呼び出し
2. 設定の推奨事項 — 具体的な値（例：「ページネーションを高速化するには、limit を 50 に設定します」）
3. よくある落とし穴 — 該当するワークフローで注意すべき点
4. 検証手順 — 正しく動作していることを確認する方法

一般的なワークフロー

対象企業の連絡先をすべて見つける：

1. 企業のドメインを指定して Domain Search を実行 → 判明しているメールアドレスをすべて取得
2. 部門（営業、エンジニアリング）と役職レベル（ディレクター以上）で絞り込む
3. 連絡する予定のメールアドレスを検証する
4. リードリストに保存 → CRM またはキャンペーンツールにエクスポート

特定の人物のメールアドレスを見つける：

1. 名前と企業ドメインを指定して Email Finder を実行 → メールアドレスと信頼度スコアを取得
2. 信頼度が80%未満の場合は、ドメインの Email Format を確認してパターンを検証する
3. 送信前に Email Verifier でメールアドレスを検証する
4. 連絡先をエンリッチして、役職やソーシャルプロフィールなどの追加情報を取得する

キャンペーン前に既存リストを整理する：

1. すべてのメールアドレスを一括検証 → valid、invalid、accept_all に分類
2. 無効なメールアドレスはすぐに削除する
3. accept_all は含めますが、バウンス率を注意深く監視する
4. 不足している項目（名前、役職）をエンリッチしてパーソナライズに活用する
5. 整理・エンリッチ済みのリストをキャンペーンツールにエクスポートする

競合他社のテックスタックを監視する：

1. Technology エンドポイント → 企業が使用しているツールを確認する
2. Similar Domains → 競合企業や関連企業を見つける
3. Domain Search と組み合わせて、適切な連絡先を見つける
4. テクノグラフィック情報に基づくアウトリーチに活用する → /sales-intent を参照

注意点

調査に基づくベストエフォートの内容です。特に、プランによる機能制限や、古くなっている可能性がある連携上の注意点を確認してください。

• メールアドレスを見つけた後の検証を省略しないでください。 Email Finder はパターンマッチングに基づいて推定メールアドレスを返しますが、配信が保証されるわけではありません。見つかったメールアドレスは、キャンペーンに追加する前に必ず Email Verifier で検証してください。未検証のメールアドレスに送信すると、送信者の評価が損なわれます。

• Email Format エンドポイントを見落とさないでください。 個別のメールアドレスを検索する前に、まずドメインのメール形式を確認してください（/v1/email-format）。企業が [email protected] を使用していると分かれば（85%の一致率）、結果をより速く検証し、信頼度の低い推測を省けます。

• 絞り込まずにドメイン検索を行ってクレジットを無駄にしないでください。 大企業のドメイン検索では、数千件の結果が返されることがあります。部門、役職レベル、国のフィルターを使って、実際に連絡する意思決定者に絞り込んでください。検索ごとに、結果をいくつ利用するかに関係なくクレジットが消費されます。

• 一括ジョブの webhook コールバックを忘れないでください。 一括処理は非同期です。API はすぐに応答しますが、バックグラウンドで処理が続きます。ポーリングする代わりに、webhook_url パラメーターを使って完了時に通知を受け取ってください。ポーリングは API 呼び出しを無駄にし、レート制限に達する可能性があります。

• すべてのプランに同じ機能が含まれると思い込まないでください。 プランによって月間クレジットの上限が異なります。現在はクレジットベースの料金体系です（1,000クレジットあたり約$8.90、検証は無料でバンドル）。Domain Search の全結果のダウンロードはプランによって制限される場合があります。注：webhook／webhook_url のサポートは、現在の公式ドキュメント（docs.tomba.io）には記載されていません。Pro プランの制限だと思い込まず、webhook に依存するワークフローを構築する前に Tomba に直接確認してください。エンドポイントごとのレート制限（例：Domain Search は15回/秒、LinkedIn は1.67回/秒）に注意し、429応答では X-RateLimit-Reset を遵守してください。

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

ステップ5 — 関連スキル

• /sales-enrich — ツールを横断したエンリッチメント戦略（ウォーターフォール型エンリッチメント、CRM のデータ品質管理、クレジットの最適化）
• /sales-prospect-list — ICP の定義とセグメンテーションに基づいて、対象を絞った見込み客リストを作成する
• /sales-deliverability — メール配信のセットアップ（SPF/DKIM/DMARC、ウォームアップ、受信トレイへの到達率）
• /sales-intent — 購買シグナルを解釈してアカウントの優先順位を付ける（Tomba のテクノロジー検出をシグナルとして活用）
• /sales-integration — Zapier、Make、または API を使って Tomba を CRM やその他のツールに接続する
• /sales-cadence — Tomba で見つけた連絡先に向けたアウトバウンドシーケンスを設計する
• /sales-do — どのスキルを使えばよいか分からない場合は、このルーターが営業目標に合ったスキルを選びます。インストール：npx skills add sales-skills/sales --skill sales-do

例

例 1：特定の企業のメールアドレスを検索する

ユーザーの発言：「Tomba を使って、Stripe の営業責任者全員を見つけたいです」 スキルの内容：

1. stripe.com を対象に、department=sales、seniority=executive,senior を指定して Domain Search を推奨します
2. 結果の絞り込み方法と信頼度スコアの解釈方法を説明します
3. アウトリーチの前にメールアドレスを検証することを推奨します
4. 結果を見込み客リストに保存し、キャンペーンツールにエクスポートする方法を提案します 結果：アウトリーチにすぐ使える、Stripe の営業責任者を絞り込んで検証したリスト

例 2：キャンペーン前にメールアドレスを一括検証する

ユーザーの発言：「3,000 件の連絡先を含む CSV があり、Lemlist のキャンペーンを開始する前に、すべてのメールアドレスを検証する必要があります」 スキルの内容：

1. CSV の形式やアップロード手順など、一括検証の設定方法を順を追って説明します
2. 非同期処理の完了通知に webhook コールバックを使うことを推奨します
3. 結果（valid、invalid、accept_all、unknown）の解釈方法を説明します
4. 無効なメールアドレスの削除と、監視対象としての accept_all のフラグ付けを勧めます
5. クリーンなリストを Lemlist にインポートする方法として /sales-lemlist を案内します 結果：ステータスごとの対応が明確で、キャンペーンにインポートできる検証済みの連絡先リスト

例 3：Tomba API を使って自動でデータを補完する

ユーザーの発言：「Zapier を通じて、新しい HubSpot の連絡先に Tomba のデータを自動で追加したいです」 スキルの内容：

1. Zapier のワークフローを説明します：HubSpot の「新しい連絡先」トリガー → Tomba の「データ補完」アクション → HubSpot の「連絡先を更新」アクション
2. Tomban のデータ補完から HubSpot のプロパティへのフィールドマッピングを説明します
3. クレジットの消費について注意を促し、ICP に一致する連絡先のみを対象に絞り込むことを推奨します
4. 高度な複数ツールのワークフローについて /sales-integration を案内します 結果：HubSpot → Tomba → HubSpot の自動データ補完パイプライン。クレジット消費を考慮した絞り込みに対応します

トラブルシューティング

Domain Search の一致率が低い

症状：従業員が多いとわかっている企業を検索しても、Domain Search の結果がごくわずかです 原因：Tomba のデータベースでは、特定の企業、特に規模の小さい企業や新しい企業の情報があまり網羅されていない可能性があります 解決策：ドメインではなく企業名で検索してみてください。対象を絞って検索するには、特定の名前（LinkedIn で確認）を指定して Email Finder を使用します。複数のプロバイダーを使ったウォーターフォール型のデータ補完も検討してください。詳しくは /sales-enrich を参照してください。

Email Verifier が「unknown」を返す

症状：検証結果が valid／invalid ではなく「unknown」ステータスになります 原因：メールサーバーから明確な応答がありませんでした。SMTP 検証を制限している一部の企業メールサーバーで発生します 解決策：「unknown」を「valid」として扱わないでください。価値の高い見込み客の場合はリストに含めてもかまいませんが、バウンス率を注意深く監視してください。一括キャンペーンの場合は、送信者の評判を守るため unknown を除外してください。

API のレート制限エラー（429）

症状：API から 429 Too Many Requests の応答が返されます 原因：エンドポイントごとのレート制限（例：Domain Search／Email Finder は 15/sec・900/min、Enrichment は 5/sec、Email Verifier／Author Finder は 2.5/sec、LinkedIn は 1.67/sec・100/min）を超過しています。短時間にリクエストを送りすぎています 解決策：429 が返されたら、X-RateLimit-Reset ヘッダーを確認し（リセットまでの秒数）、その時間だけ待ってから再試行してください。X-RateLimit-Limit／X-RateLimit-Remaining で利用可能な上限を確認できます。代替手段として指数バックオフを使用してください。リクエストをまとめ、一件ずつ呼び出す代わりに一括処理用エンドポイントを使用します。制限に継続して達する場合は、リクエストの頻度を下げるか、プランをアップグレードしてください。