İşlemsel e-postalar, modern dijital iş süreçlerinin vazgeçilmez bir parçasıdır. Peki, sipariş onayı, parola sıfırlama veya hesap aktivasyonu gibi kritik bildirimlerinizin her zaman doğru alıcıya, doğru zamanda ve güvenli bir şekilde ulaştığından nasıl emin olursunuz? Bu rehber, Campaign Monitor’ın güçlü transactional e-posta özelliklerini sisteminize nasıl sorunsuz bir şekilde entegre edeceğinizi, minimal çabayla maksimum etki yaratacağınızı adım adım açıklıyor.

Neden İşlemsel E-postalar İşinizin Can Damarıdır ve Neden Öncelik Verilmelidir?

Dijital dünyada, müşterilerinizle olan her etkileşim anlık ve sorunsuz olmalıdır. Bir e-ticaret sitesinde tamamlanan bir siparişin ardından gelen “Siparişiniz Onaylandı” e-postası, bir kullanıcının unuttuğu şifresini sıfırlamak için talep ettiği link veya yeni bir üyeliğin aktivasyon linki… Tüm bu iletişimler, pazarlama e-postalarından farklı olarak, doğrudan bir eylem veya tetikleyici sonucunda gönderilen ve genellikle zaman açısından kritik olan bildirimlerdir. Bu tür e-postalara “işlemsel” veya “transactional” e-postalar denir.

İşlemsel e-postaların önemi, sadece teknik bir gereklilik olmaktan çok öteye gider. Müşteri deneyiminin doğrudan kalbini oluştururlar. Geciken veya hiç ulaşmayan bir parola sıfırlama e-postası, kullanıcının sitenize erişimini engeller ve doğrudan hayal kırıklığına yol açar. Benzer şekilde, bir sipariş onayının gecikmesi veya kaybolması, müşterinin endişelenmesine, destek hattınızı meşgul etmesine ve nihayetinde markanıza olan güvenini sarsmasına neden olabilir. Bu senaryolar, işletmeler için sadece operasyonel bir aksaklık değil, aynı zamanda ciddi itibar kayıplarına ve gelir düşüşlerine yol açabilecek potansiyel krizlerdir.

Pazarlama e-postaları genellikle daha geniş kitlelere ulaşmayı ve ürün/hizmet tanıtımını amaçlarken, işlemsel e-postalar birebir, kişiselleştirilmiş ve genellikle zorunlu bir iletişimi temsil eder. Bu nedenle, onların teslim edilebilirliği, hızı ve güvenilirliği son derece kritik öneme sahiptir. Campaign Monitor gibi profesyonel bir e-posta servis sağlayıcısının işlemsel e-posta hizmetleri, bu zorlukların üstesinden gelmek için özel olarak tasarlanmıştır. Yüksek teslim edilebilirlik oranları, hızlı gönderim altyapısı ve detaylı raporlama özellikleri sayesinde, kritik bildirimlerinizin her zaman hedefine ulaştığından emin olabilirsiniz. Bu, sadece müşteri memnuniyetini artırmakla kalmaz, aynı zamanda destek maliyetlerinizi düşürür ve işletmenizin profesyonel imajını pekiştirir. Dolayısıyla, işlemsel e-postaların doğru bir şekilde entegre edilmesi ve yönetilmesi, modern bir dijital işletmenin temel taşlarından biridir. Bu rehber boyunca, Campaign Monitor’ın bu alandaki gücünü nasıl kullanacağınızı ve işletmenizin iletişim süreçlerini nasıl optimize edeceğinizi detaylıca inceleyeceğiz.

Campaign Monitor Akıllı E-postaları (Transactional) Tam Olarak Nedir ve Ne İşe Yarar?

Campaign Monitor, geniş yelpazede e-posta pazarlama hizmetleri sunarken, “Smart Emails” olarak adlandırdığı işlemsel e-posta çözümüyle de öne çıkmaktadır. Peki, bu “Smart Emails” tam olarak nedir ve işletmenize ne gibi faydalar sağlar? Temelde, Smart Emails, API veya SMTP aracılığıyla tetiklenen, belirli bir olay veya kullanıcı eylemi sonucunda gönderilen otomatikleştirilmiş e-postalardır. Pazarlama e-postalarından temel farkı, hedef kitlesine ürün veya hizmet satmak yerine, kullanıcının beklediği veya ihtiyaç duyduğu spesifik bir bilgiyi anında sağlamasıdır.

