Double opt-in untuk formulir newsletter buatan Anda sendiri

Ikiform tidak pernah mengirim email ke orang yang mendaftar, jadi email konfirmasi harus datang dari alat yang mengirim newsletter Anda. Relay menerima webhook bertanda tangan dari Ikiform dan menambahkan pembaca ke alat itu sebagai belum terkonfirmasi, alat itu mengirimi mereka tautan, dan hanya klik yang menjadikan mereka subscriber. Setiap alat mengaktifkan ini dengan cara berbeda, dan relay tidak boleh mengirim konfirmasi kedua ke orang yang sudah berlangganan.

Apa yang berbeda di sini

Ikiform tidak mengirim email ke orang yang mengisi formulir. Email notifikasi hanya dikirim ke Anda dan tim Anda, jadi tidak ada autoresponder, email konfirmasi, atau double opt-in. Kirim semua itu dari alat email Anda, dipicu oleh webhook. Dengan embed dari penyedia, konfirmasi adalah pengaturan di formulir penyedia. Dengan formulir sendiri, ada dua sistem yang terlibat, dan konfirmasi menjadi milik sistem yang menyimpan daftar. Pekerjaannya adalah memastikan setiap pendaftaran sampai ke alat itu dalam status yang memicu konfirmasinya, dan tidak memicunya saat tidak seharusnya.

Double opt-in adalah state machine di dalam alat email. Pembaca mulai dalam status belum terkonfirmasi, tidak bisa dikirimi edisi, dan baru menjadi subscriber saat mereka mengklik. Bagian Ikiform berakhir saat relay menjawab 204.

Pengaturan di setiap alat

Setiap alat punya konsep belum terkonfirmasi sendiri, dan caranya sendiri untuk menjadikan subscriber baru dari API berstatus itu. Salah langkah di sini dan subscriber ditambahkan sebagai sudah terkonfirmasi, tanpa email sama sekali:

Uji masing-masing dengan alamat milik Anda sebelum mengandalkannya. Pengaturan alat bisa berubah, dan email itu sendiri diatur di alat: subjek, kata-kata, dan halaman yang dibuka tautannya.

Relay yang mengonfirmasi sekali

Relay biasa meminta konfirmasi setiap kali webhook datang. Dua kasus membuat itu keliru: pembaca yang mengirim tiga kali dalam semenit mendapat tiga email, dan bot yang mendaftarkan alamat korban membuat konfirmasi Anda masuk ke inbox korban itu setiap kali mencoba. Cloudflare Worker ini meminta alat mengirim paling banyak satu konfirmasi per alamat per hari:

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>" }]
}

• addUnconfirmed di ./tool adalah panggilan alat dari tabel di atas. Salin isinya dari halaman Kit, MailerLite, atau beehiiv.
• Key KV adalah SHA-256 dari alamat dalam huruf kecil, jadi store tidak pernah menyimpan alamat itu sendiri. Key kedaluwarsa setelah satu hari.
• Key hanya ditulis setelah alat menerima request. Jika alat gagal, Ikiform mencoba ulang dan percobaan ulang itu tidak terhalang.
• Menjawab 200 untuk pengulangan memberi tahu Ikiform bahwa pengiriman berhasil, jadi tidak dicoba ulang, dan body-nya menjelaskan alasannya di log pengiriman.
• Worker berjalan di domain kustom. Ikiform menolak hostname workers.dev sebagai URL webhook. Dokumentasi webhook mendaftar setiap aturan URL dan arti setiap jawaban, dan server Anda sendiri menunjukkan relay yang menyimpan setiap pengiriman sekali saja.

Apa yang sebaiknya disampaikan formulir

Pembaca yang melihat "Terima kasih sudah berlangganan" lalu tidak menemukan apa pun di folder newsletter-nya mengira prosesnya gagal. Beri tahu apa yang terjadi selanjutnya, di halaman tempat mereka mendarat:

1. Atur baris sukses, atau halaman terima kasih Anda, untuk menyatakan ada email yang perlu dibuka: "Hampir selesai. Buka email yang kami kirim dan konfirmasi alamat Anda."
2. Sebutkan nama pengirim yang perlu mereka cari, dan sarankan folder spam jika tidak ada yang masuk dalam beberapa menit.
3. Di alat email, atur halaman yang dibuka tautan konfirmasi ke halaman "Anda sudah berlangganan" milik Anda sendiri, agar perjalanannya berakhir di situs Anda.

Checkbox persetujuan di formulir dan email konfirmasi menjalankan tugas berbeda. Checkbox mencatat bahwa seseorang menyatakan ya di halaman Anda. Klik membuktikan bahwa alamat itu milik orang yang menyatakan ya. Sebagian besar daftar menginginkan keduanya. Template formulir newsletter punya checkbox wajib itu.

Hal yang sering menjebak

• Subscriber yang sudah ada. Seseorang yang sudah terkonfirmasi mendaftar lagi dari halaman baru. Jangan kembalikan mereka ke status belum terkonfirmasi; halaman MailerLite menunjukkan relay yang mencari alamatnya lebih dulu.
• Orang yang sudah berhenti berlangganan. Pendaftaran tidak selalu berarti izin untuk membatalkan unsubscribe. beehiiv hanya mengaktifkan kembali saat Anda mengirim reactivate_existing: true, dan MailerLite hanya berlangganan ulang dengan resubscribe: true. Kirim keduanya hanya jika formulir menyatakannya.
• Pemindai tautan. Sebagian filter email perusahaan membuka tautan di email masuk untuk memeriksanya. Jika alat mengonfirmasi hanya dengan memuat halaman, pemindai bisa mengonfirmasi alamat yang tidak pernah diklik siapa pun. Periksa apakah halaman konfirmasi alat Anda meminta penekanan tombol.
• Deliverability. Konfirmasi adalah email pertama yang diterima pembaca dari Anda. Kirim dari domain yang terautentikasi di alat Anda, atau email itu masuk ke spam dan pendaftarannya tidak pernah selesai.
• Orang yang belum terkonfirmasi menumpuk. Mereka belum menjadi subscriber. Putuskan di alat Anda apakah akan mengirim pengingat, lalu biarkan saja.

Pastikan berfungsi

1. Kirim formulir dengan alamat milik Anda. Halaman meminta Anda memeriksa inbox.
2. Buka pengiriman di Webhooks di Ikiform. Statusnya succeeded dengan 204 dari relay.
3. Buka subscriber di alat email Anda. Statusnya unconfirmed, inactive, atau pending, tergantung alatnya.
4. Buka email konfirmasi dan klik. Subscriber menjadi aktif atau terkonfirmasi.
5. Kirim alamat yang sama lagi dalam sehari. Pengiriman menampilkan 200 dengan "Confirmation already requested today", dan tidak ada email kedua yang datang.
6. Daftarkan alamat yang sudah terkonfirmasi. Alamat itu tetap terkonfirmasi dan tidak mendapat email konfirmasi baru.

Pertanyaan