Email Service

Email Service nedir?

Her uygulama er ya da geç e-posta gönderir: şifre sıfırlama, sipariş onayı, uyarı bildirimi. Bunun için genelde üçüncü taraf bir sağlayıcıya abone olunur.

Cloudflare Email Service bu ihtiyacı aynı platform içinde karşılar. İki parçası vardır:

Nasıl çalışır?

Üç gönderim yolu

Yeni kod yazıyorsan binding veya REST API tercih et; SMTP daha çok eski uygulamaları taşımak için vardır.

Doğrulanmış hedefler ayrı bir kategori

Bu, fiyatlandırmanın en önemli ayrıntısıdır:

“Sends to verified destination addresses are free and do not count toward the included quota.”

Yani hesabında doğrulanmış bir adrese gönderim her planda ücretsizdir ve kotaya sayılmaz. Kendine sistem uyarısı göndermek, bir iç ekibe rapor yollamak gibi senaryolar bu kapsamda kalır. Ayrıca bu adreslere gönderimde mesaj boyutu sınırı 5 MiB yerine 25 MiB’dır.

Teslim edilebilirlik

Gönderim yapacağın alan adının doğrulanması gerekir. İşlemsel e-posta teslim edilebilirliği üç DNS kaydına dayanır:

Cloudflare kurulum sırasında gereken kayıtları panelde gösterir. Alan adın zaten Cloudflare DNS’inde ise kayıtlar tek tıkla eklenebilir.

Ne zaman kullanılır, ne zaman kullanılmaz

Uygun olduğu işler

• Şifre sıfırlama, doğrulama kodu, sipariş onayı gibi işlemsel e-postalar
• Sistem uyarıları ve iç bildirimler (özellikle doğrulanmış adreslere — ücretsiz)
• Gelen e-postayı bir Worker ile işleyip yanıtlayan akışlar
• Alan adındaki e-posta adreslerini mevcut kutuya yönlendirme (Email Routing)

Uygun olmadığı işler

• Ücretsiz plan. Giden e-posta kullanılamaz.
• Pazarlama e-postası ve bülten. Bu ürün işlemsel e-posta için tasarlandı; kampanya yönetimi, segmentasyon, açılma takibi gibi özellikler yok. Türkiye’de ticari elektronik ileti ayrıca İYS yükümlülüğü doğurur.
• Yüksek hacimli toplu gönderim. Günlük kota muhafazakâr başlar ve kademeli artar.
• Tek başına kritik yol. Beta olduğu için şifre sıfırlama gibi kritik akışlarda yedek sağlayıcı düşünmek gerekir.
• 50’den fazla alıcıya tek mesaj. Sınır sert; bölmek gerekir.

Somut örnekler

1. Worker’dan işlemsel e-posta

export default {
  async fetch(request, env) {
    const { eposta, kod } = await request.json();

    await env.EMAIL.send({
      from: { email: "bildirim@sirket.com", name: "Şirket" },
      to: [{ email: eposta }],
      subject: "Doğrulama kodunuz",
      text: `Doğrulama kodunuz: ${kod}\n\nBu kod 10 dakika geçerlidir.`,
      html: `<p>Doğrulama kodunuz: <strong>${kod}</strong></p>
             <p>Bu kod 10 dakika geçerlidir.</p>`,
    });

    return Response.json({ gonderildi: true });
  },
};

wrangler.jsonc:

{
  "name": "eposta-worker",
  "main": "src/index.ts",
  "compatibility_date": "2026-08-31",
  "send_email": [{ "name": "EMAIL" }]
}

2. Cloudflare dışından REST API ile

curl -X POST \
  "https://api.cloudflare.com/client/v4/accounts/$HESAP_ID/email/sending/send" \
  -H "Authorization: Bearer $CF_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "from": { "email": "bildirim@sirket.com", "name": "Şirket" },
    "to": [{ "email": "kullanici@ornek.com" }],
    "subject": "Siparişiniz onaylandı",
    "text": "Siparişiniz hazırlanıyor."
  }'

const res = await fetch(
  `https://api.cloudflare.com/client/v4/accounts/${HESAP_ID}/email/sending/send`,
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.CF_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      from: { email: "bildirim@sirket.com", name: "Şirket" },
      to: [{ email: "kullanici@ornek.com" }],
      subject: "Siparişiniz onaylandı",
      text: "Siparişiniz hazırlanıyor.",
    }),
  },
);
if (!res.ok) throw new Error(`e-posta gönderilemedi: ${res.status}`);

import os, requests

res = requests.post(
    f"https://api.cloudflare.com/client/v4/accounts/{HESAP_ID}/email/sending/send",
    headers={"Authorization": f"Bearer {os.environ['CF_TOKEN']}"},
    json={
        "from": {"email": "bildirim@sirket.com", "name": "Şirket"},
        "to": [{"email": "kullanici@ornek.com"}],
        "subject": "Siparişiniz onaylandı",
        "text": "Siparişiniz hazırlanıyor.",
    },
)
res.raise_for_status()

3. Kuyrukla toplu gönderim — alıcı sınırını aşmadan

50 alıcı sınırı sert olduğu için toplu bildirimler kuyruğa alınmalıdır.