Bu e-postaların en belirgin özelliği, yüksek teslim edilebilirlik oranları ve gönderim hızıdır. Gelen kutusuna düşme oranları, pazarlama e-postalarına kıyasla çok daha yüksektir çünkü spam filtreleri tarafından genellikle daha az riskli görülürler. Bu durum, kritik mesajlarınızın alıcıya ulaşma garantisini büyük ölçüde artırır. Campaign Monitor’ın altyapısı, bu e-postaların saniyeler içinde gönderilmesini sağlayarak, kullanıcı deneyimini kesintisiz hale getirir. Örneğin, bir müşteri online bir satın alma işlemi yaptığında, sipariş onay e-postasının anında gelmesi, onlara güven verir ve sürecin sorunsuz ilerlediğini gösterir. Bu anlık geri bildirim, müşteri memnuniyetini artıran en önemli faktörlerden biridir.

Smart Emails’in sunduğu bir diğer önemli avantaj da kişiselleştirme yeteneğidir. Her ne kadar şablonlar kullanılıyor olsa da, dinamik içerik ekleyerek her bir e-postayı alıcıya özel hale getirebilirsiniz. Bir sipariş onayı e-postasında müşterinin adını, sipariş numarasını, satın aldığı ürünleri ve kargo bilgilerini otomatik olarak göstermek mümkündür. Bu, alıcının e-postayla daha fazla etkileşim kurmasını sağlar ve iletişimin değerini artırır. Campaign Monitor’ın sezgisel şablon motoru sayesinde, bu tür kişiselleştirmeleri teknik bilgi gerektirmeden kolayca yapabilirsiniz. Şablonlar, HTML ve CSS bilgisi olanlar için tamamen özelleştirilebilirken, sürükle-bırak arayüzü sayesinde tasarım bilgisi olmayanlar da profesyonel görünümlü e-postalar oluşturabilir.

Peki, Smart Emails hangi senaryolarda kullanılır? İşletmenizin türüne ve ihtiyaçlarına göre sayısız kullanım alanı mevcuttur. En yaygın kullanım senaryolarından bazıları şunlardır:

• E-ticaret: Sipariş onayı, kargo takibi, ürün iade bildirimleri, sepet terk etme hatırlatıcıları (eğer transactional nitelikteyse).
• SaaS Uygulamaları: Hesap aktivasyonu, parola sıfırlama, abonelik yenileme bildirimleri, kota aşımı uyarıları, yeni özellik duyuruları.
• Online Hizmetler: Rezervasyon onayları, randevu hatırlatmaları, bilet gönderimi, hizmet durumu güncellemeleri.
• Üyelik Siteleri: Yeni üyelik hoş geldin e-postaları, profil güncellemeleri, üyelik yenileme uyarıları.
• Finansal Hizmetler: İşlem bildirimleri, fatura gönderimi, ödeme hatırlatmaları.

Her bir senaryoda, e-postanın hızlı, doğru ve kişiselleştirilmiş olması kritik önem taşır. Campaign Monitor’ın Smart Emails çözümü, bu gereksinimleri karşılamak için güçlü bir altyapı sunar. Raporlama ve analiz özellikleri sayesinde, gönderilen e-postaların açılma, tıklanma ve teslim edilebilirlik oranlarını izleyebilir, böylece e-posta performansınızı sürekli olarak optimize edebilirsiniz. Bu detaylı geri bildirim, stratejilerinizi geliştirmeniz için değerli içgörüler sağlar. Sonuç olarak, Campaign Monitor Smart Emails, işletmenizin operasyonel verimliliğini artıran, müşteri memnuniyetini yükselten ve marka güvenilirliğini pekiştiren güçlü bir iletişim aracıdır.

Entegrasyona Başlamadan Önce Bilmeniz Gereken Temel Adımlar Nelerdir?

Campaign Monitor’ın Smart Emails özelliğini sisteminize entegre etmeye başlamadan önce atmanız gereken bazı kritik adımlar ve bilmeniz gereken temel kavramlar vardır. Bu ön hazırlıklar, entegrasyon sürecini sorunsuz hale getirecek ve olası aksaklıkları minimize edecektir. İlk olarak, bir Campaign Monitor hesabına sahip olmanız ve işlemsel e-posta gönderimi için uygun planı seçmeniz gerekmektedir. Genellikle Campaign Monitor, pazarlama ve işlemsel e-postaları farklı faturalandırma modelleriyle sunar, bu yüzden ihtiyaçlarınıza uygun paketi doğruladığınızdan emin olun.

1. Campaign Monitor Hesabı Oluşturma ve Yapılandırma:

   Eğer henüz bir hesabınız yoksa, Campaign Monitor web sitesi üzerinden bir hesap oluşturmalısınız. Mevcut bir hesabınız varsa, işlemsel e-posta göndermek için gerekli izinlerin ve limitlerin doğru yapılandırıldığından emin olun. Campaign Monitor kontrol panelinde, “Transactional Emails” veya “Smart Emails” bölümüne erişiminizin olduğundan emin olmalısınız. Buradan gönderim domaininizi (alan adınızı) eklemeniz gerekecektir.

