agentleFS
tomiya1324tomiya1324/tezgah/skills/saas-email/SKILL.md

saas-email

Skill2 starsChanged 8 months agoMITView on GitHub

SaaS uygulaması için transactional e-posta altyapısı kur. Resend veya Mailgun yapılandırması, DNS kayıtları (SPF, DKIM, DMARC), e-posta şablonları ve spam'dan kaçınma stratejisi. Bu skill'i kullanıcı e-posta gönderimi, DNS ayarları, spam sorunu, magic link, e-posta şablonu veya e-posta servisi ile ilgili bir şey istediğinde kullan. "E-postalar spam'a düşüyor", "DNS ayarla", "hoş geldin e-postası yap" gibi ifadeler tetikler.

1 other project uses a version of this.

Adopted by

Most recently taken up by

  • Other versions1 project uses a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 1

    1. TheWayWithin/agent-11★ 17same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repository12 other files it gives its agents.

The file

Files
SKILL.md

SaaS Email — E-posta Altyapısı

Bu skill, bir SaaS uygulamasının e-posta katmanını kurar. E-posta, kullanıcıyla iletişimin en kritik kanalıdır — magic link giriş, ödeme onayları, bildirimler ve destek hep e-postaya bağlıdır.

Bağımlılık: Bu skill saas-launcher orkestratör skill'inin Faz 5'idir. Bağımsız olarak da kullanılabilir.

Bağlı skill'ler:

  • saas-auth — Magic Link stratejisi bu skill'in altyapısına bağlıdır.
  • saas-payments — Ödeme bildirimleri (onay, hata, iptal) e-posta ile gönderilir.

Zamanlama notu: DNS kayıtlarının yayılması 24-48 saat sürebilir. E-posta altyapısını mümkün olduğunca erken — ideal olarak projenin ilk gününde — başlat. En azından DNS kayıtlarını ekle, servis tarafında doğrulamayı beklerken diğer fazlara devam et.


E-posta Servisi Seçimi

Resend — Varsayılan Önerimiz

Ne zaman seç: Çoğu SaaS projesi için. Modern API, React Email ile güzel şablonlar, Next.js ekosistemiyle doğal uyum.

Güçlü yönleri: API tasarımı basit ve modern, React Email ile tip güvenli şablonlar, webhook desteği, domain doğrulama dashboard'u anlaşılır, Next.js ve Vercel ile sorunsuz entegrasyon.

Zayıf yönleri: Ücretsiz katman günde 100 e-posta ile sınırlı (launch günü aşılabilir), inbound e-posta desteği sınırlı, görece yeni servis (Mailgun kadar olgun değil).

Fiyatlandırma: Ücretsiz katman (100/gün), ardından $20/ay (50K e-posta). Çoğu erken SaaS için yeterli.

Mailgun

Ne zaman seç: Yüksek hacimli gönderim, gelişmiş inbound e-posta routing, mevcut Mailgun altyapısı varsa.

