沿革とトラブルシューティング

ページをコピーする

すべてのメールおよびHTTPリクエストは、リクエスト、レスポンス、処理時間、エラー情報とともに記録されます。履歴の確認方法、アクションの再送信方法、および最も一般的な障害の解決方法についてご説明します。

このアプリで実行されるすべてのアクションは記録されます。メールが届かなかった場合や、何かおかしい状態で届いた場合は、まず「履歴」を確認してください。

検索では、レイアウト名またはリクエスト名に一致する結果が表示されます。HTTPリクエストの「リクエスト履歴」ボタンからここに移動すると、その1つのリクエストに事前フィルタリングされます。「すべてのイベントを表示」ボタンをクリックすると、フィルタが解除されます。

検索フィールド、アクションの種類、ステータス、レイアウト、送信者ごとのフィルター、およびリストに表示された2通の送信済みメールが掲載された「履歴」ページ — 履歴：すべてのメールとHTTPリクエストが表示され、リストの上部にフィルター、タイトルバーには「CSVでエクスポート」があります。

CSVとしてエクスポート

「履歴」ページの上部にある**「CSVをエクスポート」を選択すると**、その時点でフィルタリングされている通りのリストがダウンロードされます。検索条件や設定したすべてのフィルタは、エクスポートにも適用されます。ファイル名は「history-<date>.csv」となり、最大で最新の50**,000件の**イベントが保存されます。フィルタ条件に一致するイベントがそれ以上ある場合、ダウンロード後にアプリからその旨が表示されます。古いイベントを取得するには、フィルタ条件を絞り込んでください（例：1つのレイアウトまたは1つのステータスに限定するなど）。

列：日付（UTC）、ID、タイプ、ステータス、レイアウトまたはリクエスト、受信者、CC、BCC、件名、エラー、所要時間（ms）。列名およびステータスのラベルは、管理画面の設定言語で表示されます。「受信者」、「CC」、「BCC」、「件名」は、メールの場合にのみ表示されます。エクスポートには、「履歴」リストに表示されている内容が含まれます。Shopify Flow変数、リクエスト本文、およびレスポンスは含まれません。

注目すべき3つのポイント

**赤い「失敗」バッジは、**送信またはリクエストが行われなかったことを示しています。プロバイダー側のエラーを確認するには、バッジをタップしてください。

琥珀色の「空の変数」バッジが表示されている場合は、メールは配信されましたが、1つ以上の{{ variables.x }}プレースホルダーが何も表示されなかったことを意味します。そのため、受信者には空白が入ったメッセージが届いてしまいました。これは、以前は目に見えなかったエラーです。行は緑色で表示され、プロバイダーはメッセージを受け入れていますが、問題に気づくのは受信者だけなのです。

**灰色の「スキップ」バッジは、**宛先受信者全員がマーケティングメールの配信登録を解除していたため、マーケティングメールが送信されなかったことを示しています。これは配信失敗ではなく、プランの利用枠にはカウントされず、成功率の計算からも除外されます。詳しくはマーケティングメールと配信停止をご覧ください。

詳細画面

エントリを開くと、次のように表示されます：

カード	目次
空の変数に関する警告	どのプレースホルダーが何も生成されなかったか、またShopify Flowがそれらを空の状態で送信したのか、あるいはまったく送信しなかったのか
配信されませんでした：受信者が配信停止手続きを行いました	エラーではなく「スキップされたイベント」として表示され、購読解除へのリンクが掲載されています
イベントの詳細	イベント ID、アクションの種類、ステータス、継続時間、実行時間、および Shopify Flow の実行 ID
エラーメッセージ	アクションが失敗した際の、プロバイダーまたはAPIの実際のエラー
データの請求	送信された内容――受信者、送信者、解決済みの件名、変数、または解決済みのHTTPリクエストなどです。マーケティングメールの場合、「`to`」は配信停止されたアドレスが削除された後の受信者リストであり、「`suppressed`」は削除された件数を示します。メタフィールドから添付ファイルが送信されたメールの場合、「`orderId`」または「`customerId`」には、どの注文またはお客様が閲覧されたかが記録されます。
応答データ	何が返ってきたか――プロバイダーのメッセージIDか、それともHTTPステータスと本文か。マーケティングメールの場合、`recipients` には、`sent`、`failed`、または `skipped` を含むすべての「To」受信者リストと、それぞれのメッセージIDまたはエラーが表示されます。

件名には、どの送信者が使用されたかが示されています。例えば、「Order email via support@acme.com (MICROSOFT)」といった具合です。

マーケティングメールは、宛先（To）の受信者ごとに1通ずつ送信されますが、履歴上では1つのイベントとして記録されます。すべての受信者がメッセージを受け取った場合、そのイベントは**「成功」となります。別のメッセージが送信された後に1通でも配信に失敗すると、そのイベントは「失敗」**となります。その際、エラーメッセージには配信されなかった受信者の名前が表示され、レスポンスデータ内の「recipients」には、メッセージを受け取った受信者が表示されます。