2. API Anahtarları ve SMTP Ayarları Nasıl Elde Edilir?

   Entegrasyonun temelini kimlik doğrulama oluşturur. Campaign Monitor, e-posta göndermek için iki ana yöntem sunar: API (Uygulama Programlama Arayüzü) ve SMTP (Basit Posta Aktarım Protokolü). Her iki yöntemde de kimlik doğrulaması için belirli bilgilere ihtiyacınız olacaktır:

   • API Anahtarı (API Key): Bu, sisteminizin Campaign Monitor API’sine güvenli bir şekilde erişmesini sağlayan benzersiz bir koddur. Campaign Monitor hesabınızın “Account Settings” veya “API Keys” bölümünden bu anahtarı bulabilir veya oluşturabilirsiniz. Bu anahtarı asla açıkça paylaşmamalı ve güvenli bir şekilde saklamalısınız.
   • SMTP Kullanıcı Adı ve Şifresi: Eğer SMTP üzerinden gönderim yapacaksanız, Campaign Monitor’ın sağladığı SMTP sunucu adresine, kullanıcı adına ve şifresine ihtiyacınız olacaktır. Bu bilgiler genellikle “Transactional Emails” veya “SMTP Settings” kısmında bulunur. Yine, bu bilgileri çok gizli tutmalısınız.
   Uzman İpucu: API anahtarlarınızı doğrudan kod içine gömmek yerine, ortam değişkenleri (environment variables) veya güvenli bir yapılandırma servisi kullanarak saklayın. Bu, güvenliği artırır ve farklı ortamlar arasında (geliştirme, test, üretim) kolayca geçiş yapmanızı sağlar.
3. Alan Adı Doğrulama (Sender Domain Verification – DKIM, SPF):

   E-postaların spam olarak işaretlenmesini önlemek ve yüksek teslim edilebilirlik sağlamak için gönderici alan adınızı doğrulamanız şarttır. Bu süreç, DNS kayıtlarınıza belirli TXT kayıtları eklemeyi gerektirir:

   • SPF (Sender Policy Framework): Gönderici alan adınız adına e-posta göndermeye yetkili sunucuları belirten bir TXT kaydıdır. Campaign Monitor’ın belirttiği SPF kaydını (örn. v=spf1 include:spf.mandrillapp.com ~all benzeri) DNS ayarlarınıza eklemelisiniz.
   • DKIM (DomainKeys Identified Mail): E-postaların gönderici tarafından yetkilendirildiğini ve taşıma sırasında değiştirilmediğini doğrulayan bir dijital imzadır. Campaign Monitor, size belirli bir DKIM kaydı (genellikle uzun bir anahtar içeren bir TXT kaydı) verecektir. Bu kaydı da DNS ayarlarınıza eklemelisiniz.

   Bu kayıtları ekledikten sonra Campaign Monitor paneli üzerinden doğrulama işlemini başlatmalısınız. Doğrulama birkaç saat sürebilir. Bu adım, e-postalarınızın spam klasörüne düşmesini önlemek ve marka itibarınızı korumak için hayati önem taşır.

4. Şablon Oluşturma ve Yönetimi:

   İşlemsel e-postalarınızın tutarlı bir görünüme sahip olması ve kişiselleştirilebilir olması için Campaign Monitor içinde şablonlar oluşturmanız gerekecektir. Bu şablonlar, temel HTML ve CSS yapısını içerir ve dinamik içerik eklemek için yer tutucular (placeholder’lar) barındırır. Örneğin, bir sipariş onay şablonunda [client.name], [order.id] gibi yer tutucular kullanabilirsiniz. Gönderim sırasında bu yer tutucular, API veya SMTP çağrısıyla gönderilen verilerle otomatik olarak doldurulur.

   Campaign Monitor’ın görsel şablon oluşturucusunu kullanabilir veya özel HTML/CSS kodunuzu doğrudan yükleyebilirsiniz. Mobil uyumluluk ve duyarlı tasarım prensiplerini göz önünde bulundurarak şablonlarınızı oluşturmanız, farklı cihazlardan erişen kullanıcılar için sorunsuz bir deneyim sunacaktır.

Bu temel adımları tamamladıktan sonra, artık sisteminizden Campaign Monitor aracılığıyla işlemsel e-postalar göndermeye hazırsınız. Her bir adımın doğru ve eksiksiz yapılması, entegrasyonun başarısı için kilit rol oynar.

Campaign Monitor API’sini Kullanarak İşlemsel E-postalar Nasıl Gönderilir?

Campaign Monitor API’si, uygulamanızın Campaign Monitor ile doğrudan ve programatik olarak iletişim kurmasını sağlayan güçlü bir araçtır. Özellikle büyük hacimli gönderimler, karmaşık kişiselleştirme ihtiyaçları veya özel entegrasyonlar için idealdir. API, RESTful prensiplerine uygun olarak tasarlanmıştır ve HTTP istekleriyle çalışır. Bu bölümde, Python kullanarak Campaign Monitor API’si aracılığıyla işlemsel bir e-posta göndermek için adım adım bir rehber sunacağız.