Güçlü yönleri: Yüksek hacim desteği, güçlü inbound routing (gelen e-postaları webhook'la işle), olgun ekosistem, detaylı analitik.

Zayıf yönleri: API tasarımı eski, React Email desteği yok (HTML şablonları elle yazılmalı), kurulum daha karmaşık, EU ve US bölgeleri ayrı.


DNS Altyapısı — E-postanın Temeli

DNS kayıtları, e-postalarının spam yerine inbox'a düşmesini sağlayan teknik altyapıdır. Bu kayıtlar olmadan gönderilen e-postaların büyük çoğunluğu spam klasörüne gider veya hiç teslim edilmez.

Subdomain Stratejisi

Ana domain'den e-posta gönderme. noreply@uygulamam.com yerine noreply@mail.uygulamam.com kullan.

Neden: Transactional e-posta gönderimi ana domain'in itibarını riske atar. E-posta itibarı zedelenirse uygulamanın SEO'su ve diğer e-posta iletişimi de etkilenebilir. Subdomain izolasyon sağlar.

Üç Zorunlu DNS Kaydı

SPF (Sender Policy Framework)

SPF, "bu domain adına kimler e-posta gönderebilir?" sorusunun cevabıdır. Alıcı sunucu bu kaydı kontrol eder — listede olmayan sunucudan gelen e-postayı reddeder veya spam'a atar.

Kayıt türü: TXT İsim: mail (veya mail.uygulamam.com) Değer: Resend için v=spf1 include:_spf.resend.com ~all, Mailgun için v=spf1 include:mailgun.org ~all

~all (softfail) başlangıç için uygun. Sistem oturduğunda -all (hardfail) yapılabilir.

DKIM (DomainKeys Identified Mail)

DKIM, gönderilen her e-postaya dijital imza ekler. Alıcı sunucu bu imzayı DNS kaydıyla doğrular — imza eşleşmezse e-posta kurcalanmış demektir.

Kayıt detayları e-posta servisinin dashboard'undan alınır. Genellikle bir veya birden fazla CNAME veya TXT kaydıdır. Her servis farklı format kullanır — dashboard'daki talimatları aynen takip et.

DMARC (Domain-based Message Authentication, Reporting and Conformance)

DMARC, SPF ve DKIM sonuçlarına göre ne yapılacağını belirler ve raporlama sağlar.

Kayıt türü: TXT İsim: _dmarc.mail (veya _dmarc.mail.uygulamam.com) Başlangıç değeri: v=DMARC1; p=none; rua=mailto:dmarc@uygulamam.com

Aşamalı yaklaşım:

  1. p=none ile başla — sadece raporla, hiçbir şey engelleme. Raporları incele, meşru e-postaların doğru geçtiğinden emin ol.
  2. Birkaç hafta sorunsuz çalıştıktan sonra p=quarantine yap — şüpheli e-postaları spam'a at.
  3. Her şey stabil olduğunda p=reject yap — şüpheli e-postaları tamamen reddet.

DNS Kayıt Ekleme Süreci

  1. Domain sağlayıcının (Cloudflare, Namecheap, GoDaddy, Vercel Domains vb.) DNS yönetim paneline git
  2. E-posta servisinin dashboard'undan gerekli kayıtları al (SPF, DKIM, DMARC)
  3. Kayıtları DNS paneline ekle — kayıt türü, isim ve değer alanlarını aynen kopyala
  4. Kaydet ve yayılmayı bekle (15 dakika - 48 saat)
  5. E-posta servisinin dashboard'unda "Verify" butonuna tıklayarak doğrulamayı kontrol et

Cloudflare kullanıyorsan: DKIM için eklenen CNAME kayıtlarında "Proxy" (turuncu bulut) devre dışı olmalı — sadece "DNS only" (gri bulut). Proxy aktifken doğrulama başarısız olur.


E-posta Şablonları Stratejisi

Her SaaS'ta Olması Gereken E-postalar

Zorunlu (Day 1):

  1. Magic Link giriş e-postası — "Giriş bağlantınız" (eğer Magic Link kullanılıyorsa)
  2. Hoş geldin e-postası — Kayıt sonrası, ürünü nasıl kullanacağını kısaca anlat
  3. Ödeme onay e-postası — Başarılı ödeme sonrası

Önemli (İlk hafta): 4. Ödeme başarısız bildirimi — Kart reddedilince gönderilir, kart güncelleme linki içerir 5. Abonelik iptal onayı — İptal edildiğinde, erişimin ne zaman sona ereceğini belirt

Sonra eklenecek: 6. Deneme süresi bitiyor hatırlatması — 3 gün kala, 1 gün kala 7. Haftalık/aylık özet — Kullanıcı aktivitesi raporu 8. Yeniden etkileşim — 30 gün inaktif kullanıcılara

Şablon Tasarım İlkeleri

  • Basit tut. Sade, tek sütunlu layout. Fazla görsel, karmaşık tablo, süslü grafik değil. Gmail, Outlook ve Apple Mail hepsi farklı render eder — basitlik uyumluluk sağlar.
  • Tek bir CTA. Her e-postanın tek bir amacı ve tek bir aksiyon butonu olsun. "Giriş yap" veya "Kartını güncelle" veya "Dashboard'a git" — birden fazla buton kafa karıştırır.
  • Mobil uyumlu. E-postaların %60+'ı mobilde okunur. Butonlar yeterince büyük (en az 44px yükseklik), metin okunabilir (en az 14px), genişlik 600px'i geçmemeli.
  • Plain text alternatifi. Her HTML e-postanın düz metin (plain text) versiyonunu da gönder. Bazı e-posta istemcileri HTML render etmez, bazı kullanıcılar plain text tercih eder.
  • Gönderen adı kişisel. "noreply@mail.uygulamam.com" yerine "Fatih from Uygulamam fatih@mail.uygulamam.com" çok daha iyi açılma oranı verir.

React Email (Resend ile)

Resend kullanıyorsan React Email kütüphanesi tip güvenli, bileşen bazlı e-posta şablonları yazmanı sağlar. Avantajı: şablonlar React bileşeni olarak yazılır, development'ta tarayıcıda önizlenebilir, e-posta istemci uyumluluğu kütüphane tarafından yönetilir.

Development'ta email dev komutu ile http://localhost:3001'de tüm şablonları önizleyebilirsin.


Gelen E-posta İşleme (İleri Seviye)

Bazı SaaS'larda kullanıcılardan e-posta almak gerekebilir — destek talepleri, reply-to ile etkileşim, e-posta tabanlı iş akışları.

Yaklaşım

E-posta servisinin webhook'unu kullan — gelen e-posta geldiğinde senin API endpoint'ine POST gönderir. Endpoint'te gönderen, konu, gövde bilgilerini işle.

Kullanım alanları: Destek ticket sistemi, e-posta ile görev oluşturma, reply-based onay akışları.

Bu Day 1 özelliği değildir. İlk launch'ta gerek yoktur, sonradan eklenebilir.


E-posta Gönderim İzleme

Takip Edilmesi Gereken Metrikler

  • Delivery rate — Teslim edilen / gönderilen. %99 üstü hedef. Düşükse DNS sorunları olabilir.
  • Bounce rate — Geri dönen e-posta oranı. %2 üstüyse geçersiz e-posta adresleri temizlenmeli.
  • Spam complaint rate — Spam olarak işaretlenme oranı. %0.1 üstüyse acil müdahale gerekir.
  • Open rate — Transactional e-postalarda %60-80 normal. Düşükse konu satırları veya gönderen adı gözden geçirilmeli.

E-posta servisi dashboard'unda bu metrikleri düzenli kontrol et. Özellikle launch'ın ilk haftası kritiktir.


Gotchas

  • DNS yayılımı zamana bağlı. 24-48 saat sürebilir. İlk günden DNS kayıtlarını ekle, doğrulamayı beklerken diğer işlere devam et.
  • Cloudflare proxy DKIM'i bozar. DKIM CNAME kayıtlarında turuncu bulutu kapatıp gri bulut (DNS only) yap.
  • Spam testi yap. Launch'tan önce https://mail-tester.com adresine test e-postası gönder. 10 üzerinden 9+ skor hedef. Düşükse DNS kayıtlarını kontrol et.
  • Rate limit farkındalığı. Resend ücretsiz planda günde 100 e-posta. ProductHunt launch'ı veya viral büyüme günü bu limiti dakikalar içinde aşabilirsin. Önceden ücretli plana geç.
  • E-posta adresi doğrulama. Kayıt sırasında e-posta formatını kontrol et, ama gerçek doğrulama magic link veya onay e-postası ile yapılır. Geçersiz e-postalara sürekli gönderm bounce rate'i yükseltir.
  • Unsubscribe linki zorunlu. Pazarlama e-postalarında (haftalık özet, yeniden etkileşim) unsubscribe linki yasal zorunluluk (CAN-SPAM, GDPR). Transactional e-postalarda (ödeme onayı, magic link) gerekli değil.
  • Zaman dilimine duyarlı gönderim. Hatırlatma ve bildirim e-postalarını kullanıcının yerel saatine göre gönder. Gece 3'te ödeme hatırlatması rahatsız edici.
  • E-posta boyutu. Gmail 102 KB üstünü kırpar ("Bu mesaj kırpıldı" uyarısı gösterir). Şablonları küçük tut, gereksiz HTML'den kaçın.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.