「イベントの詳細」には、送信されたメールに関する履歴イベントが表示され、ステータス、所要時間、および言語（ドイツ語）が記載されています。 — イベントが開始されました：左側に送信された内容、そして「イベントの詳細」の下には、ステータス、開催期間、およびメールが送信された言語が表示されています。

アクションの再送信

詳細ページには**「再送信」**ボタンがあります。このボタンをクリックすると、元の変数を使用してレイアウトが再描画され、同じ送信者を通じて元の受信者に再度送信されるか、送信されたときとまったく同じ形でHTTPリクエストが再実行されます。

このアクションは直ちに実行され、プランのアクションとして1回分カウントされます。フォールバックのデフォルト送信者を通じて実行されたアクションについては、再送信は利用できません。

スキップされたイベントには「再送信」ボタンがありません。送信されていないため、再送信する対象がないからです。お客様が再度購読登録されたら、ワークフローを再度実行してください。マーケティングメールの再送信では、配信停止リストが再度確認され、最初の送信以降に配信停止したユーザーは除外されます。その結果、対象者が誰もいなくなった場合は、再送信は拒否されます。

よくある問題

**そのメールは届かず、履歴にも一切の記録がありません。**アクションは実行されませんでした。問題はShopify Flowにあり、こちらにはありません。ワークフローが有効になっているか、トリガーが発動したか、そして条件が実際に一致したかを確認してください。タグの条件は完全に一致しているため、VIPとvipは異なるものです。

**このエントリには「変数が空」というバッジが表示されています。**このレイアウトでは、Shopify Flowから提供されなかった変数、または空の状態で提供された変数が求められています。どちらの場合か確認するには、エントリを開いてください。詳しい手順については、『Shopify Flow からのデータの受け渡し』をご覧ください。

このエントリはスキップされました。このレイアウトはマーケティング用であり、宛先として指定されたすべての受信者が配信停止リストに登録されているため、アプリは送信を行いませんでした。これは、配信停止機能が意図したとおりに動作していることを示しています。注文や配送状況の更新など、お客様が必ず受け取る必要があるメールの場合は、トランザクション用レイアウトを使用する必要があります。マーケティングメールと配信停止をご参照ください。

**テストメールは問題なく表示されましたが、本番のメールは空白になっています。**レイアウトエディタ内の「テスト変数」は、プレビューとテスト送信にのみ影響します。本番の送信では、「Shopify Flow」の「変数（JSON）」フィールドが使用されますが、これはまったく別のものです。これが最もよくある混乱の原因です。

**ステータスは「失敗」となっており、認証エラーが発生しています。SMTP の場合、認証情報またはポートが間違っている可能性があります。SMTP サーバーを開き、「接続のテスト」をクリックしてください。Microsoft 365 または Google の場合、接続の再認証が必要な場合があります。「メール送信者」→「接続済みアカウント」**で、「再接続が必要」というバッジが表示されていないかご確認ください。

**メール本文に「[object Object]」と表示されています。**オブジェクト全体をそのまま挿入してしまいました。メールでは、そのオブジェクトにアクセスするか（{{ variables.customer.firstName }}）、ループ処理を行う必要があります。HTTPリクエストの場合のみ、オブジェクトが自動的にJSON形式に変換されます。

メッセージはサイズ超過のため拒否されました。合計20 MBを超える添付ファイルはブロックされ、Microsoft 365では4 MBを超えるインライン添付ファイルが拒否されます。大容量のファイルはリンクモードに変更してください。詳細については、添付ファイルと画像をご覧ください。

**HTTPリクエストが「SSRF blocked」というエラーで失敗しました。**宛先がプライベートまたは内部ネットワークのアドレスに解決されましたが、セキュリティ上の理由から拒否されました。外部からアクセス可能なエンドポイントをご利用ください。

**「プランの制限」というメッセージが表示され、すべてが一度に失敗してしまいます。**30日間の利用枠を使い切りました。プランと利用方法をご覧ください。

サイドキックに尋ねる

Shopify Sidekickはこのアプリに直接、読み取り専用でクエリを実行できます。手動で履歴を絞り込むよりも、多くの場合、処理が速くなります：

「今週、配信に失敗したメールはありましたか？」
「なぜ前回のメールの送信に失敗したのでしょうか？」
「どのメール送信元が設定されていますか？」
「AirtableへのHTTPリクエストはありますか？」

Sidekickは、秘密の値、SMTPパスワード、OAuthトークン、HTTPヘッダーの値、および生のペイロードを一切返しません。これらは、アプリ内で直接操作していただく必要があります。

まだ行き詰まっています

ストアのドメイン、レイアウト名またはリクエスト名、および実行日時を明記の上、バグ報告を作成してください。ヘルプセンターの「**バグの報告」**をご覧ください。