sequenzy-email-marketing

Sequenzy Eメールマーケティング

概要

SequenzyのEメールマーケティング／製品運用（購読者、リスト、タグ、セグメント、キャンペーン、シーケンス、テンプレート、AI Eメール生成、トランザクション送信、配信統計、ダッシュボードURL、CLI／MCPの動作、現在サポートされているワークフローの確認）では、これをデフォルトのスキルとして使用してください。サポートされているワークフローではsequenzy CLIを優先し、MCPツールを介してタスクを実行する場合はpackages/mcp/src/tools/index.tsをMCPの信頼できる情報源として扱ってください。また、要求されたワークフローが現在の実装に組み込まれていない場合は、その旨を明示してください。sequenzyとsequenzy-email-marketingの両方が該当する場合は、まずこのスキルを読み込んでください。

基本原則

1. 実際に組み込まれているコマンドを確認する際は、packages/cli/src/index.tsxを信頼できる情報源として扱ってください。
2. CLIの動作、ペイロードの形式、APIルートを確認する際は、packages/cli/src/commands/とpackages/cli/src/api.tsを信頼できる情報源として扱ってください。
3. MCPツール名、引数、事前検証を確認する際は、packages/mcp/src/tools/index.tsを信頼できる情報源として扱ってください。
4. ドキュメントや--helpのテキストに記載されているだけで、実装が伴っていないコマンドやツールのサポートを約束しないでください。
5. 対話型認証にはsequenzy loginを、オートメーションにはSEQUENZY_API_KEYを優先してください。
6. ワークフローで可能な場合は、変更を加える前に状態を確認してください。

サポートされているワークフロー

重要な操作を実行する前に、references/use-cases.mdを読んでください。現在実装されているCLIフローは次のとおりです。

