sales-brevo

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

メール／SMS／WhatsApp キャンペーンやマーケティングオートメーションから、トランザクションメッセージ、Sales CRM、Conversations（ライブチャット）、ロイヤルティプログラム、eコマース、API 統合まで、Brevo プラットフォームに関するユーザーの質問に対応します。

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

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

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

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

   • A) メールキャンペーン — マーケティングメールの作成、管理、最適化
   • B) SMS／WhatsApp キャンペーン — 設定、テンプレート、承認
   • C) マーケティングオートメーション — ジャーニー、トリガー、ワークフロー（プラットフォーム横断の戦略については、/sales-email-marketing {your question} に引き継ぎます）
   • D) トランザクションメッセージ — API／SMTP メール、トランザクション SMS（プラットフォーム横断については、/sales-transactional-email {your question} に引き継ぎます）
   • E) Sales CRM — 商談、パイプライン、会社、タスク
   • F) Conversations — ライブチャット、チャットボットの設定（プラットフォーム横断の戦略については、/sales-live-chat {your question} に引き継ぎます）
   • G) ロイヤルティ — プログラム、特典、ランク、クーポン（プラットフォーム横断の戦略については、/sales-loyalty {your question} に引き継ぎます）
   • H) コンタクト — リスト、セグメント、属性、インポート／エクスポート
   • I) 配信到達性 — ドメイン認証、専用 IP、ウォームアップ（プラットフォーム横断については、/sales-deliverability {your question} に引き継ぎます）
   • J) eコマース — 商品の同期、注文、クーポン、売上のアトリビューション
   • K) ランディングページとフォーム
   • L) プッシュ通知 — ウェブとモバイル
   • M) API と webhook — REST API、SDK、オートメーション
   • N) 統合 — Shopify、Salesforce、Zapier、Make など
   • O) Aura AI — Marketing Agent、Sales Assistant、Data Analyst
   • P) アカウントと請求 — プラン、サブアカウント、ユーザー管理
   • Q) Sendinblue からの移行 — 名称変更、URL の更新
   • R) その他 — 内容を説明してください

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

   • A) マーケティングマネージャー／メールマーケター
   • B) 開発者／技術担当
   • C) eコマースマネージャー
   • D) 営業担当者／チームリーダー
   • E) 創業者／個人事業主
   • F) 複数のクライアントを担当する代理店
   • G) その他

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

ユーザーのリクエストにすでに必要な情報の大半が含まれている場合は、該当するステップに直接進んでください。 妥当な前提を明示したうえで、可能な範囲で最善の回答を最初に提示し、最後に重要度の高い確認質問だけを1〜2件尋ねます。完全なコンテキストがそろうまで回答を保留しないでください。

ステップ 2 — 適切なスキルに引き継ぐか、直接回答する

リクエストが専門スキルに該当する場合は、次のとおり引き継ぎます。

• 見込み客リストの作成 → /sales-prospect-list
• コンタクトのエンリッチメント／データの整理 → /sales-enrich
• アウトバウンドのフォローアップ計画 → /sales-cadence
• プラットフォーム横断の配信到達性 → /sales-deliverability
• トランザクションメールのアーキテクチャ → /sales-transactional-email
• ライブチャット／チャットボットの戦略 → /sales-live-chat
• ロイヤルティプログラムの設計 → /sales-loyalty
• メールマーケティング戦略（オプトイン） → /sales-email-marketing
• ツール統合のアーキテクチャ → /sales-integration
• リードスコアリングモデル → /sales-lead-score
• ファネル／ランディングページ戦略 → /sales-funnel

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

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

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

プラットフォームガイドの詳細を確認する必要はもうありません。ユーザーの具体的な状況に集中してください。

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

注意点

調査に基づくベストエフォートの情報です。特に、プランによって利用が制限される機能や連携に関する注意点は、古くなっている可能性があるため確認してください。

1. Sendinblue から Brevo への移行に関する混乱：API のベース URL は api.sendinblue.com から api.brevo.com に変更されました。古い SDK では、引き続き Sendinblue の名前空間を参照している場合があります。GitHub の組織名は引き続き sendinblue です。ユーザーが Sendinblue と言及した場合は、Brevo のこととして扱ってください。
2. メール配信数ベースと連絡先数ベースの料金体系：Brevo の料金はメール配信数に基づいており、連絡先数に基づくものではありません（Mailchimp／HubSpot とは異なります）。すべてのプランで連絡先数は無制限です。連絡先数の上限に触れてユーザーを混乱させないでください。
3. 無料プランの日次上限：無料プランでは 1 日あたり 300 通までです。これは月間ではなく、日次の上限です。この上限に達したユーザーには、Starter プラン（月額 25 ドル、月間 20K 通）が必要です。
4. WhatsApp テンプレートの承認にかかる時間：WhatsApp キャンペーンには、Meta が承認したテンプレートが必要です。承認には 24～48 時間かかります。ユーザーに、すぐに WhatsApp メッセージを送信できると伝えないでください。
5. オートメーションとキャンペーンは別物：Brevo では、「Campaign」は単発の配信、「Automation／Journey」は複数ステップのワークフローを指します。混同しないでください。「ドリップシーケンス」について尋ねているユーザーが求めているのは、Campaign ではなく Automation です。

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