Adım 1: Gerekli Kütüphaneyi Kurma

Python için Campaign Monitor’ın resmi veya topluluk tarafından geliştirilmiş bir API istemci kütüphanesi kullanmak işinizi kolaylaştıracaktır. Örnek olarak, campaignmonitor veya benzeri bir kütüphaneyi pip ile kurabilirsiniz:

pip install campaignmonitor

Eğer resmi bir Python kütüphanesi yoksa veya daha genel bir yaklaşım tercih ediyorsanız, requests kütüphanesi ile HTTP POST istekleri göndererek de API'ye erişebilirsiniz.

Adım 2: API Anahtarınızı Yapılandırma

Daha önce edindiğiniz API anahtarınızı kodunuzda kullanmanız gerekecek. Güvenlik nedenleriyle, doğrudan kod içine gömmek yerine ortam değişkenlerinden almanızı şiddetle tavsiye ederiz.

import os
from campaignmonitor import CampaignMonitorAPI

# Ortam değişkeninden API anahtarını al
API_KEY = os.environ.get("CAMPAIGN_MONITOR_API_KEY", "YOUR_API_KEY_HERE")
TRANSACTIONAL_EMAIL_CLIENT_ID = os.environ.get("CAMPAIGN_MONITOR_TRANSACTIONAL_CLIENT_ID", "YOUR_TRANSACTIONAL_CLIENT_ID_HERE")

# Campaign Monitor API istemcisini başlat
cm_api = CampaignMonitorAPI(api_key=API_KEY)

Burada TRANSACTIONAL_EMAIL_CLIENT_ID, genellikle Campaign Monitor hesabınızdaki Transactional Email hizmetinize ait bir kimliktir ve bazı API çağrılarında gereklidir.

Adım 3: E-posta Şablonunuzu Hazırlama ve Gerekli Bilgileri Toplama

Campaign Monitor'da oluşturduğunuz bir işlemsel e-posta şablonuna ihtiyacınız olacak. Bu şablonun bir "Template ID" veya "Smart Email ID" değeri olacaktır. Ayrıca, e-postayı göndereceğiniz alıcının e-posta adresi ve şablondaki yer tutucuları dolduracak kişiselleştirilmiş veriler (custom fields) gereklidir. Örneğin, bir sipariş onay e-postası için müşteri adı, sipariş numarası, ürünler listesi gibi veriler.

# Gönderilecek e-posta bilgileri
recipient_email = "alicierol@example.com"
recipient_name = "Alici Erol"
smart_email_id = "YOUR_SMART_EMAIL_ID" # Campaign Monitor'daki şablonunuzun ID'si

# Şablondaki yer tutucuları dolduracak kişiselleştirilmiş veriler
custom_fields = {
    "CustomerName": recipient_name,
    "OrderID": "CM-12345",
    "ProductList": [
        {"Name": "Akıllı Saat", "Quantity": 1, "Price": 1500.00},
        {"Name": "Bluetooth Kulaklık", "Quantity": 2, "Price": 800.00}
    ],
    "ShippingAddress": "Örnek Mah. Örnek Cad. No:1, İstanbul",
    "TotalAmount": 3100.00
}

custom_fields içindeki anahtarların, Campaign Monitor şablonunuzdaki yer tutucularla (örn. [CustomerName]) eşleştiğinden emin olun. Listeler veya karmaşık nesneler için Campaign Monitor'ın tekrarlayıcı (repeater) alanlarını veya JSON tabanlı veri bağlama yeteneklerini kullanmanız gerekebilir.

Adım 4: İşlemsel E-postayı Gönderme

Şimdi, send_transactional_email veya benzeri bir metod kullanarak e-postayı gönderme işlemini gerçekleştirebiliriz. Bu metod, smart_email_id, alıcı bilgileri ve custom_fields'ı parametre olarak alacaktır.

# Basitleştirilmiş bir API istemci varsayımı ile örnek gönderim
def send_smart_email(client_id, smart_email_id, recipient_email, recipient_name, custom_fields):
    headers = {
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json"
    }
    payload = {
        "To": recipient_email,
        "Data": custom_fields,
        "TemplateID": smart_email_id,
        "Client" : client_id # Transactional e-postalar için gerekli olabilir
    }
    # Campaign Monitor'ın belirli bir endpoint'ine POST isteği
    # Bu URL, Campaign Monitor API dokümantasyonundan alınmalıdır.
    # Örnek: "https://api.createsend.com/api/v3.2/transactional/smartemail/{smart_email_id}/send"
    
    # Kütüphane kullanımı daha temiz olacaktır:
    try:
        # Kütüphane kullanımına uygun bir örnek (varsayımsal)
        response = cm_api.transactional.send_smart_email(
            client_id=TRANSACTIONAL_EMAIL_CLIENT_ID,
            smart_email_id=smart_email_id,
            to=recipient_email,
            data=custom_fields,
            from_name="Destek Ekibi", # Gerekliyse eklenebilir
            subject="Sipariş Onayınız [OrderID] - Teşekkür Ederiz!", # Gerekliyse eklenebilir
        )
        if response.status_code == 200:
            print(f"E-posta {recipient_email} adresine başarıyla gönderildi.")
            print(response.json())
        else:
            print(f"E-posta gönderilirken bir hata oluştu: {response.status_code} - {response.text}")
    except Exception as e:
        print(f"E-posta gönderiminde istisna oluştu: {e}")