• ログインとログアウト
• whoami によるローカル認証／セッションの確認
• account によるアカウントの確認
• companies list|get|create|update による会社情報の確認・作成、またはブランド／送信者 ID の更新
• 統計の概要、またはキャンペーン、シーケンス、トランザクション ID 別の統計。カスタムの --start／--end 範囲、--email-type と --mailbox-provider による絞り込み、--include-bots、キャンペーンの clickedLinks とアンケート／NPS の polls 配列に対応
• events --campaign|--sequence による配信／エンゲージメントイベントの生データ一覧表示、email-sends list|get による配信ごとの確認、suppressions get|remove によるバウンス抑制のクリーンアップ
• subscribers の list、add、update、get、remove。list はデフォルトですべてのページを取得し、タグ、セグメント、リストによる絞り込みに対応。add と update は --first-name／--last-name（MCP の add_subscriber／update_subscriber では firstName／lastName）を使ってネイティブのプロフィール名を設定するため、名前をカスタム属性に保存しないでください。どちらもネイティブの電話番号と SMS の同意にも対応
• subscribers import／import-status による購読者の一括インポート、購読者メモ、subscribers event によるカスタムイベントの発火（リアルタイム、または --occurred-at による過去データのバックフィル）、subscribers tags add|remove によるタグの一括操作
• リストの list、create、update、delete、add-subscribers、remove-subscribers と、メールアドレス、JSON、CSV、または改行区切りファイルからリストに一括登録するための import エイリアス
• タグの list、create、update、delete。後方互換性のため、引数なしの sequenzy tags でも引き続きタグ定義を一覧表示
• セグメントの list、create、update、delete、count。--match any、ネストされたフィルターのルート、カスタムイベントフィルター、保存済みセグメントの構成フィルターに対応
• テンプレートの list、get、create、update、delete。list はラベルによる絞り込みに対応し、create／update はラベル、HTML 生データ、または Sequenzy ブロック JSON を受け付けます
• キャンペーンの list、get、create、ラベルと返信先の更新を含む update、schedule、test。list はラベルによる絞り込みに対応し、create はラベルに加えて HTML 生データ、Sequenzy ブロック JSON、またはプロンプト生成コンテンツを受け付けます。update はラベルに加えて HTML 生データまたは Sequenzy ブロック JSON を受け付け、schedule は確認用プレビューリンクを返します。create と schedule はどちらも、--segment または --target-lists-json／--target-lists-file で対象オーディエンスを指定できます
• キャンペーンのライフサイクル制御。campaigns cancel は予約済み、一時停止中、承認待ち、または送信中のキャンペーンを確認プロンプトなしですぐに停止し、campaigns unschedule は予約済みのキャンペーンまたは定期配信シリーズを下書きに戻します。campaigns pause と campaigns resume は進行中の配信を一時停止／再開し、再開時には --spread-over-hours を指定できます。campaigns delete は送信中、予約済み、または一時停止中のキャンペーンを削除できません（先にキャンセルしてください）。campaigns duplicate は --mode campaign|ab_test|variant に対応
• campaigns audience によるキャンペーンのオーディエンス確認、campaigns render／templates render／sequences render による実際の送信内容に忠実な HTML プレビュー（購読者またはアドホックなパーソナライズ、ロケール、トラッキング、--out に対応）、campaigns schedule --repeat weekly|monthly による定期配信、campaigns resend-to-non-openers による送信後の再エンゲージメント
• A/B テストの list、get、stats、restart、update-variant、create、add-variant、delete-variant、delete。create／add-variant／delete-variant／delete は下書き状態のキャンペーン A/B テストに対して実行でき、バリアント A は保護されたコントロールです。restart は完了したシーケンス A/B テストを再実行します。シーケンスの A/B ステップでは、ab_tests:read が許可されている場合、sequences get --json と MCP の get_sequence で各バリアントのすべてのブロックを確認できます。編集には ab-tests update-variant／update_ab_test_variant のみを使用してください
• MCP のテンプレートおよびキャンペーン用ツールは、一覧表示／作成／更新時のラベルに対応。MCP の update_campaign は replyTo と replyProfileId にも対応し、MCP の schedule_campaign は下書きまたは予約済みのキャンペーンを予約できます
• MCP の search_subscribers は list、listId、または listName によるリストの絞り込みに対応。MCP の add_subscribers_to_list は1回の呼び出しで最大500件のメールアドレスを受け付けます
• シーケンスの list、get、create、update、enable、disable、delete、enroll、cancel-enrollments。明示的な割引アクションのステップ、購読者 ID またはイベントプロパティのフィールド値によるキャンセル、タグ、リスト、セグメント、イベント、クリックされたリンク、フィールド条件による update 分岐の挿入に対応。イベントとクリックされたリンクの分岐チェックでは activityScope（this_sequence、previous_email、ever）を使用できます
• sequences enroll によるシーケンスへの手動登録。メールアドレス、JSON、またはファイルを使用し、必要に応じて --target-node-id で特定のノードを指定できます。登録済み、スキップ、未検出の購読者を報告します
• チームの list、--role admin|marketer|viewer|restricted による invite、およびオーナーのみ使用できる --billing-access、cancel-invitation
• 受信トレイの list（ステータス、検索、未読、ページネーションによる絞り込み）、get、内部メモを含む reply（--note）、close、reopen、mark-read
• 送信 Webhook エンドポイント用の webhooks の list、create、update、delete、test、deliveries、replay。create は一度だけ表示される署名シークレットを返すため、機密情報として取り扱う必要があります
• generate email、generate sequence、generate subjects、generate sms による AI 生成
• CLI の urls、MCP の get_app_urls、およびキャンペーン、シーケンス、テンプレート、会社の結果に含まれる appUrls／url フィールドによるダッシュボード URL の生成
• ウェブサイトの list、add、check、guide
• デジタル製品の配信に使用する製品の list、sync、upsert（独自 ID をキーとする API プロバイダー製品。最大100件を一括処理）、delete、attach-file、detach-file。attach-file --file は署名付き URL を使ってローカルファイルをアップロードします。添付ファイルは saas.purchase イベントで {{event.download.url}}／{{event.download.name}} として公開されます（MCP：list_products、upsert_products、delete_product、attach_product_file、remove_product_file、sync_products）
• api-keys create|list|revoke による API キーの管理。作成時の権限プリセットと明示的なスコープに対応。新しいキーは機密情報として取り扱います
• トランザクションメール：send によるテンプレートまたは HTML 生データを使った単発送信のほか、transactional list|get|create|update|delete による保存済みテンプレートの管理、transactional widgets preferences-token による設定用 iframe トークンの取得
• forms の list と update（MCP ではさらに create_form、get_form_embed に対応）、および公開／非公開、複製、カスタムドメイン、DNS 検証を含む landing-pages によるランディングページの完全な管理
• CRUD 以外のシーケンス操作：render、ノードごとの test 送信、duplicate、archive／unarchive、CSV エクスポート付きの登録一覧、pause-enrollments／resume-enrollments、コンバージョン goals、受信トリガーの webhook get|configure|rotate
• templates localizations set|sync によるテンプレートの AI／手動ローカライズ
• インテグレーション：catalog、connect（API キー／Webhook シークレットを使うプロバイダーに対応。OAuth プロバイダーはダッシュボードで接続）、list、get、activity、sync、enable-sync／disable-sync、Shopify の pixel／enable-pixel、guide
• Meta Ads のオーディエンス同期：audience-syncs list|ad-accounts|create|update|delete|sync
• 到達率と送信設定：sender-profiles list|update、tracking settings|update（開封／クリックトラッキング、厳格なボットフィルタリング、アトリビューション期間、ダブルオプトイン、自動 UTM）、シーケンス／ステップ単位の送信時間枠
• Shopify の自動化設定：shopify settings get|update（閲覧放棄、カート放棄、値下げ）
• SMS 操作：sms settings、sms send-test、SMS シーケンスステップ、generate sms
• インテグレーションのイベントからタグへの同期ルール：sync-rules get|update
• 個人通知設定：account notifications get|set
• 製品フィードバック：feedback。ユーザーが正確なペイロードを承認した後、不足機能の報告、バグ報告、その他の製品フィードバックを Sequenzy チームに送信します（MCP：submit_feedback）

