自作のニュースレターフォームでダブルオプトインを行う

Ikiform は登録した本人にメールを送らないので、確認メールはニュースレターを配信するツールから送る必要があります。中継が Ikiform の署名付き Webhook を受け取り、読者を未確認としてそのツールに追加し、ツールが本人にリンクをメールで送り、クリックして初めて購読者になります。この機能をオンにする方法はツールごとに異なり、中継はすでに購読している人に 2 通目の確認メールを送ってはいけません。

ここが違う

Ikiform はフォームを入力した本人にはメールを送りません。通知メールが届くのはあなたとチームだけなので、自動返信、確認メール、ダブルオプトインはありません。それらは Webhook をきっかけに、自分のメールツールから送ってください。プロバイダーの埋め込みなら、確認はプロバイダーのフォームの設定項目です。自分のフォームでは 2 つのシステムが関わり、確認はリストを管理する側の役目です。大事なのは、各登録が確認メールを送らせる状態でそのツールに届き、送るべきでないときには送らせないようにすることです。

ダブルオプトインはメールツール内の状態遷移です。読者は未確認の状態で始まり、配信は受け取れず、クリックして初めて購読者になります。Ikiform の役目は、中継が 204 を返した時点で終わります。

各ツールでの設定

どのツールにも独自の「未確認」の概念があり、API で追加した新しい購読者をその状態にする方法もそれぞれ異なります。ここを間違えると、購読者がメールなしで最初から確認済みとして追加されます:

頼る前に、それぞれ自分のアドレスでテストしてください。ツールの設定は変わりますし、件名、文面、リンクで開くページなど、メール自体の設定はツール側で行います。

確認を 1 回だけ求める中継

素朴な中継は、Webhook が届くたびに確認を求めます。それがまずいケースは 2 つあります。1 分間に 3 回送信した読者には 3 通のメールが届き、他人のアドレスを登録するボットは、試すたびにその被害者の受信箱に確認メールを届けてしまいます。この Cloudflare Worker は、アドレスごとに 1 日 1 回まで確認をツールに依頼します:

import { verifyWebhook, WebhookVerificationError } from "@ikiform/sdk/webhooks";
import { addUnconfirmed } from "./tool";

export interface Env {
  IKIFORM_WEBHOOK_SECRET: string;
  TOOL_API_KEY: string;
  SEEN: KVNamespace;
}

const DAY = 86_400;

async function digest(text: string) {
  const bytes = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(text));
  return [...new Uint8Array(bytes)].map((byte) => byte.toString(16).padStart(2, "0")).join("");
}

export default {
  async fetch(request: Request, env: Env) {
    if (request.method !== "POST") return new Response(null, { status: 405 });
    const payload = await request.text();
    let event;
    try {
      event = await verifyWebhook({ payload, headers: request.headers, secret: env.IKIFORM_WEBHOOK_SECRET });
    } catch (error) {
      if (error instanceof WebhookVerificationError) return new Response(error.reason, { status: 400 });
      throw error;
    }
    if (event.type !== "submission.created" || event.data.fields.consent !== true) {
      return new Response(null, { status: 204 });
    }

    const email = String(event.data.fields.email).trim().toLowerCase();
    const key = `confirm:${await digest(email)}`;
    if (await env.SEEN.get(key)) return new Response("Confirmation already requested today", { status: 200 });

    const answer = await addUnconfirmed(env, email, event.data.fields.first_name);
    if (answer.status === 429) {
      return new Response("Rate limited", { status: 503, headers: { "retry-after": answer.headers.get("retry-after") ?? "60" } });
    }
    if (!answer.ok) return new Response(`Email tool answered ${answer.status}`, { status: 502 });

    await env.SEEN.put(key, event.id, { expirationTtl: DAY });
    return new Response(null, { status: 204 });
  },
};