# Fonksiyonu çağır
send_smart_email(TRANSACTIONAL_EMAIL_CLIENT_ID, smart_email_id, recipient_email, recipient_name, custom_fields)

Yukarıdaki kod bloğu, Campaign Monitor API'sine HTTP POST isteği göndermek için genel bir yapıyı göstermektedir. Gerçek API istemci kütüphanesi kullanımında bu adımlar daha soyutlanmış ve kullanımı daha kolay olacaktır. Önemli olan, API anahtarınızı, Smart Email ID'nizi ve doğru biçimde hazırlanmış dinamik veriyi (custom_fields) doğru endpoint'e göndermektir. Başarılı bir gönderimde, Campaign Monitor API'si genellikle bir başarı mesajı ve gönderilen e-postanın kimliğini içeren bir yanıt döndürür. Hataları ele almak için try-except blokları kullanmak ve API yanıtlarını kontrol etmek, uygulamanızın dayanıklılığı için hayati önem taşır. Bu sayede, işlemsel e-postalarınızı uygulamanızın tetikleyici olaylarına entegre ederek otomatik ve kişiselleştirilmiş iletişim akışları oluşturabilirsiniz.

SMTP Entegrasyonu ile Daha Hızlı ve Basit Gönderim Nasıl Yapılır?

Campaign Monitor API'sini kullanmak karmaşık otomasyonlar ve detaylı kontrol için ideal olsa da, çoğu durumda, özellikle basit ve hızlı işlemsel e-posta gönderimleri için SMTP (Simple Mail Transfer Protocol) entegrasyonu çok daha kolay ve pratik bir çözüm sunar. SMTP, e-posta gönderimi için endüstri standardı bir protokoldür ve neredeyse tüm programlama dilleri ile framework'ler tarafından desteklenir. Bu yöntemle, Campaign Monitor'ı tıpkı normal bir e-posta sunucusu gibi kullanır ve e-postalarınızı doğrudan uygulamanızdan gönderirsiniz.

SMTP Neden Tercih Edilir?

SMTP entegrasyonunun başlıca avantajları şunlardır:

• Kolaylık: Çoğu geliştirici, e-posta göndermek için SMTP'ye aşinadır. Mevcut e-posta gönderme kütüphaneleri veya framework'lerin yerleşik fonksiyonları kolayca adapte edilebilir.
• Hız: Doğrudan e-posta sunucusuyla iletişim kurduğu için API çağrılarına kıyasla bazı senaryolarda daha hızlı olabilir (özellikle kütüphane bağımlılığı daha az olduğu durumlarda).
• Düşük Bağımlılık: Özel bir API istemci kütüphanesine bağımlı kalmazsınız, bu da uygulamanızın genel bağımlılık grafiğini basitleştirebilir.

Campaign Monitor SMTP Ayarları

Campaign Monitor hesabınızda "Transactional Emails" veya "Smart Emails" bölümünde, SMTP ayarlarınızı bulabilirsiniz. Tipik olarak aşağıdaki bilgilere ihtiyacınız olacaktır:

• SMTP Sunucu Adresi: Genellikle smtp.createsend.com veya benzeri bir adres.
• Port: Genellikle TLS/SSL için 587 veya 465.
• Kullanıcı Adı: Campaign Monitor tarafından sağlanan özel bir kullanıcı adı (genellikle API anahtarınız veya özel bir kimlik).
• Şifre: Campaign Monitor tarafından sağlanan özel bir şifre (genellikle API anahtarınızla aynı veya ayrı bir anahtar).

Farklı Programlama Dilleri İçin SMTP Örnekleri

Aşağıda, popüler bazı programlama dillerinde SMTP ile Campaign Monitor üzerinden e-posta gönderme örnekleri yer almaktadır.

1. Python ile SMTP E-posta Gönderimi

Python'da smtplib kütüphanesi ile kolayca e-posta gönderebilirsiniz. Kişiselleştirilmiş verileri e-posta içeriğine dinamik olarak ekleyerek Campaign Monitor şablonlarında doldurabilirsiniz. HTML içeriği göndermek için email.mime.text modülünü kullanacağız.

import smtplib
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart
import os