サポート対象外または未実装のワークフロー

サブコマンドが存在しない場合は、対応する名詞が存在していても、サポート対象外として扱ってください。主な残りの不足項目は、キャンペーンの即時送信（「今すぐ送信」コマンドはありません。代わりに、近い将来のタイムスタンプを --at に指定してスケジュールしてください）、送信ドメインの追加・確認（MCP の add_sending_domain / verify_sending_domain またはダッシュボードのみ）、フォームの作成と埋め込みスニペット（MCP の create_form / get_form_embed のみ）、画像アセットのアップロード（MCP の upload_image_asset のみ）です。一括でのリストへの登録は、subscribers add ではなく、sequenzy lists add-subscribers とそのエイリアス sequenzy lists import でサポートされています。ユーザーがサポート対象外の操作を希望した場合は、sequenzy feedback "..." --category missing_capability（MCP：submit_feedback）で不足項目を報告するよう提案してください。フィードバックを送信する前に、送信する正確なメッセージ、カテゴリ、コンテキストをユーザーに提示し、非公開のアカウント、購読者、連絡先、キャンペーンの詳細は含めず、ユーザーの承認後にのみ送信してください。

ワークスペースのロール

特権が必要なワークフローを選ぶ前に、sequenzy account または MCP の get_account を確認してください。アカウントキーの権限は、選択されたスコープと現在のワークスペースロールを組み合わせたものです。roleRestrictedScopes は、そのロールによってブロックされているスコープを示します。canSendLive は、少なくとも1つの配信ワークフローが利用可能であることを意味しますが、すべての送信ツールが許可されているという意味ではありません。

マーケターは、マーケティングコンテンツ、購読者、キャンペーン、シーケンスを管理でき、マーケティングのテスト送信やスケジュール解除も行えます。トランザクション送信や、チーム、請求、インテグレーション、API キー、送信 ID、ワークスペース設定の管理はできません。既存の送信者／返信先プロファイルを選択してください。新しいプロファイルのインライン作成も制限されています。トランザクション送信に関連付けられたテンプレートと、そのキャンペーン、A/B、シーケンスのソースは、コピー、プレビュー、共有リンク、分析、保持された送信履歴を通じても保護されます。利用可能な範囲で最も制限の少ないロールを使用してください。マーケターや制限付きメンバーに請求へのアクセス権を付与することはできません。