ステップ 5 — 関連するスキル

• /sales-email-marketing — 各種プラットフォームにおけるオプトイン方式のメールマーケティング戦略
• /sales-transactional-email — トランザクションメール／トリガー配信の戦略
• /sales-live-chat — 各種プラットフォームにおけるライブチャットとチャットボットの戦略
• /sales-loyalty — 各種プラットフォームにおけるロイヤルティプログラムの設計
• /sales-deliverability — プラットフォームを問わないメール到達率（SPF／DKIM／DMARC、ウォームアップ、レピュテーション）
• /sales-cadence — アウトバウンドシーケンスの設計（Brevo をコールドアウトリーチに使用する場合）
• /sales-integration — Brevo と CRM、E コマース、その他のツールの連携
• /sales-funnel — ランディングページとファネルの戦略
• /sales-lead-score — リードスコアリングモデル（Brevo では Professional プラン以上で連絡先のスコアリングが利用可能）
• /sales-checkout — チェックアウトの最適化（Brevo の E コマース機能）
• /sales-do — どのスキルを使えばよいかわからない場合は、ルーターが営業に関する目標に適したスキルを選びます。インストール：npx skills add sales-skills/sales --skill sales-do

例

例 1：ウェルカムオートメーションの設定

ユーザーの発言：「Brevo でウェルカムメールのシリーズを作成するにはどうすればよいですか？」 スキルの動作：Automation → Create Journey に進み、「Contact added to list」をトリガーとして設定し、待機時間を指定したメールステップを追加して、テスト用の連絡先でテストする手順を案内します 結果：3 通のメールを送るウェルカムシリーズのオートメーションが稼働し、テスト済みになります

例 2：Shopify と連携してカート放棄メールを送信

ユーザーの発言：「Shopify ストア向けに、Brevo からカート放棄メールを送りたいです」 スキルの動作：Brevo の Shopify プラグインのインストール、商品と注文の同期、カート放棄オートメーションの Journey の作成、配信タイミング（1 時間後、24 時間後、72 時間後）の設定、メールテンプレートへの商品ブロックの追加を順に案内します 結果：Shopify と連携したカート放棄オートメーションがメールを配信します

例 3：API 経由でトランザクションメールを送信

ユーザーの発言：「Brevo API から注文確認メールを送信するにはどうすればよいですか？」 スキルの動作：API キーの設定、Brevo の UI でのテンプレート作成、templateId と params を指定した POST /smtp/email の呼び出し、配信追跡用 Webhook の設定、エラー処理について説明します 結果：テンプレートと動的パラメーターを使ったトランザクションメールのフローが機能します

トラブルシューティング

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

症状：マーケティングメールまたはトランザクションメールが迷惑メールフォルダーに入る 原因：ドメイン認証が未設定、専用 IP がない、またはエンゲージメントの低い連絡先に送信している 解決策：1) Settings → Domains でドメイン認証（DKIM + DMARC）を確認します。2) SPF に spf.brevo.com が含まれていることを確認します。3) 有料プランでは、専用 IP を申請し、段階的にウォームアップします。4) リストを整理し、6 か月以上開封していない連絡先を削除します。詳しいガイダンスについては、/sales-deliverability を参照してください。

WhatsApp のテンプレートが却下される

症状：WhatsApp のメッセージテンプレートが「Pending」のまま、または Meta によって却下される 原因：テンプレートが Meta のコマースポリシーまたはコンテンツポリシーに違反している、あるいは禁止されているコンテンツが含まれている 解決策：1) Meta の WhatsApp Business メッセージテンプレートのガイドラインを確認します。2) ユーティリティテンプレートでは宣伝文句を避けます。3) オプトインの要件を遵守していることを確認します。4) 修正して再申請します。審査には 24～48 時間かかります。

API が 429 Too Many Requests を返す

症状：API 呼び出しがステータス 429 で失敗する 原因：レート制限を超過している 解決策：1) レスポンスヘッダー x-sib-ratelimit-remaining と x-sib-ratelimit-reset を確認します。2) 指数バックオフを実装します。3) 可能であれば操作をバッチ処理します（例：個別に作成する代わりに POST /contacts/import を使用します）。4) 大量のトランザクションメールを送信する場合は、REST API の代わりに SMTP リレーを検討します。