英語から自動翻訳されています。

英語で読む
Proxy Mail QA

到達性

ユーザーより先に、メールが受信トレイに届くかを確かめましょう。

すべてのテストメールを、受信トレイと同じ視点でチェックします。10 点満点のスパムスコアで加点の内訳がわかり、受信トレイがブロックする添付ファイルには警告が付き、届く前に拒否されたメールにはその理由が表示されます。Reports と CI の実行で、すべて集計されます。

Free プラン · スパムスコアと添付ファイルのチェックは Labs · 推定であり、保証ではありません

チェック内容

受信トレイが重視する点を、すべてのテストメールで確認します。

10 点満点のスパムスコア

スパムフィルターが重視する指標をそれぞれの点数とともに合計します。5 以上は拒否またはスパム扱いの可能性が高く、1.5 以上はスパム扱いになる可能性があります。Labs で利用できます。

受信トレイがブロックする添付ファイル

Gmail がブロックするプログラムや、文書に見せかけた名前のプログラムは失敗になります。マクロ付きの Office ファイル、HTML ページ、アーカイブには警告が出ます。チェック結果に表示されるのはファイルの種類だけで、ファイル名は表示しません。Labs で利用できます。

受信前に拒否されたメール

Cloudflare のメールサーバーが、たとえば DMARC の失敗や読み取れないアドレスを理由に、メールが当社に届く前に拒否した場合、受信トレイと Troubleshoot に何が起きたかとその理由が表示されます。

SPF、DKIM、DMARC

送信サーバーがそのドメインで送信を許可されているか、メールに署名があるか、From ドメインの DMARC ポリシーを満たすかを確認します。失敗した場合は、修正すべきドメインを示します。

読みやすさを重視

プレーンテキスト版があるか、Gmail でメールが切り詰められる 102 KB 未満のサイズか、画像だけではないか、スマートフォンに合うレイアウトかを確認します。

いつも見る場所で集計

Reports では、プロジェクトごとにスパムの可能性が高いメール、スパムの可能性があるメール、有害な添付ファイル、受信前に拒否されたメールを集計します。実行レポートの最初の行には、スパムに振り分けられる可能性が高いメールの数が表示されます。

仕組み

「送信できた」から「届く」へ。

  1. オンにする

    スパムスコアと添付ファイルのチェックは、現在 Labs にあります。Account settings → Labs でスパムスコアと添付ファイルのチェックをオンにしてください。

  2. テストメールを送る

    テスト用アドレスで、登録、パスワードのリセット、オファーの発行を、手動、テスト、またはエージェントから行います。

  3. スコアと理由を確認する

    受信トレイには、メールのスパムスコア、加点の要因となる指標、リスクのある添付ファイル、Cloudflare 自身のスパム判定が表示されます。

  4. CI で検出する

    失敗した spam_risk または harmful_attachment のチェックは failed に返されます。そのため、スパムに振り分けられるようなテンプレート変更があると、テストとビルドが失敗します。

テストで使う

メールがスパムに振り分けられる場合は、ビルドを失敗させます。

checkEmail(Python check_email、エージェント向けには check_email)は判定結果だけを返し、メールの本文は返しません。Labs で Spam score and attachment checks をオンにすると、応答にスコアと指標を含む spam_risk が加わります。詳しくは開発者向けドキュメントをご覧ください。

npm パッケージを使った Playwright

welcome.spec.ts
const submitted = new Date();
await page.getByRole('button', { name: 'Create account' }).click();
await qa.waitForLink(address, { since: submitted });

const result = await qa.checkEmail(address, { since: submitted, expectHost: 'staging.acme.dev' });
const spam = result.checks.find((c) => c.check === 'spam_risk');
// Say what to fix: each marker with its points.
expect(result.failed, JSON.stringify(spam?.markers)).not.toContain('spam_risk');
expect(result.failed).not.toContain('harmful_attachment');

Python ヘルパーを使った pytest

test_welcome.py
from proxymail_qa import check_email, create_address, now, wait_for_link


def test_welcome_email_reaches_the_inbox(page):
    address = create_address()["address"]
    submitted = now()
    page.goto("/sign-up")
    page.get_by_label("Email").fill(address)
    page.get_by_role("button", name="Create account").click()
    wait_for_link(address, since=submitted)

    result = check_email(address, since=submitted)
    assert "spam_risk" not in result["failed"], result["checks"]
    assert "dmarc" not in result["failed"]

限界も正直に

慎重な推定であり、そのことを明示します。

  • メールからの推定

    スコアはメールに表れている内容から算出します。受信トレイは送信者の評判や履歴も考慮しますが、それは受信トレイ側にしか見えません。

  • すべての指標を表示

    DKIM がない、短縮リンクを使っている、件名が大文字など、スコアを上げる各項目とその点数が表示されるので、何を直せばよいかがわかります。

  • エージェントには判定結果を

    テストとエージェントが受け取るのは、チェック結果、スコア、指標です。メールの本文は渡しません。

  • 余計な送信はしません

    Proxy Mail QA は、アプリがすでにテスト用アドレスに送ったメールをチェックします。テストのために転送したり、ほかの場所に送ったりすることはありません。

  • オンにするかはあなた次第

    スパムスコアと添付ファイルのチェックは Labs で提供しているため、オンにしたときにだけ、あなたのメールと CI を判定します。

  • テストサイト専用

    あなたが開発する、またはテストを許可されたアプリの開発版、ステージング版、QA 版、プレビュー版、ローカル版向けです。

FAQ

よくある質問

Gmail や Outlook でメールがスパムに振り分けられるかわかりますか?

推定できます。スコアは、DMARC の失敗、DKIM がない、Gmail がブロックする添付ファイル、List-Unsubscribe ヘッダーのないマーケティングメールなど、スパムフィルターが重視する指標を合計したものです。10 点中 5 以上は、拒否またはスパム扱いの可能性が高いことを示します。実際の受信トレイは送信者の評判も考慮しますが、それは受信トレイ側にしか見えません。保証ではなく、リリース前のチェックとして利用してください。

スパムスコアが Labs にあるのはなぜですか?

これは新しい機能で、以前は合格していたチェックが不合格になることがあります。Labs により、メールと CI の判定をいつ始めるかを選べます。Account settings → Labs でスパムスコアと添付ファイルのチェックをオンにしてください。API キー とエージェントにも適用されます。

「受信前に拒否された」とはどういう意味ですか?

当社ドメインのメールを受信する Cloudflare のメールサーバーが、メールが Proxy Mail QA に届く前に拒否したことを意味します。たとえば、送信ドメインの DMARC ポリシーを満たさなかった場合や、読み取れない形式のアドレス宛てに送られた場合です。受信トレイ、Troubleshoot、check_delivery に理由が表示され、Reports で集計されます。これは Labs には含まれません。

添付ファイルの中身をチェックしますか?

いいえ。各添付ファイルの名前と種類を確認し、結果にはファイルの種類だけを表示します。ファイル自体が保存されることはありません。

その他の機能

ユーザーの受信トレイが判断する前に知りましょう。

無料アカウントを作成し、Labs で Spam score and attachment checks をオンにして、次のテストメールを送りましょう。

無料アカウントを作成アプリを開く

このページについて質問がありますか?

質問はどの言語でもかまいません。ドキュメントからすぐに回答を得ることも、Proxy Mail QA チームに質問を送ることもできます。チームからの返信は英語です。