export default {
  // Üretici: gönderilecekleri kuyruğa yaz
  async fetch(request, env) {
    const { alicilar, konu, govde } = await request.json();

    for (let i = 0; i < alicilar.length; i += 50) {
      await env.EPOSTA_KUYRUGU.send({
        grup: alicilar.slice(i, i + 50),
        konu,
        govde,
      });
    }
    return Response.json({ kuyruga_alindi: alicilar.length });
  },

  // Tüketici: her grubu tek mesajda gönder
  async queue(batch, env) {
    for (const mesaj of batch.messages) {
      const { grup, konu, govde } = mesaj.body;
      try {
        await env.EMAIL.send({
          from: { email: "bildirim@sirket.com", name: "Şirket" },
          to: grup.map((e) => ({ email: e })),   // en fazla 50
          subject: konu,
          text: govde,
        });
        mesaj.ack();
      } catch (h) {
        mesaj.retry();   // kuyruk yeniden dener
      }
    }
  },
};

4. Gelen e-postayı işleme

export default {
  async email(mesaj, env, ctx) {
    const gonderen = mesaj.from;
    const konu = mesaj.headers.get("subject") ?? "";

    // Destek talebi gibi görünüyorsa kaydet ve otomatik yanıt gönder
    if (konu.toLocaleLowerCase("tr").includes("destek")) {
      await env.DB.prepare(
        "INSERT INTO talepler (gonderen, konu, alindi) VALUES (?, ?, ?)",
      ).bind(gonderen, konu, Date.now()).run();

      await env.EMAIL.send({
        from: { email: "destek@sirket.com", name: "Destek" },
        to: [{ email: gonderen }],
        subject: `Re: ${konu}`,
        text: "Talebiniz alındı. En kısa sürede dönüş yapacağız.",
      });
      return;
    }

    // Diğerlerini insan ekibe ilet
    await mesaj.forward("ekip@sirket.com");
  },
};

Demo 1: Alan adı doğrulama ve ilk gönderim

Adım 1 — Alan adını Email Sending için yapılandır

Panel → Email → Email Sending → alan adı ekle.

Adım 2 — Binding’i tanımla ve gönder

npx wrangler deploy
curl -X POST https://<worker>/gonder \
  -H 'content-type: application/json' \
  -d '{"eposta":"test@ornek.com","kod":"123456"}'

Adım 3 — Teslim edilebilirlik başlıklarını incele

Gelen e-postanın kaynağını aç ve Authentication-Results başlığına bak.

Adım 4 — Panelde kullanımı izle

Demo 2: Gelen e-postayı işleyen akış

Adım 1 — Email Routing kuralı kur

Adım 2 — Worker’ın email handler’ını çalıştır

Adım 3 — Otomatik yanıtı doğrula

Adım 4 — Sınırları test et

51 alıcılı bir mesaj göndermeyi dene.

Ölçüm

Fiyatlandırma

Rakamlar 31 Ağustos 2026’da resmî dokümandan doğrulanmıştır.

Dahil kota abonelik faturalama döngüsüne göre hesap başına uygulanır. Reddedilen API gönderimleri — bastırma listesine takılanlar dahil — kotaya sayılmaz.

Limitler

Lisanslama ve hukuki çerçeve

Email Service tescilli bir hizmettir; Cloudflare Hizmet Şartları ve Kabul Edilebilir Kullanım Politikası kapsamındadır. İstenmeyen e-posta gönderimi politikaya aykırıdır.

Türkiye’ye özgü yükümlülük — İYS. Bu, e-posta gönderiminde Türkiye’de en çok gözden kaçan konudur ve Cloudflare bunu sağlamaz:

• İşlemsel e-posta (şifre sıfırlama, sipariş onayı, fatura) — kullanıcının kendi eylemine yanıt olarak gönderilir, ticari ileti sayılmaz.
• Ticari elektronik ileti (kampanya, bülten, tanıtım) — Türkiye’de İleti Yönetim Sistemi (İYS) kaydı, onay yönetimi ve ret hakkı sunma yükümlülüğü doğurur.

Bu ürün işlemsel e-posta için tasarlanmıştır. Ticari ileti gönderecekseniz İYS uyumluluğunu ayrıca çözmeniz gerekir.

Veri işleme. Gönderdiğiniz e-postaların içeriği ve alıcı adresleri Cloudflare üzerinden geçer. Kişisel veri içeriyorsa Veri İşleme Ek Sözleşmesi ve alt işleyici listesi incelenmelidir.

Sık yapılan hatalar

Ücretsiz planda gönderim beklemek. Giden e-posta Workers Paid gerektirir; ücretsiz planda yalnızca doğrulanmış hedeflere gönderim çalışır.

DNS kayıtlarını eksik bırakmak. SPF, DKIM veya DMARC eksikse mesajlar spam klasörüne düşer veya hiç teslim edilmez. Gönderim öncesi Authentication-Results başlığını mutlaka kontrol et.

50 alıcı sınırını fark etmemek. to, cc ve bcc toplamı 50’yi geçemez. Toplu bildirimde kuyruk kullan.

Büyük dosyaları ek olarak göndermek. 5 MiB sınırı düşüktür. Dosyayı R2’ye koyup imzalı bağlantı göndermek hem sınırı aşar hem teslim edilebilirliği artırır.

Bounce’ları yönetmemek. Kalıcı olarak bounce eden adreslere göndermeye devam etmek gönderim itibarını düşürür ve kotayı boşa harcar.

Beta ürünü kritik yolda tek başına kullanmak. Şifre sıfırlama gibi akışlarda yedek sağlayıcı düşünün.

İşlemsel ile ticari iletiyi karıştırmak. Türkiye’de ikincisi İYS yükümlülüğü doğurur ve bu ürün onu çözmez.