実行パターン

1. まず sequenzy whoami を実行するか、SEQUENZY_API_KEY が設定されていることを確認して、認証状態を確認します。
2. ユースケースに合った、最も範囲の狭いコマンドを選びます。
3. 変更を実行する前に、ID、宛先のメールアドレス、件名、テンプレート、コンテンツの入力を検証します。
4. CLI の制限事項は、回避策をでっち上げずにそのまま伝えます。
5. CLI で対応していないワークフローの場合は、次善の方法が Sequenzy ダッシュボードの利用か、API を直接使用することかを伝え、sequenzy feedback "..." --category missing_capability（MCP：submit_feedback）で問題を報告することを提案します。フィードバックを送信する前に、送信予定のメッセージ、カテゴリ、コンテキストをユーザーに正確に提示し、アカウント、購読者、連絡先、キャンペーンに関する非公開情報は含めず、ユーザーの承認後にのみ送信します。
6. キャンペーン、シーケンス、テンプレート、会社を作成、確認、またはスケジュールし、ユーザーが内容の確認や編集を希望する可能性がある場合は、ツール／CLI の出力に含まれる url、previewUrl、または appUrls のダッシュボード URL を提示します。必要に応じて、sequenzy urls または MCP の get_app_urls を使って生成します。
7. 破壊的なコマンド（delete、delete-variant、cancel-invitation、revoke、suppressions remove など）は、確認を求めます。実行前に、対象の操作とリソース（ID と名前）を正確に伝え、その操作に対する明示的な承認を得ます。--yes（または -y）を指定できるのは、その承認を得た後だけです。これは、非 TTY のエージェントや CI の実行で確認プロンプトを省略するために必要です。ユーザーから確認を得ていない操作について、確認を回避するために --yes を使用してはいけません。
8. API キー、Webhook 署名シークレット、その他の一度限りの認証情報は、機密性の高い出力として扱います。シークレットの値をそのままチャット、ログ、チケット、公開トランスクリプトに貼り付けてはいけません。パスワードマネージャー、シークレットストア、暗号化ファイル、バージョン管理の対象外にあるローカルの .env ファイルなど、ユーザーが承認した安全な保存先に保存します。保存先がない場合は値を伏せ、保存先と短いフィンガープリントのみを報告します。
9. 運用上重要な実装上の注意点を伝えます。たとえば、whoami はキャッシュされたローカルの認証状態を使用すること、シーケンスの作成では --goal と明示的なステップモードの両方をサポートしていること、明示的な割引ステップを有効化するには Stripe が必要なこと、生成されるシーケンスはメール 10 通までであること、現在のバックエンドにおける campaigns test はスタブ化された成功パスであること、条件付きメールコンテンツには生の HTML ではなくブロック JSON が必要なことなどです。

ダッシュボード URL

SEQUENZY_APP_URL が設定されている場合は、ダッシュボードのベース URL として使用します。設定されていない場合は、https://sequenzy.com をデフォルトとして使用します。

CLI／MCP の結果で返された実際の URL を優先します。

• シーケンスエディター：/dashboard/company/{companyId}/sequences/{sequenceId}
• キャンペーンエディター：/dashboard/company/{companyId}/campaign/{campaignId}
• キャンペーンのプレビュー／確認：/dashboard/company/{companyId}/campaign/{campaignId}?step=review
• テンプレート／メールエディター：/dashboard/company/{companyId}/emails/{emailId}
• 設定：/dashboard/company/{companyId}/settings
• 設定タブ：/dashboard/company/{companyId}/settings?tab={tab}

よく使う設定タブには、domain、tracking、localization、integrations、events、tags、goals、sync-rules、api-keys、widgets、team があります。

参考資料

• references/command-reference.md：正確なコマンド形式、環境変数、動作、注意点。
• references/use-cases.md：一般的なエージェントタスクで使用する判断ツリーと例。