mcpField

sales-transactional-email

github.com/sales-skills開発40 回インストール
リポジトリ

sales-transactional-email について

sales-transactional-emailは、イベント起点のメールを計画またはトラブルシューティングするチーム向けの、特定プロバイダーに依存しないスキルです。複数のメールサービスを対象に、選定、テンプレート、APIやSMTP連携、到達性、監視を支援します。

主な機能

  1. 01トランザクションメールサービスの選定
  2. 02テンプレート設計の案内
  3. 03APIとSMTP連携の助言
  4. 04到達性に関する推奨事項
  5. 05監視とトラブルシューティング

活用シーン

  1. 01領収書メールのサービス選定
  2. 02パスワード再設定メールの連携
  3. 03トランザクションメールの到達性改善
  4. 04バウンスと配信イベントの監視

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/sales-skills/sales --skill sales-transactional-email

インストール後、Claude Code で/sales-transactional-emailを入力して読み込まれたか確認します。

同梱ファイルreferences/learnings.mdreferences/platform-guide.md

詳細

トランザクションメールの配信

プロバイダーの選定やテンプレートの設計から、API 連携、SMTP リレー、到達率の向上、モニタリングまで、トランザクションメール/トリガー送信メールに関するユーザーのニーズに対応します。このスキルは特定のツールに依存しませんが、SendGrid、Postmark、Mailgun、Brevo、Customer.io、Mailchimp/Mandrill、Amazon SES に固有のガイダンスも含まれています。

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

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

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

  1. どのようなトランザクションメールについてサポートが必要ですか?

    • A)注文確認/領収書/発送通知
    • B)パスワードリセット/アカウント確認/2FA
    • C)登録をきっかけに送信するウェルカムメール/オンボーディングシーケンス
    • D)請求/請求書/サブスクリプション通知
    • E)アラート/通知メール(アクティビティ、メンション、リマインダー)
    • F)プロバイダーの選定 — 適切なトランザクションメールサービスの選択
    • G)配信の問題 — メールが届かない、迷惑メールに分類される、遅延する
    • H)API/SMTP 連携 — アプリとプロバイダーの接続
    • I)テンプレートの設計 — 再利用可能なトランザクションメールテンプレートの作成
    • J)モニタリングと分析 — 配信、開封、バウンスの追跡
    • K)その他 — 内容を記述してください
  2. 現在の構成を教えてください。

    • A)まだプロバイダーを利用していない — これから始める
    • B)SendGrid を利用中
    • C)Postmark を利用中
    • D)Mailgun を利用中
    • E)Brevo(Sendinblue)を利用中
    • F)Customer.io を利用中
    • G)Mailchimp / Mandrill を利用中
    • H)Amazon SES を利用中
    • I)別のプロバイダーを利用中
    • J)独自の SMTP サーバーを利用中
  3. メールの送信量はどのくらいですか?

    • A)少量(1 日あたり 1,000 通未満)
    • B)中量(1 日あたり 1,000~50,000 通)
    • C)大量(1 日あたり 50,000~500,000 通)
    • D)非常に大量(1 日あたり 500,000 通以上)

ユーザーの依頼にこれらのコンテキストの大部分がすでに含まれている場合は、該当するステップに直接進んでください。 合理的な前提を明示したうえで、できる限りの回答を最初に提示し、最後に最も重要な確認事項を 1~2 点だけ質問してください。

ステップ 2 — 方針と進め方

トランザクションメールとマーケティングメール

トランザクションメールは、ユーザーの操作またはシステムのイベントをきっかけに送信されます。送信が想定されており、通常は 1 対 1 です。マーケティングへの同意は必要ありません(CAN-SPAM の適用除外)が、実際にトランザクション目的でなければなりません。

トランザクションメールマーケティングメール
注文確認販促キャンペーン
パスワードリセットニュースレター
発送通知製品のお知らせ
アカウント確認再エンゲージメントキャンペーン
請求書/領収書割引/セールのお知らせ

重要な原則:マーケティングメールとトランザクションメールは、異なる IP/ドメインを使って別々の送信基盤で運用してください。これにより、マーケティングメールのレピュテーションの問題がトランザクションメールの配信に影響するのを防げます。