{
  "$schema": "node_modules/wrangler/config-schema.json",
  "name": "newsletter-relay",
  "main": "src/index.ts",
  "compatibility_date": "2026-10-01",
  "routes": [{ "pattern": "hooks.example.com", "custom_domain": true }],
  "kv_namespaces": [{ "binding": "SEEN", "id": "<your KV namespace id>" }]
}

• ./tool の addUnconfirmed は、上の表にあるツールの呼び出しです。本体は Kit、MailerLite、beehiiv のページからコピーしてください。
• KV のキーは小文字にしたアドレスの SHA-256 なので、ストアにアドレスそのものは保存されません。1 日で期限切れになります。
• キーはツールがリクエストを受け付けたあとにだけ書き込まれます。ツールが失敗すれば Ikiform がリトライし、そのリトライはブロックされません。
• 繰り返しに 200 を返すと、Ikiform は配信が成功したと判断してリトライしません。理由はボディで配信ログに残ります。
• Worker はカスタムドメインで動かします。Ikiform は workers.dev のホスト名を Webhook の URL として受け付けません。URL のルールとそれぞれの応答の意味は Webhook のドキュメントにすべてあり、各配信を 1 回だけ保存する中継は自分のサーバーで紹介しています。

フォームに書くべきこと

「ご登録ありがとうございます」と表示されたのにニュースレターのフォルダーに何もなければ、読者は失敗したと思います。移動先のページで、この後どうなるかを伝えてください:

1. 成功時の一文かサンクスページで、開くべきメールがあることを伝えます:「あと少しです。お送りしたメールを開いて、アドレスを確認してください。」
2. 探すべき送信者名を伝え、数分たっても届かなければ迷惑メールフォルダーを見るよう案内します。
3. メールツールで、確認リンクで開くページを自分の「登録が完了しました」ページに設定すれば、流れが自分のサイトで終わります。

フォームの同意チェックボックスと確認メールは役割が違います。チェックボックスは、あなたのページで誰かが同意したことを記録します。クリックは、そのアドレスが同意した本人のものであることを証明します。ほとんどのリストでは両方が必要です。ニュースレターのフォームテンプレートには必須のチェックボックスがあります。

ハマりどころ

• 既存の購読者。 すでに確認済みの人が、別のページからもう一度登録します。未確認に戻さないでください。先にアドレスを照会する中継は MailerLite のページで紹介しています。
• 配信を停止した人。 登録が、配信停止を取り消してよいという許可になるとは限りません。beehiiv は reactivate_existing: true を送ったときだけ再有効化し、MailerLite は resubscribe: true のときだけ再購読させます。フォームでそう明記しているときだけ送ってください。
• リンクスキャナー。 企業のメールフィルターの中には、受信メールのリンクを開いて確認するものがあります。ページを開いただけで確認するツールだと、誰もクリックしていないアドレスをスキャナーが確認してしまいます。ツールの確認ページでボタンを押させるかどうかを確認してください。
• 到達率。 確認メールは、読者があなたから受け取る最初のメールです。ツールで認証済みのドメインから送らないと迷惑メールに入り、登録が完了しません。
• 未確認の人がたまっていきます。 まだ購読者ではありません。リマインダーを送るかどうかをツールで決め、あとはそっとしておきましょう。

動作を確認する

1. 自分のアドレスでフォームを送信します。ページに受信トレイを確認するよう表示されます。
2. Ikiform の Webhooks で配信を開きます。succeeded と、リレーの 204 が表示されます。
3. メールツールで購読者を開きます。ツールによって、未確認、非アクティブ、保留中のいずれかになっています。
4. 確認メールを開いてクリックします。購読者がアクティブまたは確認済みになります。
5. 1 日以内に同じアドレスでもう一度送信します。配信には「Confirmation already requested today」と共に 200 が表示され、2 通目のメールは届きません。
6. すでに確認済みのアドレスで登録します。確認済みのまま変わらず、新しい確認メールも届きません。

よくある質問