Bu rehberde: E-posta dizilerinizi ve bültenlerinizi yazan ajanı tanırsınız: hangi amaçlar için kullanılır, ne üretir, hangi kurallara uyar ve E-posta gönder / Bülten gönder adımlarına nasıl bağlanır.
⏱ 9 dakika
Kimlik kartı
| Alan | Değer |
|---|---|
| Tür | EMAIL_WRITER |
| Kategori | İçerik |
| Kutu tipi | agent.emailWriter |
| Varsayılan model | claude-sonnet-5 (dengeli) |
| Ekonomik model | claude-haiku-4-5 |
| Araçlar | knowledge_search, fetch_url |
| Rapor türü | EMAIL_SEQUENCE (E-posta dizisi) |
| Önerilen hesaplar | SMTP / Gmail / Outlook / Resend (gönderim için), Brevo, Mailchimp (bülten için) |
Ne yapar?
Ajan, seçtiğiniz amaca göre 1–7 e-postalık bir dizi ya da tek sayılık bir bülten yazar. Yazmadan önce bilgi bankanızda ürünleri, fiyatları, kargo / iade / garanti koşullarını ve güncel teklifi arar; görevde bir ürün sayfası verirseniz onu okur. Projenin marka sesi, strateji belgesindeki konumlandırma, içerik sütunları ve kitle mesajları her çalıştırmaya otomatik eklenir. İş akışında önceki adımdan gelen müşteri, sepet veya ürün bilgisi de kullanılır.
Her amacın hazır bir yapısı ve gönderim günleri vardır:
| Amaç | Değer | E-posta | Yapı |
|---|---|---|---|
| Hoş geldin serisi | welcome | 3 (0, 2, 5. gün) | karşılama ve ilk adım → marka hikâyesi → nazik ilk sipariş daveti |
| Geri kazanma | win_back | 3 (0, 5, 12. gün) | yenilikler → temel değer → abonelik tercihi sorusu |
| Terk edilen sepet | abandoned_cart | 3 (0, 1, 3. gün) | indirimsiz hatırlatma → kargo / iade güvencesi → kısa son hatırlatma |
| Bülten | newsletter | 1 | ana konu + 2–3 kısa haber + tek çağrı |
| Ürün lansmanı | launch | 3 (0, 3, 6. gün) | duyuru → lansman günü → gerçek son tarih varsa son çağrı |
| Besleme / eğitim | nurture | 5 (0, 3, 7, 14, 21. gün) | her e-postada tek faydalı bilgi, sonuncusunda açık teklif |
Girdiler
| Alan | Etiket | Tür | Varsayılan | Açıklama |
|---|---|---|---|---|
goal | Goal | seçim (zorunlu) | welcome | Yukarıdaki tablodaki amaçlar. win-back gibi tireli yazımlar da kabul edilir |
audience | Audience / segment | uzun metin | – | Alıcılar, bir cümleyle. Boşsa projedeki hedef kitle |
steps | E-mails in the sequence | sayı (1–7) | amaca göre | Dizideki e-posta sayısı |
language | Language | metin | tr | Çıktı dili |
tone | Tone | seçim | warm | warm, professional, playful, direct |
offer | Offer | uzun metin | – | Gerçekten verdiğiniz indirim / kod / ücretsiz kargo / hediye. Boşsa hiçbir teşvik yazılmaz |
includeSubjectVariants | Subject-line variants | açık/kapalı | açık | Her e-postaya 2–3 alternatif konu satırı |
Ortak alanlar (görev, entegrasyonlar, model, düşünme derinliği, maks. adım, bütçe, rapor kaydet) için Ajanlara genel bakış.
Çıktılar
Sonuçta üç alan vardır: sequence (e-postalar), unsubscribeLine (ret satırı) ve complianceNotes (göndermeden önce bakılacaklar). İş akışında main çıkışından her e-posta ayrı bir öğe olarak çıkar; ilk öğe ayrıca unsubscribeLine alanını taşır.
{
"step": 1,
"sendAfterDays": 0,
"purpose": "Karşılama ve ilk adım",
"subject": "Kahve Dünyası'na hoş geldiniz",
"subjectVariants": ["İlk kahveniz için 3 öneri", "Taze kavrum her hafta kapınızda"],
"previewText": "En sevilen üç çekirdeğimizi sizin için seçtik",
"bodyText": "Merhaba,\n\nAramıza katıldığınız için teşekkürler...\n\nBu e-postaları almak istemiyorsanız ...",
"cta": { "label": "Kahveleri keşfedin", "url": "https://kahvedunyasi.example/kahveler" },
"text": "Merhaba,\n\n...",
"html": "<p style=\"...\">Merhaba,</p>..."
}
textvehtmlplatform tarafından eklenir:textret satırını içeren düz metindir;html, ajan HTML yazmadıysa düz metinden üretilen sade HTML'dir (paragraflar, tıklanabilir bağlantılar). Ajanın yazdığı HTML'den script, form, iframe vejavascript:bağlantıları temizlenir.- Bülten gönder kutusunun varsayılanları doğrudan çalışır: konu
{{ $json.subject }}, gövde{{ $json.text }}. Ön izleme için{{ $json.previewText }}yazın. - E-posta gönder kutusunda konu
{{ $json.subject }}, gövde{{ $json.html }}.
Kullandığı araçlar
knowledge_search: ürün, fiyat, kargo / iade koşulları ve teklif için bilgi bankası araması.fetch_url: görevde verilen ürün veya kampanya sayfasını okur.
Ajan e-posta göndermez; gönderimi iş akışındaki gönderim adımı yapar.
Uyum kuralları
- Ret satırı: Bu e-postalar ticari iletidir (6563 sayılı Kanun). Her e-posta abonelikten çıkma satırıyla biter; ajan yazmayı unutursa platform ekler. Bülten gönderiminde ayrıca tek tıkla abonelikten çıkma bağlantısı eklenir.
- Vermediğiniz indirim yok: Ajan yalnızca
offeralanındaki, bilgi bankasındaki veya önceki adımdan gelen teklifi kelimesi kelimesine kullanır. Teklif girilmemişken metinde indirim, kupon veya ücretsiz kargo ifadesi geçerse rapor bunu işaretler. - Eski fiyat (10 gün kuralı): Üstü çizili / önceki fiyat yalnızca girdilerde verilmişse ve indirimden önceki 10 gündeki en düşük fiyatsa yazılır; aksi hâlde yalnızca güncel fiyat veya indirim oranı verilir.
- Gerçek aciliyet: Son tarih veya stok sınırı ancak girdilerde varsa kullanılır; sahte geri sayım, "Re:" / "Fwd:" hileleri yoktur.
- Sağlık, finans ve hukuk iddiaları yalnızca bilgi bankasındaki gibi; alkol tanıtımı yapılmaz.
- Türkiye'deki alıcılara ticari e-posta için İYS onayı gerekir;
complianceNotesbunu hatırlatır. Göndermeden önce Mevzuat Uyum Denetçisi ile ayrıca denetleyebilirsiniz.
Örnek görev metinleri
- "Yeni bülten abonelerimiz için 3 e-postalık hoş geldin serisi yaz. İlk e-postada en çok satan 3 kahvemizi tanıt, indirim verme."
- "Sepetinde ürün bırakanlar için 3 e-posta yaz: önce nazik hatırlatma, sonra kargo ve iade koşulları, son e-postada HOSGELDIN10 kodu." (
offer: "İlk siparişe %10 indirim, kod HOSGELDIN10, 31 Ekim'e kadar") - "Ekim bültenini hazırla: ana konu yeni hasat Etiyopya çekirdeği, ayrıca bir demleme ipucu ve hafta sonu atölyemiz."
- "90 gündür sipariş vermeyen müşterilerimiz için geri kazanma serisi yaz; son e-postada bülteni almaya devam etmek isteyip istemediklerini sor."
İpuçları
İpucu: Teklifi tam yazın (oran, kod, son tarih) ya da boş bırakın. Ajan sizin vermediğiniz hiçbir indirimi vaat etmez.
- Bilgi bankanıza kargo, iade, ödeme ve garanti koşullarını ekleyin; terk edilen sepet ve lansman e-postaları en çok bunlara dayanır.
- Konu satırı alternatiflerini açık tutun ve bülten sağlayıcınızın A/B testinde deneyin.
- İlk haftalarda ajan ile gönderim adımı arasına bir Onay adımı koyun.
- Ad veya firma adı gibi kişiselleştirme etiketleri ancak görevde verirseniz kullanılır (sağlayıcıların etiketleri farklıdır); aksi hâlde selamlama adsız yazılır.
Beklenen rapor
E-posta dizisi raporu: dizinin tablosu (sıra, gün, konu, ön izleme, CTA), kontrol edilecekler (önerilenden uzun konu satırları, teklif girilmeden geçen indirim ifadeleri, uyum notları) ve her e-postanın tam metni. Metrik kartları: e-posta sayısı, gün aralığı, konu alternatifi sayısı, uyarı sayısı.
Maliyet beklentisi
3 e-postalık dizi, 1–3 bilgi bankası araması (~15K giriş / ~8K çıkış token):
| Katman | Model | Tahmini maliyet |
|---|---|---|
| Ekonomi | claude-haiku-4-5 | ≈ 0.06 $ |
| Dengeli (varsayılan) | claude-sonnet-5 | ≈ 0.11 $ |
| Amiral gemisi | claude-opus-5 | ≈ 0.28 $ |
Tek sayılık kısa bültenler için ekonomik model çoğu zaman yeterlidir. Varsayılan bütçe (2 $) geniştir; 0.5 $'a düşürebilirsiniz.
İş akışında kullanım
Hoş geldin serisi:
Form gönderimi → E-posta ve Bülten Yazarı (goal: welcome) → Onay
approved → Filtre ({{ $json.step === 1 }}) → E-posta gönder (to: {{ $node["Form gönderimi"].json.email }})
→ Bekle (2 gün) → Filtre ({{ $json.step === 2 }}) → E-posta gönder
→ Bekle (5 gün) → Filtre ({{ $json.step === 3 }}) → E-posta gönder
Her e-postanın sendAfterDays alanı, o dal için kaç günlük Bekle adımı kuracağınızı gösterir.
Aylık bülten:
Zamanlama (ayın ilk pazartesi) → E-posta ve Bülten Yazarı (goal: newsletter) → Bülten gönder (mode: approval)
- Filtre olmadan dizinin bütün e-postaları aynı anda gönderim adımına akar; her dala yalnızca kendi adımını geçirin.
- Terk edilen sepet için akışı mağaza entegrasyonunun olayıyla başlatın (ör. Shopify
checkout_abandoned); sepet bilgisiinput.itemsolarak ajana gelir. Hazır Shopify terk edilen sepet hatırlatmaları şablonu da bu kurguyu kullanır.
Sık karşılaşılan sorunlar
| Sorun | Neden | Çözüm |
|---|---|---|
| Bülten gövdesi boş | Gövde alanı değiştirilmiş | Bülten gönder'de gövdeyi {{ $json.text }} yapın |
| Her e-posta aynı anda gitti | Dizinin tüm öğeleri gönderime aktı | Bekle adımı ekleyin veya Filtre ile tek adımı seçin |
| İndirim yazılmadı | Teklif alanı boş | offer alanına teklifi tam yazın |
| Rapor indirim uyarısı veriyor | Teklif girilmeden metinde indirim ifadesi geçti | Metni düzenleyin veya teklifi girip yeniden çalıştırın |
Sık sorulan sorular
E-postaları kendisi gönderir mi? Hayır. Gönderim iş akışındaki E-posta gönder veya Bülten gönder adımıyla yapılır.
HTML tasarımı nasıl olur? Sade ve mobil uyumlu: paragraflar ve bağlantılar. Görsel ve buton bloklu bültenler için Bülten gönder kutusundaki blok düzenleyiciyi kullanın.
Hangi dillerde yazar?
Varsayılan Türkçe; language alanıyla İngilizce, Almanca ve diğer dillerde de yazar.