sales-mailshake

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

キャンペーンの設定や Lead Catcher から、受信者の管理、到達性の設定、API、連携まで、Mailshake プラットフォームに関する質問に対応します。

ステップ 1 — 背景情報を確認する

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

ユーザーに質問します。

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

   • A) キャンペーン — メールキャンペーンの作成、管理、最適化（戦略については、こちらに引き継ぎます：/sales-cadence {your question}）
   • B) 受信者 — インポート、管理、CSV の書式設定
   • C) Lead Catcher — 返信からのリードの獲得と管理
   • D) 到達性 — 送信者設定、ウォームアップ、ドメイン認証（複数プラットフォームにまたがる内容は、こちらに引き継ぎます：/sales-deliverability {your question}）
   • E) 分析 — キャンペーンのパフォーマンス、開封率／返信率／クリック率
   • F) Webhook と API — 自動化、イベントのプッシュ、API アクセス
   • G) 送信者とチーム — 接続済みアカウント、チーム管理
   • H) 連携 — Salesforce、HubSpot、Pipedrive、Zapier、Slack
   • I) 管理 — 請求、プランの機能、アカウント設定
   • J) その他 — 内容を説明してください

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

   • A) 営業担当者／AE／BDR
   • B) 営業マネージャー／チームリーダー
   • C) RevOps／Sales Ops
   • D) 管理者／IT
   • E) 創業者／単独の営業担当者
   • F) その他

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

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

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

ステップ 2 — 適切なスキルに案内するか、直接回答する

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

• リスト作成／見込み客の開拓 → /sales-prospect-list
• 連絡先のエンリッチメント／データのクレンジング → /sales-enrich
• ケイデンス戦略／シーケンス設計 → /sales-cadence
• 複数プラットフォームにまたがる到達性 → /sales-deliverability
• ツール連携アーキテクチャ → /sales-integration

それ以外の場合は、以下の参考情報を使用して、プラットフォームの知識に基づき直接回答します。

ステップ 3 — Mailshake プラットフォームの参考情報

ユーザーの分野に応じて、モジュールごとに案内します。

キャンペーン

• 概要：Mailshake のキャンペーンは複数ステップのメールシーケンスです。最初のメッセージと、スケジュールに沿って自動送信されるフォローアップで構成されます。
• 主な概念：キャンペーン＝シーケンス、メッセージ＝ステップ、フォローアップの種類（時間ベースのドリップ、返信ベース、クリック時のメッセージ）
• キャンペーンのステータス：draft、active、paused、ended
• A/B テスト：上位プランで利用可能です。バリエーションごとに件名と本文をテストできます。
• ベストプラクティス：最初のメールは125語未満にし、差し込みフィールド（{{first}}、{{company}}）でパーソナライズし、一度に1つの変数をテストします。

受信者

• 概要：キャンペーンに登録された連絡先です。CSV、API、または手動入力でインポートします。
• 必須フィールド：必須なのは emailAddress のみです。それ以外はすべて任意ですが、設定をおすすめします。
• 推奨フィールド：first、last、company、title。これらは差し込みフィールド {{first}}、{{last}}、{{company}}、{{title}} に対応します。
• カスタム差し込みフィールド：CSV の追加列はすべて、自動的にカスタム差し込みフィールドになります。
• 受信者のステータス：active、paused、bounced、unsubscribed、completed
• CSV インポートのヒント：UTF-8 エンコーディングを使用し、1行目をヘッダーにして、1行につきメールアドレスを1件記載します。インポート前にメールアドレスを確認してください（Mailshake はアップロード時にメールアドレスを確認しません）。

リードキャッチャー

• 概要：返信をリードとして自動的に取り込み、フォローアップできる組み込みのリード管理機能です。
• リードのステータス：open（対応が必要）、won/closed（成約）、ignored（リードではない）、lost（失注）
• 主な機能：チームメンバーへのリードの自動割り当て、ステータス／キャンペーン／担当者による絞り込み、会話スレッド全体の表示
• リードキャッチャーとCRMの違い：リードキャッチャーではメールの会話スレッドを管理し、CRMでは取引を管理します。連携またはAPIを使って、有望なリードをCRMに送信できます。
• ベストプラクティス：リードキャッチャーを毎日確認し、コンバージョン率を高めるために1時間以内に返信し、ステータスラベルを一貫して使用します。

配信の基本

• 送信者アカウント：Gmail、Outlook/O365、またはSMTPを接続します。送信者ごとに1日の送信上限があります。
• 送信上限：プランとメールプロバイダーによって異なります。Gmailの上限は約400～500通／日、O365の上限は約1,000通／日です。Mailshakeでは、プロバイダーの上限に加えてプランごとの上限も適用されます。
• ドメイン認証：送信ドメインにSPF/DKIM/DMARCを設定します。リンクの追跡にはカスタムトラッキングドメインを使用します。
• ウォームアップ：新しいメールボックスでは、1日あたり20～30通から始め、週ごとに10～20通ずつ増やします。ウォームアップの詳細なフレームワークについては、/sales-deliverabilityを参照してください。
• 送信者のローテーション：複数の送信者アカウントに送信を分散し、評価を保護します。