# Campaign Monitor SMTP Bilgileri (Ortam değişkenlerinden alınması önerilir)
SMTP_SERVER = os.environ.get("CM_SMTP_SERVER", "smtp.createsend.com")
SMTP_PORT = int(os.environ.get("CM_SMTP_PORT", 587))
SMTP_USERNAME = os.environ.get("CM_SMTP_USERNAME", "YOUR_CM_SMTP_USERNAME")
SMTP_PASSWORD = os.environ.get("CM_SMTP_PASSWORD", "YOUR_CM_SMTP_PASSWORD")

sender_email = "no-reply@example.com"
receiver_email = "alicierol@example.com"
subject = "Sipariş Onayı: #[OrderID]" # Campaign Monitor şablonunuzda bu yer tutucu kullanılabilir

# Campaign Monitor şablonundaki yer tutucular için HTML içeriği
# Bu kısım, Campaign Monitor'da tanımladığınız şablonun içeriğini yansıtmalıdır.
# Campaign Monitor, bu HTML içindeki [YerTutucu] ifadelerini gönderdiğiniz JSON veri ile dolduracaktır.
html_body = f"""\

  
    
Merhaba, [CustomerName]!
    
Siparişiniz #[OrderID] başarıyla alındı ve işleniyor.
    
Ürünleriniz:
    

      
      
Akıllı Saat (1 adet) - 1500.00 TL
      
Bluetooth Kulaklık (2 adet) - 1600.00 TL
    
    
Toplam Tutar: [TotalAmount] TL
    
Kargo Adresi: [ShippingAddress]
    
Bizi tercih ettiğiniz için teşekkür ederiz!
  

"""

# JSON veri payload'ı
# Bu veriler, Campaign Monitor tarafından e-posta içeriğindeki yer tutucularla eşleştirilir.
# Önemli: SMTP ile gönderirken bu JSON'ı e-posta gövdesine eklemeniz gerekir.
# Campaign Monitor, e-posta içeriğini (text/html) ayrıştırarak bu veriyi bulur.
# Bu format genellikle bir özel header (ör. X-CM-Data) veya e-posta gövdesinin belirli bir bölümü olarak gönderilir.
# Ancak Campaign Monitor'ın transactional API'si, SMTP üzerinden JSON veri yüklemeyi doğrudan desteklemeyebilir,
# daha çok şablonlar içindeki özel alanları doldurmak için tasarlanmıştır.
# Bu örnekte, yer tutucular HTML içinde gösterilmiştir ve Campaign Monitor'ın bu yer tutucuları otomatik doldurduğu varsayılmıştır.
# Ancak, eğer doğrudan veri göndermek gerekiyorsa, bu genellikle API ile yapılır.
# SMTP ile en yaygın kullanım, zaten oluşturulmuş bir şablonu (Smart Email) tetiklemektir.
# Eğer şablondaki yer tutucuları doldurmak istiyorsanız, e-posta içeriğine Campaign Monitor'ın beklediği özel başlıkları veya gövde formatını eklemeniz gerekebilir.
# Campaign Monitor dökümantasyonunu kontrol etmek en doğrusudur.
# Basitlik adına, burada Campaign Monitor'ın otomatik olarak şablondaki [YerTutucu] değerlerini doldurduğunu varsayıyoruz.

# MIMEText objesi oluşturma
message = MIMEMultipart("alternative")
message["From"] = sender_email
message["To"] = receiver_email
message["Subject"] = subject

# E-posta gövdesini HTML olarak ekle
message.attach(MIMEText(html_body, "html"))

try:
    with smtplib.SMTP(SMTP_SERVER, SMTP_PORT) as server:
        server.starttls()  # TLS güvenliğini başlat
        server.login(SMTP_USERNAME, SMTP_PASSWORD)
        server.sendmail(sender_email, receiver_email, message.as_string())
    print(f"E-posta {receiver_email} adresine başarıyla gönderildi.")
except Exception as e:
    print(f"E-posta gönderiminde hata oluştu: {e}")

2. Node.js ile SMTP E-posta Gönderimi (Nodemailer Kullanımı)

Node.js ortamında nodemailer kütüphanesi, SMTP ile e-posta göndermek için popüler ve kullanımı kolay bir çözümdür.

const nodemailer = require('nodemailer');
require('dotenv').config(); // Ortam değişkenlerini yüklemek için

// Campaign Monitor SMTP Bilgileri
const smtpServer = process.env.CM_SMTP_SERVER || "smtp.createsend.com";
const smtpPort = process.env.CM_SMTP_PORT || 587;
const smtpUsername = process.env.CM_SMTP_USERNAME || "YOUR_CM_SMTP_USERNAME";
const smtpPassword = process.env.CM_SMTP_PASSWORD || "YOUR_CM_SMTP_PASSWORD";

const senderEmail = "no-reply@example.com";
const receiverEmail = "alicierol@example.com";
const subject = "Sipariş Onayı: #[OrderID]"; // Campaign Monitor şablonunuzda bu yer tutucu kullanılabilir

