SenderTR Dokümantasyon
Türkiye'nin inbox-odaklı, KVKK uyumlu e-posta pazarlama platformu. Bu rehber hem panelin nasıl kullanılacağını hem de REST API ile entegrasyonu adım adım anlatır.
Bu dokümantasyonda neler var?
Sistem Kullanımı
Her modülün ne işe yaradığı ve nasıl kullanılacağı
Geliştirici / API
REST API, webhook ve SMTP relay entegrasyonu
Deliverability
E-postalarınızın gelen kutusuna ulaşması
SSS
En sık sorulan sorular
Temel kavramlar
| Kavram | Açıklama |
|---|---|
| Kredi | Gönderilen her e-posta 1 kredi düşer. Krediler süresizdir. |
| Kampanya | Bir listeye/segmente tek seferlik toplu gönderim. |
| Otomasyon | Tetikleyiciye bağlı otomatik e-posta akışı (hoşgeldin, doğum günü vb.). |
| Transactional | Sipariş onayı, şifre sıfırlama gibi işlemsel e-postalar (API/SMTP ile). |
| Sending Domain | Adınıza e-posta gönderdiğimiz, DNS doğrulaması yapılmış alan adı. |
Hızlı Başlangıç
5 adımda ilk kampanyanızı gönderin.
- Hesap oluşturun. app.sendertr.com/register üzerinden kaydolun. Kayıtta 1.000 e-posta kredisi hediye gelir.
- Domain ekleyin & doğrulayın. Ayarlar → Domainler'den gönderim alan adınızı ekleyin ve verilen SPF/DKIM/DMARC kayıtlarını DNS'e işleyin. (Detay)
- Kişilerinizi yükleyin. Kişiler → İçe Aktar ile CSV/Excel dosyanızı yükleyin ya da tek tek ekleyin. (Detay)
- Kampanya oluşturun. Kampanyalar → Yeni Kampanya: gönderen domaini, konu ve içeriği belirleyin. (Detay)
- Onaya gönderin / gönderin. Sender Contract ön kontrolünden geçen kampanya zamanlanır veya hemen gönderilir.
Domain & DNS Doğrulama
E-postaları kendi alan adınızdan göndermek için domaini ekleyip DNS kayıtlarını doğrulamanız gerekir. Bu, hem teslim edilebilirlik hem de yasal gönderen kimliği için zorunludur.
Adımlar
- Ayarlar → Domainler → "Domain Ekle".
- Sistem size 3 DNS kaydı üretir:
SPF(TXT),DKIM(TXT, 2048-bit) veDMARC(TXT). - Bu kayıtları alan adınızın DNS yönetim panelinde oluşturun.
- "Doğrula" butonuna basın. Yayılma birkaç dakika–saat sürebilir.
Krediler & Faturalandırma
SenderTR kullandıkça-öde modeliyle çalışır: gönderilen her e-posta 1 kredi düşer ve krediler süresizdir (aylık abonelik zorunluluğu yoktur).
Kredi paketleri
| Paket | E-posta | Fiyat (+KDV) |
|---|---|---|
| Başlangıç | 10.000 | ₺250 |
| Standart | 50.000 | ₺1.100 |
| Profesyonel | 100.000 | ₺1.900 |
| İşletme | 250.000 | ₺4.250 |
| Kurumsal | 500.000 | ₺7.500 |
| Enterprise | 1.000.000+ | ₺12.500 / özel |
Krediler Krediler → Paket Satın Al menüsünden PayTR ile güvenli şekilde alınır. Bakiye %80, %95 ve %100 eşiklerinde uyarılır.
Kampanyalar
Bir liste veya segmente tek seferlik toplu e-posta gönderimi. Kampanyalar bir onay (Sender Contract) sürecinden geçer.
Kampanya oluşturma
- Kampanyalar → Yeni Kampanya.
- Gönderen domaini seçin (DNS doğrulanmış olmalı), gönderen adı/e-posta ve konu girin. E-postanın yerel kısmını yazmanız yeterli —
@alanadi.comotomatik eklenir. - İçeriği sürükle-bırak editör veya bir şablonla hazırlayın. Konu için AI Öner ile öneri alabilirsiniz (OpenAI yapılandırılmışsa).
- Alıcı liste/segment seçin.
- Taslak Olarak Kaydet veya Onaya Gönder.
Durumlar
draft → submitted → approved → scheduled/queued → sending → completed. Yan durumlar: rejected, paused, stopped.
Şablonlar
Tekrar kullanılabilir e-posta tasarımları. Sürükle-bırak editör (EmailBuilder.js) ile kod bilmeden tasarlayın.
- Şablonlar → Yeni Şablon ile görsel editörü açın.
- Bloklar (metin, görsel, buton, ayraç) sürükleyin;
{{first_name}}gibi merge tag'lerle kişiselleştirin. - Kampanya oluştururken şablonu seçin; "yeni şablon oluştur" linki yeni sekmede açılır, kampanya formunuz korunur.
Kişiler & Listeler
Aboneleriniz "kişi", grupları ise "liste" olarak yönetilir.
Kişi ekleme
- Tek tek: Kişiler → Yeni Kişi. E-posta zorunlu; ad, soyad, telefon, şehir ve liste seçimi opsiyonel.
- Toplu içe aktarma: Kişiler → İçe Aktar. CSV veya Excel (xlsx) yükleyin, kolonları eşleyin (e-posta eşlemesi zorunlu), hedef liste seçin. İçe aktarma arka planda işlenir; tamamlanınca bildirim alırsınız.
Listeye kişi ekleme
Bir listeye girip "Kişi Ekle" ile yeni kişi oluşturabilir veya mevcut kişileri "Kişi Aktar" ile listeye taşıyabilirsiniz.
Segmentler
Kurallara göre dinamik kişi grupları. Örn: "son 90 günde açan", "İstanbul'daki kişiler", "etkileşim puanı > 50".
Segment kuralları e-posta, şehir, ülke, durum, etkileşim puanı, son açılma/tıklama, doğrulama durumu gibi alanlar üzerinde tanımlanır ve kampanya hedeflemede kullanılır.
Otomasyonlar
Tetikleyiciye bağlı, otomatik çalışan e-posta akışları.
Otomasyon oluşturma
- Otomasyonlar → Yeni Otomasyon. Ad ve tetikleyici seçin.
- Tetikleyiciler: Kişi eklendi, etikete eklendi, tarih alanı (ör. doğum günü), form gönderildi, e-ticaret olayı (sipariş/sepet).
- Adımları tanımlayın:
e-posta,gecikme,koşul,aksiyon. - Gönderen domaini ve e-postayı belirleyin (yerel kısım + otomatik
@domain). - Otomasyonu etkinleştirin.
Hazır şablonlar
Hoşgeldin serisi, doğum günü, yeniden etkileşim, satın alma sonrası, etkinlik, lead besleme.
Formlar
Web sitenize gömülebilen abone kayıt formları. Ziyaretçiler form doldurarak listenize eklenir.
- Formlar → Yeni Form. Form adı verin.
- Alanları ekleyin (her alana ad ve etiket zorunlu). En az bir e-posta alanı olmalı.
- Kayıtların ekleneceği listeyi seçin.
- Oluşan gömme kodunu (embed) web sitenize yapıştırın.
Landing Page
Kampanyalarınız için açılış sayfaları oluşturun.
- Sayfalar → Yeni Sayfa. Başlık, slug ve içerik (HTML) girin.
- Sayfayı Onaya Gönder.
- İçerik moderasyon ekibimizce incelenir; onaylanınca
/p/{slug}adresinden yayınlanır.
E-posta Doğrulama
Listelerinizi temiz tutmak için e-posta adreslerini gönderim öncesi doğrulayın. MX kontrolü, SMTP el sıkışması, geçici (disposable) ve rol adresi tespiti yapılır.
- Tek adres: Doğrulama sayfasından bir e-posta sorgulayın.
- Toplu: Bir listeyi topluca doğrulayın.
- Sonuçlar:
valid,invalid,risky,disposable,role,unknown.
Tüm doğrulama lokal yapılır, dış servise veri gönderilmez (KVKK uyumlu).
Raporlar
Gönderim performansınızı detaylı izleyin.
- Kampanya raporları: Açılma, tıklama, bounce, şikayet, teslim oranları.
- Link tıklama (heatmap): Hangi linke kim tıkladı.
- Coğrafi & cihaz: Açılmaların ülke/şehir ve cihaz/e-posta istemcisi dağılımı.
- Deliverability & DMARC: SPF/DKIM hizalama ve itibar raporları.
Ekip & Roller
Ayarlar → Ekip'ten ekip üyesi davet edin. Davet edilen kişiye e-posta ile bağlantı gider; kabul edince hesabınıza katılır.
| Rol | Yetki |
|---|---|
| Owner | Tam yetki (hesap sahibi) |
| Admin | Tüm yönetim, faturalandırma dahil |
| Marketer | Kampanya, otomasyon, içerik |
| Uploader | Kişi & liste yönetimi |
| Viewer | Salt görüntüleme |
Deliverability — Gelen Kutusuna Ulaşmak
SenderTR'nin en güçlü yanı teslim edilebilirliktir. Başarılı gönderim için:
- SPF / DKIM / DMARC: Domain doğrulamada otomatik üretilir; üçü de geçerli olmalı.
- IP Warmup: Yeni gönderim IP'leri 30 günlük kademeli ısıtma planıyla itibar kazanır.
- Liste hijyeni: Doğrulanmamış/etkileşimsiz adresleri temizleyin; bounce > %5, şikayet > %0,3 itibarı düşürür.
- İçerik: Spam skoru analizi ile gönderim öncesi riskli içerikleri tespit edin.
- One-Click Unsubscribe (RFC 8058): Gmail/Yahoo gereksinimlerine tam uyum.
API Genel Bakış
SenderTR REST API ile transactional e-posta gönderebilir, adres doğrulayabilir ve pazarlama verilerinizi (kişi/liste/kampanya) programatik yönetebilirsiniz.
Temel URL: https://api.sendertr.com/v1
Tüm istekler JSON, kimlik doğrulama API anahtarı ile yapılır. Rate limit: transactional 300/dk, genel API 60/dk.
Kimlik Doğrulama
İstek başlığında API anahtarınızı gönderin:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Yetki kapsamları (scope)
Her anahtar yalnızca atanan yetkilerde işlem yapar: send, verify, contacts:read, contacts:write, lists:read, lists:write, segments:read, campaigns:read, campaigns:write. Yetki dışı istek 403 insufficient_scope döner.
Transactional E-posta Gönderimi
POST /v1/send — Sipariş onayı, şifre sıfırlama gibi işlemsel e-postalar.
POST https://api.sendertr.com/v1/send
Authorization: Bearer YOUR_API_KEY
{
"from": "siparis@sirketiniz.com",
"to": "musteri@example.com",
"subject": "Siparişiniz alındı",
"html": "<h1>Teşekkürler!</h1><p>Siparişiniz hazırlanıyor.</p>"
}
Gönderim durumu için: GET /v1/messages/{messageId} ve listelemek için GET /v1/messages.
Doğrulama API
POST /v1/verify — tek adres; POST /v1/verify/bulk — toplu.
POST https://api.sendertr.com/v1/verify
{ "email": "test@example.com" }
// Yanıt
{ "email":"test@example.com", "result":"valid", "score":95, "disposable":false, "role":false }
Marketing CRUD API
Kişi, liste, segment ve kampanyalarınızı programatik yönetin. (İlgili scope gerekir.)
| Method | Endpoint | Açıklama |
|---|---|---|
| GET | /v1/contacts | Kişileri listele (filtre: list_id, status, search) |
| GET | /v1/contacts/{id} | Tek kişi |
| POST | /v1/contacts | Kişi oluştur/güncelle (upsert) |
| PUT | /v1/contacts/{id} | Kişi güncelle |
| DEL | /v1/contacts/{id} | Kişi sil |
| GET | /v1/lists | Listeler |
| POST | /v1/lists | Liste oluştur |
| GET | /v1/segments | Segmentler |
| GET | /v1/campaigns | Kampanyalar + istatistik |
| POST | /v1/campaigns | Taslak kampanya oluştur |
404 döner.Webhook'lar
E-posta olaylarını kendi sisteminize anlık iletin. Ayarlar → Webhook'lar'dan endpoint ekleyin.
Event türleri
delivered, bounced, opened, clicked, unsubscribed, complained
İmza doğrulama (HMAC)
Her istek X-Webhook-Signature başlığında HMAC-SHA256 imzası taşır. Webhook oluştururken bir kez gösterilen secret ile gövdeyi doğrulayın:
signature = HMAC_SHA256(secret, request_body)
// X-Webhook-Signature başlığıyla eşleşmeli
SMTP Relay
API yerine SMTP tercih ediyorsanız, transactional e-postaları relay üzerinden gönderebilirsiniz.
| Ayar | Değer |
|---|---|
| Sunucu | smtp.sendertr.com |
| Port | 587 (STARTTLS) |
| Kullanıcı adı | SMTP kimlik bilgisi (panelden) |
| Şifre | SMTP kimlik bilgisi (panelden) |
SMTP kimlik bilgilerinizi Ayarlar → API / Entegrasyon'dan oluşturun.
Sıkça Sorulan Sorular
Krediler süreli mi?
Hayır, krediler süresizdir. Aylık abonelik zorunluluğu yoktur.
E-postalarım neden spam'e düşüyor?
Genelde eksik DNS doğrulaması (SPF/DKIM/DMARC) veya kötü liste hijyeni nedeniyle. Domain sağlık skorunuzu ve Deliverability bölümünü kontrol edin.
API anahtarımı nereden alırım?
Ayarlar → API / Entegrasyon. Her anahtara yetki kapsamı atayabilirsiniz.
Verilerim güvende mi?
Tüm sunucular Türkiye'de, %100 KVKK uyumlu. Veriler yurt dışına çıkmaz, doğrulama lokal yapılır.
Daha fazla yardım?
destek@sendertr.com veya panel içi destek.