アナリティクス

• 組み込みダッシュボード：キャンペーン単位およびアカウント単位のパフォーマンス指標を確認できます。
• 主な指標：送信数、開封数、クリック数、返信数、バウンス数、配信停止数、リードキャッチャーのリード数
• チーム分析：チームメンバーやキャンペーン間のパフォーマンスを比較できます。
• ベストプラクティス：バウンス率を毎週監視し（目標は3%未満）、開封数だけでなく好意的な返信率も追跡します。

送信者とチーム

• 送信者：送信に使用する、接続済みのメールアカウントです。それぞれに1日の上限と評価があります。
• チーム：メンバーにはキャンペーンやリードを割り当てられます。アクセス権はロールによって制御されます。
• 送信者の管理：設定 > 送信者で、接続、差出人名の設定、1日の上限の設定を行います。

Mailshakeのデータモデル

主要なエンティティ — UIの操作やAPIの利用にあたって、これらを理解しておきましょう。

エンティティ	表すもの	主な関係
キャンペーン	複数ステップのメールシーケンス	メッセージ（ステップ）と受信者を持つ
受信者	キャンペーンに登録された連絡先	キャンペーンに属し、アクティビティを持つ
リード	リードキャッチャーが取り込んだ返信	キャンペーンに属し、受信者にリンクされる
メッセージ	キャンペーン内のステップ（初回またはフォローアップ）	キャンペーンに属する
送信者	接続済みのメールアカウント	キャンペーンで使用される
チームメンバー	アカウントのユーザー	キャンペーンとリードを担当できる

APIと連携

すべてのエンドポイント、認証、レート制限、Webhookイベントのペイロードを含む詳細なAPIドキュメントについては、必ずreferences/mailshake-api-reference.mdを参照してください。 エンドポイントの全一覧、リクエスト／レスポンスのスキーマ、レート制限の詳細については、このファイルを案内してください。APIに関する質問には、必ずこのリファレンスファイルを参照するよう案内してください。

クイックリファレンス：ベースURLはhttps://api.mailshake.com/2017-04-01です。認証には、apiKeyパラメーター（クエリ／ボディ）によるAPIキー、またはAuthorization: Basic <base64 apiKey>ヘッダーを使用します。サードパーティアプリではOAuth 2.0を使用します。レート制限は、時間あたりのクォータユニットモデル（操作ごとのコストをプラン／シート数に応じて調整）と、これとは別の月間受信者追加上限を使用します。一定のリクエスト数／分という制限ではありません。主な機能：キャンペーンのCRUD、受信者管理、アクティビティ追跡、リードキャッチャー管理、プッシュWebhook（resource_urlが送信されるため、これを取得します。HMAC署名はありません）。

ネイティブ連携

• CRM：Salesforce（リードの送信、アクティビティの同期）、HubSpot（リードの送信、アクティビティの同期）、Pipedrive（リードの送信）
• 自動化：Zapier（開封、クリック、返信、新しいリードをトリガーとして使用、受信者の追加をアクションとして実行）
• コミュニケーション：Slack（返信やリードの通知）
• エンリッチメント：Voila Norbert、Hunter（インポート前のメールアドレス検証）

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

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

1. 手順 — Mailshake で目標を達成するための番号付き手順
2. 設定の推奨事項 — 変更する具体的な設定と、画面上の移動経路
3. よくある落とし穴 — 起こり得る問題とその回避方法
4. 確認方法 — 変更が機能したことを確認する方法
5. API に関する質問の場合 — 必ず次の案内を含めます。「エンドポイントの全一覧、リクエスト／レスポンスのスキーマ、レート制限については、references/mailshake-api-reference.md をご覧ください。」

注意点

• Lead Catcher を CRM と混同しないでください。 Lead Catcher はメールの返信を取り込み、追跡する機能です。案件のパイプラインではなく、トリアージ用のツールです。適格なリードは、パイプライン管理のために Salesforce／HubSpot に送る必要があります。Claude は Lead Catcher を CRM の完全な代替として扱いがちです。

• Mailshake について説明する際に「シーケンス」を使わないでください。 Mailshake では「キャンペーン」と呼びます。「シーケンス」（Apollo／Salesloft の用語）を使うと、ユーザーと UI を混乱させます。Mailshake では常に「キャンペーン」と呼んでください。

• 配信設定が済んでいると決めつけないでください。 新しい Mailshake アカウントでは、SPF／DKIM／DMARC、カスタムトラッキングドメイン、ウォームアップ計画が設定されていないことがよくあります。送信の問題をトラブルシューティングする前に、必ずドメイン認証の状態を確認してください。