プロバイダー選定のフレームワーク
要素SendGridPostmarkMailgunBrevoCustomer.ioSES
最適な用途大規模運用+マーケティングの併用到達率を最優先開発者の柔軟性を重視オールインワン+マーケティング行動をきっかけとした送信大量送信+低コスト
到達率良好非常に優秀(98.7%)良好良好良好良好(自己管理)
料金体系メール通数ごとメール通数ごとメール通数ごと送信量別プランプロフィールごとメール通数ごと(最安)
無料プラン60 日間のトライアル(1 日 100 通)月 100 通月 1,000 通(トライアル)1 日 300 通なし最初の 12 か月は月 3,000 通
SMTP リレー対応対応対応対応非対応対応
REST API対応対応対応対応対応対応
テンプレート動的(Handlebars)HandlebarsHandlebarsUI ビルダー+APILiquid基本機能
受信メールの解析対応対応対応対応非対応対応
Webhook対応(Event Webhook)対応(7 種類)対応(8 種類のイベント)対応対応SNS 通知
テンプレートのベストプラクティス
  1. シンプルにする — トランザクションメールは派手にせず、分かりやすくします
  2. 重要な情報をファーストビューに配置する — 注文番号、追跡リンク、アクションボタン
  3. 動的パラメーターを使用する — ユーザー固有のデータをハードコードしないでください
  4. 各メールクライアントでテストする — Outlook、Gmail、Apple Mail では表示が異なります
  5. プレーンテキスト版を用意する — 必要とする受信者やクライアントもあります
  6. 一貫したブランド表現にする — ロゴ、色、フッターをそろえつつ、デザインを凝りすぎないようにします
トランザクションメールの到達率
  1. 専用の送信ドメインを使用する — メインドメインではなく、mail.example.com や notify.example.com を使用します
  2. すべて認証する — SPF、DKIM、DMARC(p=quarantine または p=reject)
  3. 専用 IP を使用する — 月間送信量が 50K 件以上なら、専用 IP を取得してウォームアップします
  4. 送信ストリームを分ける — トランザクションメールとマーケティングメールには、異なる IP やサブドメインを使用します
  5. バウンスを監視する — ハードバウンスは直ちに配信対象から除外し、ソフトバウンスの傾向を追跡します
  6. 苦情率を監視する — トランザクションメールの苦情率はほぼ 0% に抑えます

ステップ 3 — プラットフォーム固有のガイダンス

詳細なプロバイダー比較、API リファレンス、連携チェックリスト、主要指標については、references/platform-guide.md をお読みください。

MailerLite の場合

MailerLite では、トランザクションメールはマーケティングキャンペーンとは別の機能として利用できます。

  • API による送信:トランザクションメールはキャンペーンビルダーではなく、MailerLite API 経由で送信します。注文確認、パスワードリセット、配送通知に使用します。
  • インフラの分離:トランザクションメールの送信はマーケティングメールの上限に含まれず、別の配信インフラを使用します。
  • テンプレート:MailerLite ダッシュボードで再利用可能なテンプレートを作成し、API 呼び出しで ID を指定します。
  • 制限事項:MailerLite のトランザクションメール機能は、SendGrid、Postmark、Mailgun と比べると基本的なものです。受信メールの解析や高度な分析機能はなく、トランザクションメール用の専用 IP もありません(Enterprise のみ)。すべてを 1 つのプラットフォームにまとめたい MailerLite ユーザーに最適です。大量送信や低遅延が求められるトランザクションメールには、専用プロバイダーを使用してください。
  • API:連絡先管理には POST /api/subscribers、配信追跡にはウェブフックを使用します。API リファレンスの全文は /sales-mailerlite を参照してください。

プラットフォームガイドの詳細は不要になりました。ユーザー固有の状況に焦点を当ててください。

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

ユーザー固有の質問に基づき、ステップ 2 の戦略フレームワークとリファレンスガイドのプロバイダー情報を参考に、的を絞った推奨事項を提示します。