// Campaign Monitor şablonundaki yer tutucular için HTML içeriği
const htmlBody = 
  
    
Merhaba, [CustomerName]!
    
Siparişiniz #[OrderID] başarıyla alındı ve işleniyor.
    
Ürünleriniz:
    

      
Akıllı Saat (1 adet) - 1500.00 TL
      
Bluetooth Kulaklık (2 adet) - 1600.00 TL
    
    
Toplam Tutar: [TotalAmount] TL
    
Kargo Adresi: [ShippingAddress]
    
Bizi tercih ettiğiniz için teşekkür ederiz!
  
;

async function sendTransactionalEmail() {
  let transporter = nodemailer.createTransport({
    host: smtpServer,
    port: smtpPort,
    secure: false, // true for 465, false for other ports
    auth: {
      user: smtpUsername,
      pass: smtpPassword,
    },
    tls: {
      ciphers:'SSLv3'
    }
  });

  try {
    let info = await transporter.sendMail({
      from: "${senderEmail}" <${senderEmail}>, // sender address
      to: receiverEmail, // list of receivers
      subject: subject, // Subject line
      html: htmlBody, // html body
      // Campaign Monitor ile SMTP üzerinden dinamik veri göndermek için
      // genellikle özel başlıklar (custom headers) kullanılır veya şablonun kendisi veriyi ayrıştırır.
      // Örneğin: 'X-CM-CustomerName': 'Alici Erol', 'X-CM-OrderID': 'CM-12345'
      // Daha kesin bilgi için Campaign Monitor dokümantasyonuna bakınız.
    });
    console.log("E-posta başarıyla gönderildi: %s", info.messageId);
  } catch (error) {
    console.error("E-posta gönderiminde hata oluştu:", error);
  }
}

sendTransactionalEmail();

Her iki örnekte de, [YerTutucu] formatındaki ifadelerin Campaign Monitor şablonunuzda tanımlı olması ve Campaign Monitor'ın bu yer tutucuları otomatik olarak dolduracak şekilde yapılandırıldığından emin olmanız gerekmektedir. Eğer şablona dinamik veri eklemeniz gerekiyorsa, Campaign Monitor'ın transactional e-posta dokümantasyonunu kontrol ederek SMTP üzerinden özel başlıklar veya belirli bir JSON formatını nasıl göndermeniz gerektiğini öğrenmelisiniz. Genellikle, basit metin veya HTML e-postaları doğrudan gönderilirken, Campaign Monitor tarafında önceden oluşturulmuş bir şablonun tetiklenmesi ve içindeki yer tutucuların doldurulması tercih edilen yöntemdir. Bu yöntem, uygulamanızın e-posta gönderme mantığını basitleştirir ve Campaign Monitor'ın güçlü teslim edilebilirlik altyapısından tam olarak yararlanmanızı sağlar.

Mobil Uyumlu ve Duyarlı E-posta Şablonları Nasıl Oluşturulur?

Günümüzde kullanıcıların büyük bir çoğunluğu e-postalarını mobil cihazlarından kontrol ediyor. Bu nedenle, işlemsel e-postalarınızın da mobil uyumlu ve duyarlı olması, müşteri deneyimi açısından hayati öneme sahiptir. Bozuk görüntüler, okunaksız metinler veya kayan düzenler, markanızın profesyonelliğine gölge düşürür ve kullanıcının kritik bilgiyi almasını zorlaştırır. Campaign Monitor, bu konuda size yardımcı olacak araçlar sunsa da, temel prensipleri bilmek ve şablonlarınızı buna göre tasarlamak büyük fark yaratır.

E-posta Tasarımında Duyarlılık Neden Önemli?

Duyarlı e-posta tasarımı, e-postanızın içeriğinin ve düzeninin, görüntülendiği cihazın ekran boyutuna göre otomatik olarak ayarlanması anlamına gelir. Masaüstü, tablet veya akıllı telefon fark etmeksizin, e-postanızın her cihazda estetik ve işlevsel olmasını sağlar. Bu, yalnızca daha iyi bir görsel deneyim sunmakla kalmaz, aynı zamanda kullanıcının e-postadaki önemli bilgilere (örn. sipariş detayı, parola sıfırlama düğmesi) kolayca erişmesini sağlar.

Duyarlı Tasarımın Temel Prensipleri ve HTML & CSS İpuçları

E-posta şablonları tasarlarken dikkat etmeniz gereken bazı temel prensipler ve teknik ipuçları şunlardır:

1. Tablo Bazlı Düzen (Table-Based Layouts):

   Web tasarımı modern CSS Grid ve Flexbox'a geçerken, e-posta şablonları hala

   tabanlı düzenleri kullanma eğilimindedir. Bunun nedeni, farklı e-posta istemcilerinin (Outlook, Gmail, Apple Mail vb.) CSS desteğinin tutarsız olmasıdır. Tablolar, en geniş istemci yelpazesinde tutarlı bir düzen sağlar. İç içe tablolar kullanarak karmaşık düzenler oluşturabilirsiniz.

   Sipariş Onayınız Merhaba, [CustomerName]! Siparişiniz #[OrderID] başarıyla alındı.