• 上位プランでのみ利用できる機能を、確認せずに推奨しないでください。 A/B テスト、チーム分析、一部の連携機能はプランによって利用が制限されます。これらの機能を推奨する前に、ユーザーのプランを確認してください。

• Mailshake のレート制限が単純な「1 分あたりのリクエスト数」だと決めつけないでください。 Mailshake では時間あたりのクォータユニット方式を採用しています。操作ごとに消費ユニット数は異なります（例：recipients/add は 20 + N、push/create は 100、activity/sent は 1）。また、API 経由で追加できる受信者数には月間の別枠上限があります。いずれかの制限を超えると、limit_reached／exceeds_monthly_recipients エラーが返されます。制限はプランとユーザーシート数に応じて変わります。一括操作はバッチに分け、間隔を空けて実行する必要があります。Claude はクォータユニットを考慮せず、短い間隔で処理を繰り返すコードを生成しがちです。

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

ステップ 5 — 関連スキル

• /sales-cadence — アウトバウンドのケイデンス戦略を設計します（プラットフォームに依存せず、Mailshake のキャンペーンにも対応）
• /sales-deliverability — プラットフォーム横断のメール配信到達性 — SPF／DKIM／DMARC、ウォームアップ、受信トレイへの到達
• /sales-prospect-list — Mailshake にインポートする見込み客リストを作成します
• /sales-enrich — インポート前にメールアドレス／電話番号で連絡先情報を補完します
• /sales-integration — Webhook、Zapier、API を使って Mailshake を他のツールに接続します
• /sales-apollo — Apollo.io プラットフォームのヘルプ（Mailshake の代わりに Apollo を使う場合）
• /sales-salesloft — Salesloft プラットフォームのヘルプ（Mailshake の代わりに Salesloft を使う場合）
• /sales-do — どのスキルを使えばよいかわからない場合に、あらゆる営業目標に適したスキルへ振り分けます。

例

例 1：Lead Catcher のセットアップ

ユーザーの発言：「Mailshake で Lead Catcher を設定するにはどうすればよいですか？」 スキルの対応：

1. Lead Catcher の目的を説明します — キャンペーンへの返信からリードを自動で取り込みます
2. Lead Catcher を有効にし、自動割り当てルールを設定する手順を案内します
3. リードのステータス（open、won/closed、ignored、lost）と、それぞれを使うタイミングを説明します
4. Lead Catcher と CRM のパイプライン管理の違いを明確にします 結果：ユーザーは Lead Catcher を有効にして割り当てルールを設定し、リードをトリアージする方法を理解できます

例 2：API を使った受信者のインポート

ユーザーの発言：「Mailshake API を使って、キャンペーンに受信者を 500 人追加したいです」 スキルの動作：

1. API の全ドキュメントとして references/mailshake-api-reference.md を案内します
2. /recipients/add エンドポイントについて説明します。emailAddress は必須で、差し込み変数用のフィールド（addresses、listOfEmails、または csvData を受け付けます。キャンペーンごとに最大 5,000 件）があります
3. 1 時間あたりのクォータユニット上限（/recipients/add は 20 + N ユニットを消費）と、別途設定されている月間の受信者追加上限について警告し、バッチ処理とペース配分を推奨します
4. /recipients/addStatus を使ってインポート状況を確認する方法を示します 結果：ユーザーは、クォータユニット上限と月間の受信者数上限の範囲内で、大規模なインポートをバッチ処理するためのエンドポイント、必須フィールド、方法を把握できます

トラブルシューティング

開封率が低い

症状：キャンペーンの開封率が 30% を下回っています 原因：ドメイン認証の未設定、送信者の評価の低さ、または件名の訴求力不足です 解決策：DNS で SPF／DKIM／DMARC を確認します。カスタムトラッキングドメインを設定します。送信者の評価を確認します。件名の A/B テストを実施します。診断の全体的なフレームワークについては、/sales-deliverability を参照してください。

メールがバウンスする

症状：バウンス率が 3% を超えています 原因：メールリストが未検証、またはデータが古い状態です 解決策：検証ツール（NeverBounce、ZeroBounce）を使って、インポート前にメールアドレスを検証します。ハードバウンスはすぐに削除します。Mailshake はアップロード時に検証を行いません。検証はユーザーの責任です。

Lead Catcher で返信を捕捉できない

症状：返信が届いているのに、Lead Catcher に表示されません 原因：キャンペーンで Lead Catcher が有効になっていないか、返信が不在通知またはバウンスとして検出されています 解決策：キャンペーン設定を確認します。Lead Catcher はキャンペーンごとに有効にする必要があります。自動返信と不在通知は、デフォルトで除外されます。Activity > Replies タブで、返信を受信したことを確認します。