注意点

  1. トランザクションメールとマーケティングメールを同じ IP/ドメインで混在させない — マーケティングのレピュテーション問題によって、トランザクションメールの配信率が大きく低下します。サブドメインを分け、できれば IP も別にしてください。
  2. 「トランザクション」には法的な定義があります — CAN-SPAM ではトランザクションメールはオプトアウト要件の対象外ですが、メールの主目的がトランザクションでなければなりません。冒頭に 50% 割引クーポンを載せた注文確認メールは、トランザクションメールではなくマーケティングメールです。
  3. SMTP はリアルタイムではありません — SMTP キューによって遅延が発生します。2FA コードやパスワードリセットなど、時間が重要なメールには、より迅速に配信できる REST API を使用してください。
  4. ウェブフックは通知なしに失敗することがあります — ウェブフックのエンドポイントが停止すると、配信イベントやバウンスイベントを受け取れません。ウェブフックのログ記録とアラートを実装してください。
  5. テンプレートの表示はクライアントによって異なります — Outlook は Word のレンダリングエンジンを使用します。特にレイアウトが複雑なデザインは、Litmus または Email on Acid で必ずテストしてください。
  • 自己改善:ここに記載されていない情報を見つけた場合は、今日の日付を添えて references/learnings.md に追記してください。

特定のプラットフォームスキルを推奨する前に