2. Inline CSS Kullanımı:

   E-posta istemcilerinin çoğu,

   Yukarıdaki @media sorgusu, ekran genişliği 600 pikselin altına düştüğünde .container sınıfına sahip tabloların genişliğini %100'e çıkarır ve iki sütunlu düzenleri tek sütuna dönüştürür. Bu şekilde, içeriğiniz mobil cihazlarda daha okunaklı ve düzenli görünür.

3. Basit ve Okunaklı Fontlar:

   Tüm e-posta istemcilerinde desteklenen web-safe fontlar (Arial, Helvetica, Tahoma, Georgia, Times New Roman vb.) kullanın. Font boyutlarının mobil cihazlarda da rahat okunabilir olduğundan emin olun (genellikle 14-16px arası). Satır aralığını (line-height) artırmak da okunaklığı geliştirir.

4. CTA Butonlarının Görünürlüğü:

   E-postanızdaki harekete geçirici mesaj (Call-to-Action - CTA) butonları, mobil cihazlarda da kolayca tıklanabilir büyüklükte olmalı ve yeterli boşluğa sahip olmalıdır. Genellikle display: block; ve padding kullanarak geniş, dokunması kolay butonlar oluşturabilirsiniz.

import os
from campaignmonitor import CampaignMonitorAPI # Varsayımsal kütüphane
import json

# Ortam değişkenlerinden API anahtarı ve istemci ID'si
API_KEY = os.environ.get("CAMPAIGN_MONITOR_API_KEY")
TRANSACTIONAL_EMAIL_CLIENT_ID = os.environ.get("CAMPAIGN_MONITOR_TRANSACTIONAL_CLIENT_ID")
ORDER_CONFIRMATION_SMART_EMAIL_ID = "YOUR_ORDER_CONF_TEMPLATE_ID" # Campaign Monitor'dan alınacak

cm_api = CampaignMonitorAPI(api_key=API_KEY)

def send_order_confirmation_email(order_data):
    """
    Sipariş verilerini kullanarak Campaign Monitor üzerinden sipariş onayı e-postası gönderir.
    :param order_data: Müşteri ve sipariş detaylarını içeren bir sözlük.
    """
    try:
        recipient_email = order_data["customer_email"]
        recipient_name = order_data["customer_name"]
        
        # Campaign Monitor şablonundaki yer tutuculara eşleşecek dinamik veriler
        # Bu anahtarlar Campaign Monitor'daki şablonunuzda tanımlanmalıdır (örn. [CustomerName])
        custom_fields = {
            "CustomerName": recipient_name,
            "OrderID": order_data["order_id"],
            "ProductList": [
                {"Name": item["name"], "Quantity": item["quantity"], "Price": item["price"]}
                for item in order_data["items"]
            ],
            "ShippingAddress": order_data["shipping_address"],
            "TotalAmount": order_data["total_amount"]
        }

        # API çağrısı ile e-postayı gönder
        response = cm_api.transactional.send_smart_email(
            client_id=TRANSACTIONAL_EMAIL_CLIENT_ID,
            smart_email_id=ORDER_CONFIRMATION_SMART_EMAIL_ID,
            to=recipient_email,
            data=custom_fields,
            from_name="Trend Alışveriş Destek",
            subject=f"Siparişiniz Onaylandı: #{order_data['order_id']} - Trend Alışveriş"
        )

        if response.status_code == 200:
            print(f"Sipariş onayı e-postası {recipient_email} adresine başarıyla gönderildi. Mesaj ID: {response.json().get('MessageID')}")
            return True
        else:
            print(f"E-posta gönderilirken hata oluştu ({response.status_code}): {response.text}")
            return False

    except Exception as e:
        print(f"Sipariş onayı e-postası gönderiminde istisna oluştu: {e}")
        return False

# Örnek kullanım:
if __name__ == "__main__":
    sample_order = {
        "customer_email": "aysegul.yilmaz@example.com",
        "customer_name": "Ayşegül Yılmaz",
        "order_id": "TA-987654",
        "items": [
            {"name": "Dizüstü Bilgisayar", "quantity": 1, "price": 12500.00},
            {"name": "Kablosuz Mouse", "quantity": 1, "price": 250.00}
        ],
        "shipping_address": "Atatürk Cad. No:50, Ankara",
        "total_amount": 12750.00
    }

    # Bu fonksiyon, sipariş başarıyla veritabanına kaydedildikten sonra çağrılacaktır.
    if send_order_confirmation_email(sample_order):
        print("Sipariş onayı süreci tamamlandı.")
    else:
        print("Sipariş onayı e-postası gönderilemedi.")