このスキルでは、多数のプラットフォームにまたがる戦略領域を扱います。ユーザーに特定のプラットフォームスキル(## Related skills に記載されている /sales-{platform}。例:/sales-mailshake、/sales-klaviyo、/sales-apollo)を案内する前に、必ずそのプラットフォームスキルの実際の SKILL.md を読んでください。## Related skills にある1行の説明は候補を 特定する には十分ですが、そのスキルを 確定 したり、それを適切に呼び出すプロンプトを作成したりするには不十分です。

読み方:

  • ~/.claude/skills/{skill-name}/SKILL.md がローカルに存在する場合は、Read してください。
  • sales-* スキルの場合は、このリポジトリから WebFetch で直接取得してください:https://raw.githubusercontent.com/sales-skills/sales/main/skills/{skill-name}/SKILL.md — 例:sales-mailshake の場合は https://raw.githubusercontent.com/sales-skills/sales/main/skills/sales-mailshake/SKILL.md。
  • サードパーティ製の sales-* 以外のスキルの場合は、インストールされていれば ~/.claude/skills/sales-do/references/skill-sources.md で {org}/{repo} を確認し、そのリポジトリ内の同じ skills/{skill-name}/SKILL.md のパスから取得してください。

読んだ後は、 SKILL.md の具体的な記述(対象範囲、サブフロー、argument-hint の形式、または「使用しないでください」という否定的な適用条件)に基づいて推奨してください。生成する呼び出しは、プラットフォームスキルの argument-hint に合わせてください。プラットフォームスキルがユーザーの状況に合わない場合は、別のスキルに切り替えるか、適切でないスキルを推奨するのではなく、ここで直接質問に対応してください。

関連スキル

  • /sales-iterable — Iterable プラットフォームのサポート(トランザクションメールのトリガーキャンペーン、Studio ジャーニー、クロスチャネル)
  • /sales-braze — Braze プラットフォームのサポート(トランザクションメール API、Canvas Flow、クロスチャネルオーケストレーション)
  • /sales-brevo — Brevo プラットフォームのサポート(トランザクションメール、マーケティング、CRM)
  • /sales-sendgrid — SendGrid プラットフォームのサポート
  • /sales-postmark — Postmark プラットフォームのサポート
  • /sales-mailgun — Mailgun プラットフォームのサポート
  • /sales-customerio — Customer.io プラットフォームのサポート
  • /sales-mailchimp — Mailchimp/Mandrill プラットフォームのサポート
  • /sales-getresponse — GetResponse プラットフォームのサポート(MAX プランのトランザクションメール、マーケティングオートメーション、ウェビナー)
  • /sales-sendpulse — SendPulse プラットフォームのサポート(SMTP トランザクションメール、マーケティングオートメーション、チャットボット)
  • /sales-deliverability — プラットフォーム横断のメール到達性(SPF/DKIM/DMARC、ウォームアップ、レピュテーション)
  • /sales-mailerlite — MailerLite プラットフォームのサポート(メールキャンペーン、自動化、トランザクションメール、API)
  • /sales-email-marketing — オプトイン方式のマーケティングメール戦略(トランザクションメールではありません)
  • /sales-integration — メールツールと CRM などのシステムの連携
  • /sales-do — どのスキルを使えばよいかわかりませんか?ルーターがあらゆる営業目標に適したスキルを選びます。インストール:npx skills add sales-skills/sales --skill sales-do

例

例1:トランザクションメールプロバイダーの選択

ユーザーの発言:「SaaS スタートアップで、注文確認、パスワードリセット、アクティビティ通知などのトランザクションメールを1日あたり約5K通送信しています。どのプロバイダーを使うべきですか?」 スキルの対応:送信量(中程度)、用途(一般的なトランザクションメール)、想定されるニーズ(信頼性、優れた到達性、妥当なコスト)を評価します。最良の到達性を求める場合は Postmark、柔軟性を求める場合は SendGrid を推奨します。月間15万通の送信量で料金を比較します。 結果:根拠と費用の比較、設定の次の手順を含む明確な推奨

例2:配信遅延のデバッグ

ユーザーの発言:「Mailgun 経由で SMTP を使って送信しているパスワードリセットメールの到着に、30秒以上かかっています」 スキルの対応:SMTP のキューイングが原因である可能性を特定します。時間が重要なメールには REST API への切り替えを推奨します。パスワードリセット用の Mailgun API の例を示し、Webhook によるモニタリングを提案します。 結果:根本原因を特定し、API 移行コードとモニタリングの設定を提示

例 3:Brevo でトランザクションメールを設定する

ユーザーの質問:「Brevo API を使って、動的な注文データを含む注文確認メールを送信するにはどうすればよいですか?」 スキルの内容:Brevo の UI でテンプレートを作成する方法 → templateId と params を指定して POST /smtp/email を呼び出す方法 → 配信 Webhook を設定する方法 → エラー処理と再試行ロジック 結果:テンプレート、API 統合、モニタリングを備えた、動作するトランザクションメールのフロー

トラブルシューティング

トランザクションメールがスパムに振り分けられる

症状:注文確認メールやアカウント関連のメールがスパムに振り分けられる 原因:通常、ドメイン認証の問題、共有 IP のレピュテーション、またはコンテンツによる判定が原因です 解決方法:1) SPF/DKIM/DMARC が正しく設定されていることを確認します。2) レピュテーションの低い共有 IP を使用していないか確認し、専用 IP の利用を検討します。3) メールの内容にスパム判定のトリガーとなる語句がないか確認します。4) トランザクションメールにマーケティングコンテンツを混在させないようにします。/sales-deliverability を参照してください。

トランザクションメールのバウンス率が高い

症状:トランザクションメールの送信でバウンス率が 2% を超える 原因:無効なアドレスへの送信。ユーザーが登録時に偽のメールアドレスを入力したり、入力を間違えたり、アカウントが放置されたりすることが原因です 解決方法:1) 登録時にリアルタイムのメールアドレス検証を実装します(ZeroBounce、Kickbox、またはプロバイダー組み込みの機能を使用)。2) アカウント作成時にダブルオプトインを使用します。3) ハードバウンスを直ちに配信停止リストに追加します。4) 連絡先リストを四半期ごとに整理します。

Webhook イベントが届かない

症状:メール送信後に Webhook コールバックが受信されない 原因:Webhook エンドポイントの設定ミス、ファイアウォールによるプロバイダーの IP のブロック、または SSL 証明書の問題 解決方法:1) Webhook URL に外部からアクセスできることを確認します(localhost ではないこと)。2) エンドポイントが 5 秒以内に 200 を返すことを確認します。3) ファイアウォールを使用している場合は、プロバイダーの IP 範囲を許可リストに追加します。4) プロバイダーの Webhook ログで配信失敗の試行を確認します。

コメント